#
## 1. Introduction
The ABA PayWay PrestaShop Plugin lets you easily integrate ABA PayWay into your PrestaShop 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. The customer adds products to their cart and **proceeds to checkout**.
2. The customer selects **ABA KHQR** as their payment method.
3. The customer **scans the QR code with their ABA Mobile app** or any KHQR-supported app to complete payment.
4. Upon successful payment, a **success page** will be shown on the screen.
## 3. Integration Steps
### 3.1 Integration Steps
Follow the steps below to integrate the ABA PayWay Payment Gateway with your Prestashop store.
:::info[]
**Prerequisites**
Before integrating PayWay into your PrestaShop store, ensure you have the following:
- A **PayWay Sandbox Account**: **[Register here](https://sandbox.payway.com.kh/login/)** to receive your testing Merchant ID and API Key via email.
- A **Prestashop store**, both within the *latest 3 versions*, set up with products/services ready to sell.
:::
**Step 1: Download and Install the Plugin**
- Download the PayWay Prestashop Plugin Package **[here](https://www.payway.com.kh/prestashop-v1.7.zip)**.
- Log in to your PrestaShop Admin Panel > Modules.
- Click on Upload a Module
- **Upload** the **ABA PayWay Prestashop plugin** file to install the module.
- Once the installation is complete, click on **Configure**.
**Step 2: Configure the ABA PayWay Plugin**
In the configuration settings:
- Set **Sandbox Mode** to **Yes** for testing.
- In the **Merchant ID and API Key section**, input your sandbox credentials, which you can find in the email registered for your PayWay Sandbox account.
**Configuration Option**
---
**Sandbox Mode** `mandatory`
Enable this option to connect your integration to the PayWay sandbox account for testing. If unchecked, it will connect to the PayWay production environment.
---
**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.
---
**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).
---
**Hide/Show Close Button** `mandatory`
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.
---
**Logo Size**
Adjust the size of your logo displayed during the checkout process to ensure it fits well without compromising visibility.
---
**Background Color**
Set the background color of the checkout interface to align with your website's theme and branding.
---
**Include jQuery**
To enhance functionality on your site, you may include jQuery here. Ensure compatibility with existing scripts.
---
- Click **Save** to apply your settings.
### 3.2 Testing
**Step 1: Test & Verify the Setup**
To confirm successful setup, preview your Prestashop store and test the transaction flow to ensure everything works as expected.
**Success Connection Checklist:**
- Go to your PrestaShop store, **add a product to the cart**, then select **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
:::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**
- Select the **credit/debit card** option.
- Agree to the terms of service, and click "**Place Order**"
| 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** |
Visa Card |
4156 8399 3770 6777 |
01/30 |
993 |
No |
| Master Card |
5156 8302 7256 1029 |
04/30 |
777 |
Yes |
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 PrestaShop**
- Go to **Prestashop > Orders** to see order and 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.
- Set the Sandbox Mode to **“No”**, and click **Save Changes**.
- Click **Save** 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.
:::