9Pay
Learn about 9Pay, a digital wallet popular with customers from Vietnam.
Features
| Processing currencies | VND |
|---|---|
| Settlement currencies | USD |
| Minimum transaction amount | Local debit card minimum: 10,000 VND International card minimum: 10,000 VND 9Pay E- wallet minimum: 5,000 VND Bank transfer minimum: 10,000 VND |
| Maximum transaction amount | Local debit card maximum: 200,000,000 VND International card maximum : 200,000,000 VND 9Pay E- wallet maximum: 100,000,000 VND Bank transfer maximum: no limit |
| Refunds | ✅ |
| Partial Refunds | ✅ |
| Multiple partial refund | ✅ |
| Chargeback | ✅ |
Subproducts
| Product | Description |
|---|---|
| 9Pay E- wallet | After selecting 9Pay as a payment method on merchant checkout, customers will be redirected to 9pay payment page. Then selecting 9Pay E-wallet, a QR code appears. The shopper then opens the 9Pay app on their mobile phone and scans the barcode displayed on the browser page to complete the payment. |
| Local debit card | After selecting 9Pay as a payment method on merchant checkout, customers will be redirected to 9pay payment page. Then selecting local debit card and local bank name, customers fill in the card information completing payment. |
| International card | After selecting 9Pay as a payment method on merchant checkout, customers will be redirected to 9pay payment page. Selecting international card as payment method. Filling in the card details, payment will be completed. |
| Bank transfer | After selecting 9Pay as a payment method on merchant checkout, customers will be redirected to 9pay payment page. Selecting Bank transfer, customers can complete the payment by bank transfer. |
Integration Method
9pay1.
2.
Direct API
Payment flow
1.
2.
3.
How to integration
{
"amount":10000,
"currency":"VND",
"confirm":true,
"payment_method_data" : {
"type":"9pay"
},
"return_url":"https://swooshtransfer.com/"
}{
"id": "pi_1668947502776188928",
"object": "payment_intent",
"created": 1686743067000,
"livemode": false,
"currency": "VND",
"amount": 10000,
"status": "requires_action",
"client_secret": "pi_1668947502776188928_secret_5eKUVX8MFLiS0nSMEG35YWDJ",
"next_action": {
"type": "9pay_handle_redirect",
"9pay_handle_redirect": {
"url": "https://sand-payment.9pay.vn/portal?baseEncode=eyJhbW91bnQiOiIxMDAwMCIsImN1cnJlbmN5IjoiVk5EIiwiZGVzY3JpcHRpb24iOiJkZXNjcmlwdGlvbiIsImludm9pY2Vfbm8iOiJjaF8xNjY4OTQ3NTAyOTAyMDE4MDQ4IiwibWVyY2hhbnRLZXkiOiJQVEpwOXUiLCJyZXR1cm5fdXJsIjoiaHR0cHM6Ly9hcGl0ZXN0Lndvb3NocGF5LmNvbS92MS9yZWNlaXZlcy9jMTEvcnVybCIsInRpbWUiOiIxNjg2NzQzMDY2In0=&signature=jhZPpXG1XQDVwnexSSnr0WQap2HpLx0NqeeY2NDj3kQ="
}
},
"payment_method_types": [
"9pay"
],
"confirmation_method": "automatic",
"return_url": "https://swooshtransfer.com/",
"payment_method": "pm_1668947502629388288",
"capture_method": "automatic"
}Checkout
Payment flow
1.
1.
1.
1.
Create a Session
{
"cancel_url": "https://swooshtransfer.com/",
"mode": "payment",
"success_url": "https://swooshtransfer.com/",
"payment_method_types": [
"9pay"
],
"line_items": [
{
"price_data": {
"currency": "VND",
"product": null,
"unit_amount": 10000,
"active": true,
"metadata": {
"key1": "value1",
"key2": "value2"
},
"nickname": "apple",
"product_data": {
"id": null,
"name": "apple",
"active": true,
"description": "very delicious",
"metadata": {
"key1": "value1",
"key2": "value2"
},
"url": "www.baidu.com"
},
"billing_scheme": "testscheme",
"lookup_key": "test_lookup_key"
},
"quantity": 1
}
]
}{
"id": "cs_1668947425479360512",
"object": "checkout.session",
"created": 1686743048000,
"livemode": false,
"currency": "VND",
"customer": "",
"mode": "payment",
"status": "open",
"url": "https://checkouttest.wooshpay.com/pay/cs_test_1668947425479360512?key=pk_test_NTE2Njg1MDgwNDUzOTY4MDc2ODAxOm9Oa3pjN043U2dYWE84VVhGZmF4cThvTTE2ODY2MzgyOTYzMjU",
"cancel_url": "https://swooshtransfer.com/",
"line_items": {
"object": "list",
"data": [
{
"id": "li_1668947425508720640",
"object": "item",
"currency": "VND",
"description": "apple",
"price": {
"id": "price_1668947425533886464",
"object": "price",
"created": 1686743048000,
"livemode": false,
"active": true,
"currency": "VND",
"metadata": {
"key1": "value1",
"key2": "value2"
},
"nickname": "apple",
"product": {
"id": "prod_1668947425546469376",
"object": "product",
"created": 1686743048000,
"livemode": false,
"active": true,
"description": "very delicious",
"metadata": {
"key1": "value1",
"key2": "value2"
},
"name": "apple",
"url": "www.baidu.com",
"updated": 1686743048000
},
"type": "one_time",
"unit_amount": 10000,
"billing_scheme": "per_unit",
"lookup_key": "test_lookup_key"
},
"quantity": 1,
"amount_subtotal": 10000,
"amount_total": 10000
}
]
},
"payment_intent": "pi_1668947425710047232",
"payment_method_types": [
"9pay"
],
"payment_status": "unpaid",
"success_url": "https://swooshtransfer.com/",
"amount_subtotal": 10000,
"amount_total": 10000,
"billing_address_collection": "auto",
"expires_at": 1686829448437,
"payment_link": "",
"client_secret": "pi_1668947425710047232_secret_beZrT7mccYT27tC9ju0RbvlJ"
}