Developer Suite
Register Sandbox
Register Sandbox
  1. Checkout Plugins
  • Overview
  • API Endpoints
  • Ecommerce Checkout
    • Purchase
      POST
    • Get a transaction details
      POST
    • Close transaction
      POST
    • Check transaction
      POST
    • Refund API
      POST
    • Get transaction list
      POST
    • Exchange rate
      POST
  • Checkout Plugins
    • Prestashop
    • Woocommerce
  • Credentials on File
    • Link Account
      POST
    • Link Card
      POST
    • Purchase using token
      POST
    • Remove account token
      POST
    • Remove card token
      POST
    • Get linked account details
      POST
  • ABA QR API
    • QR API
      POST
  • Payment Link
    • Create payment link
      POST
    • Get payment link details
      POST
  • Pre-auth
    • Complete pre-auth transactions
      POST
    • Complete pre-auh transaction with payout
      POST
    • Cancel pre-purchase transaction
      POST
  • Payout
    • Payout
    • Update a beneficiary status
    • Add a beneficiary to whitelist
  • KHQR Guideline
  • Resources
  1. Checkout Plugins

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#

Group 1171277558.png
ABA PayWay Credit/Debit Card checkout experience on Woocommerce
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.
Prerequisites
Before integrating PayWay into your PrestaShop store, ensure you have the following:
A PayWay Sandbox Account: Register here 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.
Log in to your PrestaShop Admin Panel > Modules.
Click on Upload a Module
image.png
Upload the ABA PayWay Prestashop plugin file to install the module.
image.png
Once the installation is complete, click on Configure.
image.png
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.
image.png
Configuration Option
image.png

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.
image.png

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.
image.png
image.png
Fill in all required customer details.
image.png
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
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.
image.png
Step 2: Test Transactions in Sandbox Mode
Credit/Debit Card
🔴 ABA KHQR
WeChat Pay
Alipay
Step 3: Confirm the following response status
Make sure the response status updates accordingly.
✅ Success Status
image.png
❌ Declined Status
image.png
Step 4: Verifying Transactions
On PayWay Sandbox Portal
You can track the transaction details inside the PayWay Sandbox Portal > Transactions Page – Sign In here.
image.png
image.png
On PrestaShop
Go to Prestashop > Orders to see order and payment transactions details.
image.png

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.
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.
image.png
Set the Sandbox Mode to “No”, and click Save Changes.
image.png
Click Save to activate your live payments environment.
image.png
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.
💡
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.
Previous
Checkout Plugins
Next
Woocommerce