Scoprite 9Pay, un portafoglio digitale molto apprezzato dai clienti vietnamiti. #

Con oltre milioni di utenti, 9Pay è uno dei principali portafogli digitali in Vietnam, in grado di soddisfare le diverse esigenze di pagamento delle persone. È un'applicazione all-in-one che offre una serie di comode funzioni per l'uso quotidiano.

Caratteristiche #

Sottoprodotti #

Metodo di integrazione #

Valori dell'enumerazione del metodo di pagamento: 9pay

Esistono due metodi di integrazione per 9Pay

1. API diretta
2. Cassa

Diretto API #

Flusso di pagamento #

1. Per l'integrazione API diretta, dopo aver creato l'intento di pagamento tramite OpenAPI, i clienti saranno reindirizzati alla pagina di login di 9Pay. I clienti selezionano il metodo di pagamento

2. Ad esempio, i clienti selezionano il portafoglio elettronico 9Pay. Poi i clienti scansionano il codice QR per completare il pagamento.

3. Dopodiché, i clienti saranno reindirizzati alla pagina designata.

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

Un PaymentIntent è un oggetto che rappresenta l'intenzione di riscuotere un pagamento dal cliente e tiene traccia del ciclo di vita del processo di pagamento. Create un PaymentIntent sul vostro server e specificate l'importo da riscuotere e una valuta supportata. Se si dispone di un'integrazione Payment Intents esistente, aggiungere 9pay all'elenco dei tipi di metodo di pagamento.

Richiesta

{
    "importo":10000,
    "valuta": "VND",
    "conferma":vero,
    "dati_metodo_di_pagamento" : {
        "type": "9pay"
    },
    "return_url": "https://swooshtransfer.com/"
}

Risposta

{
    "id": "pi_1668947502776188928",
    "oggetto": "payment_intent",
    "creato": 1686743067000,
    "livemode": false,
    "valuta": "VND",
    "importo": 10000,
    "stato": "requires_action",
    "client_secret": "pi_1668947502776188928_secret_5eKUVX8MFLiS0nSMEG35YWDJ",
    "next_action": {
        "tipo": "9pay_handle_redirect",
        "9pay_handle_redirect": {
            "url": "https://sand-payment.9pay.vn/portal?baseEncode=eyJhbW91bnQiOiIxMDAwMCIsImN1cnJlbmN5IjoiVk5EIiwiZGVzY3JpcHRpb24iOiJkZXNjcmlwdGlvbiIsImludm9pY2Vfbm8iOiJjaF8xNjY4OTQ3NTAyOTAyMDE4MDQ4IiwibWVyY2hhbnRLZXkiOiJQVEpwOXUiLCJyZXR1cm5fdXJsIjoiaHR0cHM6Ly9hcGl0ZXN0Lndvb3NocGF5LmNvbS92MS9yZWNlaXZlcy9jMTEvcnVybCIsInRpbWUiOiIxNjg2NzQzMDY2In0=&signature=jhZPpXG1XQDVwnexSSnr0WQap2HpLx0NqeeY2NDj3kQ="
        }
    },
    "tipi_di_pagamento": [
        "9pay"
    ],
    "metodo_di_conferma": "automatic",
    "return_url": "https://swooshtransfer.com/",
    "metodo di pagamento": "pm_1668947502629388288",
    "metodo di acquisizione": "automatic"
}

Cassa #

Flusso di pagamento #

1. Il cliente seleziona 9Pay dall'elenco dei metodi di pagamento disponibili e clicca sul pulsante Paga.

1. I clienti saranno reindirizzati alla pagina di login di 9Pay.

1. Ad esempio, i clienti selezionano il portafoglio elettronico 9Pay. Poi i clienti scansionano il codice QR per completare il pagamento.

1. Dopodiché, i clienti saranno reindirizzati alla pagina designata.

Creare una sessione #

Richiesta

{
    "cancel_url": "https://swooshtransfer.com/",
    "modalità": "payment",
    "success_url": "https://swooshtransfer.com/",
    "tipi_di_metodo_di_pagamento": [
        "9pay"
    ],
    "voci_di_linea": [
        {
            "price_data": {
                "valuta": "VND",
                "prodotto": nullo,
                "importo_unità": 10000,
                "attivo": vero,
                "metadati": {
                    "key1": "valore1",
                    "chiave2": "valore2"
                },
                "nickname": "mela",
                "dati_prodotto": {
                    "id": null,
                    "nome": "apple",
                    "attivo": vero,
                    "descrizione": "molto delizioso",
                    "metadati": {
                        "key1": "valore1",
                        "chiave2": "valore2"
                    },
                    "url": "www.baidu.com"
                },
                "billing_scheme": "testscheme",
                "lookup_key": "test_lookup_key"
            },
            "quantità": 1
        }
    ]
}

Risposta

{
    "id": "cs_1668947425479360512",
    "oggetto": "checkout.session",
    "creato": 1686743048000,
    "livemode": false,
    "valuta": "VND",
    "cliente": "",
    "modalità": "pagamento",
    "stato": "open",
    "url": "https://checkouttest.wooshpay.com/pay/cs_test_1668947425479360512?key=pk_test_NTE2Njg1MDgwNDUzOTY4MDc2ODAxOm9Oa3pjN043U2dYWE84VVhGZmF4cThvTTE2ODY2MzgyOTYzMjU",
    "cancel_url": "https://swooshtransfer.com/",
    "voci_di_linea": {
        "oggetto": "elenco",
        "dati": [
            {
                "id": "li_1668947425508720640",
                "oggetto": "item",
                "valuta": "VND",
                "descrizione": "mela",
                "prezzo": {
                    "id": "price_1668947425533886464",
                    "oggetto": "prezzo",
                    "creato": 1686743048000,
                    "livemode": false,
                    "active": true,
                    "valuta": "VND",
                    "metadati": {
                        "chiave1": "valore1",
                        "chiave2": "valore2"
                    },
                    "nickname": "mela",
                    "prodotto": {
                        "id": "prod_1668947425546469376",
                        "oggetto": "prodotto",
                        "creato": 1686743048000,
                        "livemode": false,
                        "active": true,
                        "descrizione": "molto delizioso",
                        "metadati": {
                            "key1": "valore1",
                            "chiave2": "valore2"
                        },
                        "nome": "apple",
                        "url": "www.baidu.com",
                        "aggiornato": 1686743048000
                    },
                    "tipo": "one_time",
                    "importo_unità": 10000,
                    "schema di fatturazione": "per_unità",
                    "lookup_key": "test_lookup_key"
                },
                "quantità": 1,
                "importo_subtotale": 10000,
                "importo_totale": 10000
            }
        ]
    },
    "Intento di pagamento": "pi_1668947425710047232",
    "tipi_di_pagamento": [
        "9pay"
    ],
    "stato_di_pagamento": "unpaid",
    "success_url": "https://swooshtransfer.com/",
    "amount_subtotal": 10000,
    "importo_totale": 10000,
    "indirizzo_di_fatturazione_raccolta": "auto",
    "scadenza": 1686829448437,
    "link_di_pagamento": "",
    "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.