9Pay Integration

Introduction

9Pay is one of Vietnam's leading Payment Gateway providers. It has a comprehensive payment solution with all payment methods: Visa credit card, global MasterCard, ATM cards of 40+ largest banks in Vietnam. 9Pay e-wallet.

---

Supported Countries

• Vietnam 🇻🇳

---

Available Payment Methods

9Pay PG only supports VND(₫) currency.

Payment Type	Payment Method Key	Status
Local ATM Card	NINEPAY_ATM_CARD	✅
Credit Card	NINEPAY_CREDIT_CARD	✅
9Pay Wallet	NINEPAY_WALLET	✅
All methods	NINEPAY_ALL	✅

Refund Details

Payment Method	ATM Cards	Credit Cards	9Pay Wallet	All method
Full refund?	✓	✓	✓	✓
Partial Refund Allowed?	✓	✓	✓	✓
Multiple Refunds Allowed?	✓	✓	✓	✓
Refund Transfer Period	Depend on Issuing bank (30-40days)	180 days	180 days	Depends on payment method

---

Miscellaneous Details

• Refunds can be initialized from the merchant portal, refund status can be checked at both merchant portal and 9Pay Dashboard

---

Sandbox

Credentials

Key	Value
Merchant Key	WYpuJ1
Secret Key	5MDbyAgtqCUs7MKWXs5uYeCrcdvFBNcdMDp
secretKeyCheckSum	X13MvDJY5OLz0tjLyfgrCdE8nUxokSCa

Test Cards data

Type	Card number	Name	Valid through	CVV	Status
Credit Card	9704000000000018	Nguyen Van A	03/27	NA
Credit Card	4005555555000009	Nguyen Van A	05/25	123

Bank	Type	Card number	Name	Valid through	Phone Number	otp
Vietcombank	ATM Card	9704000000000018	Nguyen Van A	03/07	NA	otp
MBBank	ATM Card	9704222091320309	AUTOAUTJHWNMQ	05/21	0973214568	04111994

• OTP - 123456
• Password - 1234

Download links

Download Sandbox App for making test payments:

• Android app - staging

  • Phone Number: 0945 666 000
  • Password: 123123
  • Otp: 123456

• Android app - play store

  • Phone number: 0389966858
  • Password: 123123
  • Otp: 123456

Use following values in embedded JS code to pay via 9Pay channel

"pmt_channel": "NINEPAY",

"pmt_method": { Any of above given payment method keys },

---

Reference links

• 9Pay integration