EPS: cards and mobile wallets
Connect EPS (Easy Payment System). The six fields, registering your store address and the notification address, testing and common errors.
EPS asks for more values than the other gateways, but each one is on your EPS merchant portal. Collect them first, then fill the form in one go.
What it is#
EPS (Easy Payment System) is a gateway for cards and mobile wallets. At checkout the buyer goes to the EPS page, pays and returns to your store. It suits shops that already have an EPS merchant account.
What you need#
- An EPS merchant account. You get access to the EPS merchant portal (merchant.eps.com.bd) or the details from EPS support.
- Fields in Jukto:
| Field in Jukto | What it is |
|---|---|
| Merchant ID | The merchant GUID, a long code |
| Store ID | The store GUID, a long code |
| Username (portal e-mail) | The e-mail you sign in to the portal with |
| Password | Your portal password (a secret) |
| Hash key | A key EPS uses to sign requests (a secret) |
| Secret key (for the IPN) | Optional. Only used to read EPS server notifications (a secret) |
Where to find your keys#
- 1
Sign in to the EPS merchant portal
The Username is the e-mail you use to sign in, and the Password is your portal password.
- 2
Find the long codes and the Hash key
Find your Merchant ID and Store ID (both are long codes called GUIDs) and your Hash key in the portal. If you cannot see them, ask EPS support (integration@eps.com.bd).
- 3
Copy each value into the field with the same name
Merchant ID, Store ID, Username (portal e-mail), Password and Hash key.
- 4
Add the Secret key only if EPS gave you one
The Secret key is optional. Add it only if EPS gave you one for server notifications; payments work without it.
- 5
Match the mode
Choose Sandbox (testing) or Live. Real sandbox values come from the EPS portal or from EPS support.
What Jukto does#
- Keys. Saved encrypted for this website only. Password, Hash key and Secret key are never shown again.
- Payment. Jukto signs the request with the Hash key, gets a token from EPS and opens the payment. The buyer goes to the EPS page and returns to your store with a success, fail or cancel result.
- Your store address. EPS checks which domain a request comes from. Register your store address, shown on the provider page under Addresses to register at the provider, as the merchant domain in the EPS portal.
- Notification (IPN). Paste the Notification (IPN) address from the provider page as the IPN URL in the EPS portal, and put the portal Secret key into Jukto so it can read the notices.
- Verification. Jukto always asks EPS for the transaction status and compares the transaction and the amount before it marks an order paid.
- Order. On success the payment shows Paid. A failed or cancelled payment leaves the order unpaid.
- Refunds. EPS has no refund call for merchants. Refund in the EPS portal and record the return on the order.
Text version of the diagram
- Jukto signs in and opens payment to Buyer pays on EPS
- Buyer pays on EPS to Buyer returns
- Buyer returns to Jukto asks EPS for the status
- EPS notice (IPN), optional to Jukto asks EPS for the status
- Jukto asks EPS for the status to Success and amount match?
- Success and amount match? to Order marked paid (Yes)
- Success and amount match? to Not paid: stays unpaid (No)
Test and turn on#
- 1
Open the provider
Go to Dashboard > Tools > Integrations, open the Payments group and choose EPS.
- 2
Choose the mode and fill the fields
Pick Sandbox (testing) or Live, fill the fields and press Save.
- 3
Register the addresses in the EPS portal
Register your store address as the merchant domain, and paste the notification address as the IPN URL.
- 4
Press Test connection
Jukto asks EPS for a token with your Username, Password and Hash key. You see "EPS sandbox granted a token" (or "live") when they are right.
- 5
Press Turn on
Switch to Live with your live values, turn it on and place one small real order. Check the Payments list.
Common errors#
| What you see | What it means | What to do |
|---|---|---|
| Fill in: Merchant ID, Store ID, Username, Password, Hash key | A required field is empty | Fill all five and save |
| EPS refused the credentials (check the user name, password and hash key) | One of the three is wrong, or the mode does not match | Re-copy them and check Sandbox or Live |
| EPS refused the credentials (EPS's own message) | EPS gave a reason | Read the reason; fix that value |
| EPS refused the payment | EPS did not accept the new payment | Read the message that follows; check the registered domain |
| EPS did not answer the status check | Verification could not reach EPS | Press Check again later |
| transaction id does not match | The answer was for another transaction | The order stays unpaid; check the EPS portal |
| Too many tests in a row. Wait a minute and try again. | You pressed the button too often | Wait a minute |
Comments (0)
Anyone can comment. Please do not post phone numbers, passwords or customer details.