Learn about 9Pay, a digital wallet popular with customers from Vietnam. #
With over millions of users, 9Pay is a leading digital wallet in Vietnam, catering to the diverse payment needs of individuals. It is an all-in-one app that offers a range of convenient features for everyday usage.
Caratteristiche #
| Elaborazione delle valute | VND |
|---|---|
| Valute di regolamento | USD |
| Importo minimo della transazione | Local debit card minimum: 10,000 VND International card minimum: 10,000 VND 9Pay E- wallet minimum: 5,000 VND Bonifico bancario minimum: 10,000 VND |
| Importo massimo della transazione | Local debit card maximum: 200,000,000 VND International card maximum : 200,000,000 VND 9Pay E- wallet maximum: 100,000,000 VND Bonifico bancario maximum: no limit |
| Rimborsi | ✅ |
| Rimborsi parziali | ✅ |
| Rimborso parziale multiplo | ✅ |
| Addebito | ✅ |
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. |
| Bonifico bancario | 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. |
Metodo di integrazione #
Valori dell'enumerazione del metodo di pagamento: 9pay
There are two integration methods for 9Pay
- API diretta
- Cassa
Diretto API #
Flusso di pagamento #
- For direct API integration, after creating payment intent by OpenAPI, customers will be redirected to 9Pay login page. Customers select the payment method
- For example, customers select 9Pay e-wallet. Then customers scans the QR code completing payment.
- After that, customers will be redirected to the page you designated.
Come integrare #
Per l'integrazione diretta con l'API, è possibile creare un PaymentIntent e ottenere l'url in un solo passaggio. Di seguito è riportata la demo della creazione di un intento di pagamento:
Creare un Intento di pagamento
A PaymentIntent is an object that represents your intent to collect payment from your customer and tracks the lifecycle of the payment process. Create a PaymentIntent on your server and specify the amount to collect and a supported currency. If you have an existing Payment Intents integration, add 9pay to the list of payment method types.
Richiesta
{
"amount":10000,
"currency":"VND",
"confirm":true,
"payment_method_data" : {
"type":"9pay"
},
"return_url":"https://swooshtransfer.com/"
}Risposta
{
"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"
}Cassa #
Flusso di pagamento #
- Customer selects 9Pay from the list of payment methods available and clicks on the Pay botton
- Customers will be redirected to 9Pay login page
- For example, customers select 9Pay e-wallet. Then customers scans the QR code completing payment.
- After that, customers will be redirected to the page you designated.
Creare una sessione #
Richiesta
{
"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
}
]
}Risposta
{
"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"
}Passo successivo #
È possibile aggiungere altre funzionalità all'integrazione in base alle esigenze.
Creare un webhook #
Ascoltate gli eventi sul vostro account WooshPay in modo che la vostra integrazione possa attivare automaticamente le reazioni. Creare un webhook che si concentri principalmente su enabled_events e url.
Creare un rimborso #
Creare un rimborso per restituire i fondi al cliente. È possibile eseguire anche rimborsi parziali, ma non tutti i metodi di pagamento li supportano. Un rimborso parziale consiste nel rimborsare solo una parte dell'importo della transazione originale.
