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:International: Visa, Mastercard, UnionPay, JCB, Alipay, WeChat Pay
2. How it works#
ABA PayWay Credit/Debit Card checkout experience on Woocommerce
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.Before integrating PayWay with your WooCommerce store, ensure you have:A PayWay Sandbox Account: Register here 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.
Log in to your WordPress admin panel.
Navigate to the Plugins section and click Add New Plugin.
Click Install Now on the 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.
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 SetupTo 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)
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.
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 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 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!
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.
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.
