#
## 1. Introduction
The ABA PayWay WooCommerce Plugin lets you easily integrate ABA PayWay into your WordPress store.
Provide a smooth checkout experience while offering multiple popular payment methods, including:
- Local: **ABA PAY, KHQR**
- International: **Visa, Mastercard, UnionPay, JCB, Alipay, WeChat Pay**
## 2. How it works
1. Customers browse your WooCommerce store and add products to their cart.
2. At **checkout**, they select a payment method.
3. A secure payment popup appears for them to complete the payment.
4. After payment, they are redirected to the confirmation page, and the order status updates automatically.
## 3. Integration Steps
### 3.1 Integration Steps
Follow the steps below to integrate the ABA PayWay Payment Gateway into your WordPress store.
:::info[]
**Prerequisites**
Before integrating PayWay with your WooCommerce store, ensure you have:
- A **PayWay Sandbox Account**: **[Register here](https://sandbox.payway.com.kh/login/)** to receive your testing Merchant ID and API Key via email.
- A **WordPress site and WooCommerce store**, both within the *latest 3 versions*, set up with products/services ready to sell.
:::
**Step 1: Find and Install the Plugin**
- Log in to your **WordPress admin panel**.
- Navigate to the **Plugins** section and click **Add New Plugin**.
- Search for "**ABA PayWay**".
- Click **Install Now** on the plugin.
- Then, click **Activate**.
**Step 2: Configure the ABA PayWay Plugin**
- Upon activation, you will be redirected to the Installed Plugin Page.
- Click on **Settings**, which will redirect you to **Woocommerce Payment Settings**.
- Then click **Manage** to access the gateway configuration page.
- In the configuration settings, locate the **Merchant ID & API Key** field and fill in your sandbox credentials:
***These credentials should be in the **email** you’ve registered for a PayWay Sandbox account.*
- Ensure you've checked the **Sandbox Mode** to enable testing.
---
**Merchant ID** `mandatory`
Enter your unique PayWay merchant ID in this field. You can find it in the email registered for your PayWay Sandbox account. When you're ready to go live, replace it with your production merchant ID.
---
**API Key** `mandatory`
Enter your unique PayWay API Key in this field. You can find it in the email registered for your PayWay Sandbox account. When you're ready to go live, replace it with your production API Key.
---
**Sandbox Mode**
Enable this option to connect your integration to the PayWay sandbox account for testing. If unchecked, it will connect to the PayWay production environment.
---
**Payment Methods** `mandatory`
Choose the payment methods you want to offer customers at checkout. Test any of these methods in the sandbox environment. To go live, you may enable only those agreed upon with the Payway sales team.
To select multiple options, hold **Command (⌘)** on Mac or **Ctrl** on Windows, then click the payment methods you want to accept (e.g., Credit/Debit Cards, ABA KHQR).
---
**Payment Method Icon Color**
Some websites might have background colors that make the payment method icon hard to see. To fix this, our plugin provides two icon options: **Color Background** and **White Background**.
---
**Hide/Unhide Close Button**
In the modal popup checkout, you can decide to show or hide the close button. Displaying it lets customers cancel their payment during the payment step.
---
**Success URL for Web Continuation**
This is the URL where you want to redirect customers after payment completion.
---
**Success URL for Mobile Continuation**
This is the URL where you want to redirect customers after payment completion.
---
**Pushback URL**
PayWay will send the URL after payment completion. If the default pushback URL doesn't work, use this URL instead: https://pw-wordpress.ababank.com/?aba_payway_pushback=1.
---
**Mini App Integration JS**
To use your website as a mini app on ABA Mobile, you need to add a JavaScript script here. This script will be provided after you complete the onboarding process for the mini app.
---
**Custom CSS**
Your website may use themes or plugins with conflicting CSS. Add your custom CSS here to override these styles and ensure proper display.
---
### 3.2 Testing
**Step 1: Test & Verify the Setup**
To confirm a successful setup, preview your website and test the transaction flow to ensure everything works as expected.
**Success Connection Checklist:**
- Go to your **web store**, add a product to the cart, and **proceed to checkout**.
- Fill in all required customer details.
- Check if the selected payment method appears on the checkout page, showing options such as:
- Credit/Debit Cards (VISA, Mastercard, UnionPay, JCB)
- ABA KHQR
- Alipay
- WeChat Pay
:::tip[]
**All payment methods are available for testing in sandbox mode.** For live payments, only the options you’ve agreed upon with our sales team will be available.
:::
**Step 2: Test Transactions in Sandbox Mode**
Use the test cards below to simulate the payment, then select "**Pay ...USD**".
| Card Status |
Card Type |
Card Number |
Exp |
CVV |
3DS Enrolled |
| **Success** |
Master Card |
5156 8399 3770 6777 |
01/30 |
993 |
No |
| Visa Card |
4286 0900 0000 0206 |
04/30 |
777 |
Yes |
| **Declined** |
Master Card |
5156 8302 7256 1029 |
04/30 |
777 |
Yes |
| Visa Card |
4156 8399 3770 6777 |
01/30 |
993 |
No |
Select the ABA KHQR payment method to generate a test QR code.
**For visual reference only
Select the WeChat payment method to generate a test QR code.
**For visual reference only
Select the Alipay payment method to generate a test QR code.
**For visual reference only
**Step 3: Confirm the following response status**
Make sure the response status updates accordingly.
- **✅ Success Status**
- **❌ Declined Status**
**Step 4: Verifying Transactions**
**On PayWay Sandbox Portal **
- You can track the transaction details inside the **PayWay Sandbox Portal > Transactions Page** – **[Sign In here](https://sandbox.payway.com.kh/login)**.
**On WordPress **
- Go to **Woocommerce > Orders** to see payment transactions details.
## 4. Going Live
**Great job!** You’ve completed the sandbox testing, and your website is ready to go live.
**Let's make it official!** Follow these simple steps to go live and start accepting real payments effortlessly:
**Step 1: Reach out to ABA Bank to activate your account for real payments**
To start accepting real payments, you’ll need an ABA Merchant Account set up for live transactions.
:::tip[]
If you don't have an ABA Merchant Account yet, please contact our E-Merchant Acquisition team at **paywaysales@ababank.com** to get started today!
:::
**Step 2: Switch to Live Mode**
After finalizing your agreement with our team, you’ll receive your credentials for the live payment environment.
- Replace your Sandbox (testing) Merchant ID and API Key with the Live Merchant ID and API Key provided.
- Uncheck the Sandbox Mode.
- Click **Save Changes** to activate your live payments environment.
**Step 3: Do a Quick Test**
Make a small live payment on your store to ensure the transaction is settled to your account.
**Step 4: Success!**
You did it! Your website is officially live and ready to accept real payments with ABA PayWay.
:::highlight yellow 💡
**Note**
- Refunds issued on the **ABA Merchant Portal (Production Env)** will not be reflected in the WooCommerce store transaction records.
- For troubleshooting or if you have any questions or concerns, please contact digitalsupport@ababank.com.
:::