#
## 1. Introduction
The ABA PayWay Shopify Payment App simplifies payment acceptance, offering a quick, secure checkout experience for both local Cambodian and international customers.
With ABA PayWay, you can offer multiple payment options, including:
- Local: **ABA PAY, KHQR**
- International: **Visa, Mastercard, UnionPay, JCB, WeChat Pay**
## 2. How it works
1. The customer visits your Shopify store and adds products to their cart.
2. At checkout, they fill in shipping and billing details as per usual.
3. On the payment page, the customer chooses **ABA PayWay** as their payment method and selects **"Pay Now"**.
4. They are redirected to **ABA PayWay’s secure payment page** to complete the transaction.
5. After payment, the customer returns to your Shopify store’s order confirmation page.
6. The customer and store admin receive order confirmation notifications.
## 3. Integration Steps
### 3.1 Installation and Setup
:::caution[]
**Prerequisites**
Before you start, make sure you have the following:
- You own **Shopify store**, already set up with products ready to be sold. (Register or log in https://www.shopify.com/)
- An active **ABA Merchant Portal Account** (username and password)
**Note:** Shopify allows testing transactions directly in your live store environment via Test Mode — **no Sandbox account or API keys required**. Your username and password are all you need to complete the integration.
If you don't have an ABA Merchant Portal Account yet, please contact our Merchant Acquisition team at paywaysales@ababank.com to get started today!
:::
### How to Install and set up the ABA PayWay Plugin
Follow the steps below to integrate the ABA PayWay Payment Gateway with your Shopify store.
**Step 1: Install the Payment App**
- Open the Shopify App Store and search for “ABA PayWay”. Alternatively, press this link to begin [ABA PayWay on Shopify App Store](https://apps.shopify.com/aba-payway).
- Click **Install**.
**Step 2: Connect your ABA Merchant Credentials with your Shopify Store**
- Input your **admin credentials**, including username and password, to authorise the connection.
- Then, click **Sign In**
**Step 3 (if applicable): Select a Business Profile**
- If you have one business profile, skip this step and continue to Step 4.
- If you have multiple business profiles or outlets, choose the outlet you want to connect with your Shopify store. And then click Next.
:::info[]
Note: Connecting your Shopify store to the correct outlet in your ABA Merchant Account ensures all transactions settle into the right bank account and are properly tracked for reporting and reconciliation.
:::
**Step 4: Agree to Terms and Conditions**
- **Review and agree** to the ABA PayWay Shopify integration terms and conditions.
- Press **Confirm** to successfully connect your Merchant account with your Shopify store.
### 4. After Connecting with Shopify
**Step 1: Activate Payment Methods displays**
- After confirming the connection, you’ll be redirected back to the Shopify platform.
- In the ABA PayWay plugin settings, toggle on the payment methods you're offering in your store (as agreed with the Merchant Acquisition team).
- QR: ABA PAY, KHQR, WeChat Pay
- Cards: Visa, Mastercard, UnionPay, JCB
:::info[]
These enabled payment methods will appear on the shopify checkout screen for your customers.
:::
Then, click **Activate** to complete the setup.
**Step 2: Test & Verify the Setup**
Before going live, it's crucial to test the integration to ensure everything functions correctly.
- **Enable test mode** and click **Save**.
- Perform a Test Transaction by previewing your Shopify store, add an item to the cart and proceed to Checkout.
- Fill in test customer information as per usual and select **Continue to Payment**.
- On the Payment page, select **Pay with ABA PayWay** as the payment method, then select **Pay Now**.
- Verify that the enabled payment methods you've previously enabled in settings is accurately shown here.
- You will be redirected to the ABA PayWay Checkout screen to complete the payment.
**Step 3: Confirm the following response status**
You may test this payment using the **Credit/Debit Card** option.
- Select a test card provided to **simulate success or decline cases**.
- Select **Confirm** to submit the transactions.
- Confirm that the order status updates appropriately.
**✅ Success Payment**
**❌ Declined Status**
:::info[]
Note:
- The test transaction are **simulated**, and do not involve real money.
- The transaction record will appear as a **test order** your Shopify orders.
- The transaction record will not appear on the ABA Merchant Portal as it is not a real payment.
:::
## 5. Go Live
**Ready to go live?** Follow the steps below to start accepting real payments:
**Step 1: Turn off Test Mode**
- Once you're done testing, return to your **Shopify Settings > Payments > Payment Method**.
- Select **ABA PayWay**.
- Turn off the **Test Mode**, then click **Save**.
**Step 2: Do a Quick Test**
- Make a small live payment on your Shopify store to check that everything works smoothly, and verify the funds are settled to your **ABA Bank account**.
- **Check your Shopify orders in the admin panel** to confirm the payment status is set to **"Paid"** correctly.
:::info[]
**Settlement & Refunds**
- **ABA PAY & KHQR**: typically instant into your ABA account.
- **Cards & wallets**: timing may vary by processor and standard settlement schedule agreed with the ABA Merchant acquisition team.
- **To perform refunds for customers**, log in to the [ABA PayWay Merchant Portal](https://merchant.payway.com.kh/login/), find the transaction and process the refund directly. Remember, refunds won't sync automatically with Shopify, so you'll need to manually update the order status in your Shopify dashboard.
:::
**Success! Your Shopify store is now ready to accept real payments using ABA PayWay.**
## Need Support?
Get help with your ABA PayWay Shopify integration:
:::highlight yellow
**Chat with Navi**
Visit www.payway.com.kh and click **"Ask Navi"** to chat with our virtual assistant for instant answers.
**Email Our Team**
Contact digitalsupport@ababank.com if you need any technical support and integration assistance.
:::