ZaloPay Integration
Introduction#
ZaloPay provides diverse payment solutions including QR payments, Credit Card (Visa/Master), ATM Cards and Bank Transfer Payment options. Follow this guide to integrate ZaloPay acceptance on your mobile app or website.
Supported Countries#
- Vietnam 🇻🇳
Available Payment Methods#
Zalopay PG only supports VND(₫) currency.
| Payment Type | Payment Method Key | Status | Sandbox Availability |
|---|---|---|---|
| Local ATM Card | ZALOPAY_ATMCARD | ✅ | ✅ |
| Credit Card | ZALOPAY_CREDITCARD | ✅ | ✅ |
| Zalopay Wallet | ZALOPAY_WALLET | ✅ | ✅ |
| ZaloPay All | ZALOPAY_ALL | ✅ | ✅ |
note
In case of multiple offerings of same payment method, merchants can configure the payment method from the payment channel of his choice.
- e.g. To integrate
ZaloPay, merchant can choose theZALOPAY_WALLETpayment method by configuringZaloPayor viaBaokimorEPaypayment channels. - It will be merchants responsibility to configure appropriate Payment Channels and enable/disable required Payment Methods.
Miscellaneous Details#
- Refunds can be initialized from the merchant portal, refund status can be checked at both merchant portal and zalopay Dashboard
Sandbox#
Credentials#
| Key | Value |
|---|---|
| appId | 554 |
| key1 | 8NdU5pG5R2spGHGhyO99HN1OhD8IQJBn |
| key2 | uUfsWgfLkRLzq6W2uNXTCxrfxs51auny |
Test Credit cards data#
| Type | Card number | Name | Valid through | CVV | Status |
|---|---|---|---|---|---|
| Visa | 4111111111111111 | NGUYEN VAN A | 01/22 | 123 | Success |
Test ATM cards data#
| Type | Card number | Name | Valid through | CVV | Status | Reason |
|---|---|---|---|---|---|---|
| ATM Card | 9704540000000062 | NGUYEN VAN A | 10/18 | - | Success | - |
| ATM Card | 9704540000000013 | NGUYEN VAN A | 10/18 | - | Failed | Lost Card |
| ATM Card | 9704540000000039 | NGUYEN VAN A | 10/18 | - | Failed | Timeout |
| ATM Card | 9704540000000047 | NGUYEN VAN A | 10/18 | - | Failed | Out of Money |
Test Wallet Details#
Please use your Vietnam phone number. Add balance for sandbox environment using this link Deposit to ZaloPay Account
Test Merchant account credentials#
ZaloPay merchant console{:target="_blank"}.
| Key | value |
|---|---|
| Username | 0925226173 |
| Password | Z@lopay123 |
Download links#
Download ZaloPay Sandbox App for making test payments:
- Android app{:target="_blank"}.
- iOS app{:target="_blank"}
Error code details#
- ZaloPay error codes{:target="_blank"}.
Reference links#
- ZaloPay integration{:target="_blank"}.