Connect OnePay to accept cards

Enter your OnePay gateway details so customers can pay by card. After they click Đặt hàng, customers are sent to the OnePay page to enter their card. When OnePay confirms, the order changes to Paid automatically.

You need the Merchant ID, Access Code and Secure Secret that OnePay issued to your store.

Add OnePay

1. Go to Settings › Payment methods.
2. Click Add method at the bottom of the list.
3. On the OnePay row, click Add.
4. Edit the Display name if you want, for example Domestic ATM card. Customers see this name when they choose how to pay.
5. Enter a Description if you want one. The description appears when the customer selects OnePay.

On a phone, click the menu icon at the top left, select Settings, then click the list icon next to Settings to choose Payment methods.

Enter your OnePay details

Staying on the same page, scroll down to the Gateway credentials card. The card says Not configured.

1. Enter the Merchant ID.
2. Enter the Access Code.
3. Enter the Secure Secret.
4. Leave Base URL (optional) empty unless OnePay gave you a separate gateway address. If you leave it empty, EcomWeb uses the address for the mode you choose.
5. Keep Sandbox selected under Mode. It is selected by default.
6. Click Configure.

The card changes to Configured, along with the mode you chose.

Turn on OnePay and save

A new payment gateway method is always turned off. The switch can only be turned on after you have clicked Configure.

1. On the Status card, turn on Activate.
2. Click Save on the save bar at the bottom of the page.

The method you just added may sit at the top of the list, and customers will see it selected by default. To move it, see Reorder payment methods.

Try a payment

1. Place a test order and choose OnePay under Payment method. To place one, see Place a test order.
2. Click Đặt hàng, the button that places the order.
3. Enter a test card on the OnePay page that opens.
4. Wait for the store to report a successful payment.
5. In the dashboard, open the order under Orders.
6. Check that the Payment card says Paid and shows a Transaction ID.

Switch to live mode

When you save again, all the old details are replaced, so you must enter every field again.

1. Go to Settings › Payment methods.
2. Click the name of the OnePay method.
3. On the Gateway credentials card, click Replace.
4. Enter the Merchant ID of your real account.
5. Enter the Access Code of your real account.
6. Enter the Secure Secret of your real account.
7. Enter the Base URL (optional) if OnePay gave you a live gateway address.
8. Under Mode, choose Live.
9. Click Configure.
10. Place a small order with real money, then check that the order’s Payment card says Paid before you open for sales.

In the list of methods, the OnePay row shows a red Live tag. From now on, customers pay real money.

Stop accepting OnePay

1. Go to Settings › Payment methods.
2. Click the Activate switch on the OnePay row to turn it off.

Customers no longer see OnePay at checkout. The credentials are kept, so you can turn it back on at any time.

Frequently asked questions