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:International: Visa, Mastercard, UnionPay, JCB, Alipay, WeChat Pay
2. How it works#
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.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 PluginDownload the PayWay Prestashop Plugin Package here. Log in to your PrestaShop Admin Panel > Modules.
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 PluginIn 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.
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 SetupTo 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)
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 ModeStep 3: Confirm the following response status
Make sure the response status updates accordingly.Step 4: Verifying TransactionsYou can track the transaction details inside the PayWay Sandbox Portal > Transactions Page – Sign In here. 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 paymentsTo 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.
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.💡
Refunds issued on the ABA Merchant Portal (Production Env) will not be reflected in the WooCommerce store transaction records.