Scoprite PromptPay, un servizio di trasferimento istantaneo di fondi molto diffuso in Thailandia.

PromptPay è una soluzione infrastrutturale sviluppata e regolamentata dall'autorità preposta alla politica dei pagamenti, la Bank of Thailand (BoT). Le loro roadmap per i sistemi di pagamento modernizzano l'infrastruttura di pagamento nel Paese insieme alle banche. Per trasferire fondi tra le banche, gli utenti vengono identificati attraverso deleghe come il numero di telefono cellulare, il numero di identificazione nazionale, il numero di registrazione aziendale o il numero di portafoglio digitale.

Caratteristiche #

Flusso di pagamento #

Metodo di integrazione #

Valori dell'enumerazione del metodo di pagamento: pagamento immediato

Esistono due metodi di integrazione per PromptPay

1. API diretta
2. Cassa

Diretto API #

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. Creare un PaymentIntent sul server e specificare l'importo da riscuotere e una valuta supportata. Se si dispone di un'integrazione PaymentIntents esistente, aggiungere promptpay all'elenco dei tipi di metodo di pagamento.

Richiesta

{
    "importo":1000,
    "valuta": "THB",
    "confirm":true,
    "dati_metodo_di_pagamento" : {
        "type": "promptpay"
    },
    "return_url": "https://your.website"
}

Risposta

{
    "id": "pi_1664208234002513920",
    "oggetto": "payment_intent",
    "creato": 1685613137000,
    "valuta": "THB",
    "importo": 1000,
    "stato": "requires_action",
    "livemode": false,
    "client_secret": "pi_1664208234002513920_secret_tzDL9JipXe0RE3qGTkNVty9j",
    "next_action": {
        "tipo": "promptpay_handle_redirect",
        "promptpay_handle_redirect": {
            "url": "https://apitest.wooshpay.com/v1/receives/c12/pay/pi_1664208234002513920"
        }
    },
    "tipi_di_pagamento": [
        "promptpay"
    ],
    "metodo di conferma": "automatic",
    "return_url": "https://your.website",
    "metodo di pagamento": "pm_1664208233880879104",
    "metodo di acquisizione": "automatic"
}

Cassa #

Creare una visione #

Richiesta

{
    "cancel_url": "www.wooshpay.com",
    "modalità": "payment",
    "success_url": "https://wooshpay.com/",
    "tipi_di_metodo_di_pagamento": [
        "promptpay"
    ],
    "voci_di_linea": [
        {
            "price_data": {
                "valuta": "THB",
                "unit_amount": 100,
                "nickname": "apple",
                "dati_prodotto": {
                    "nome": "mela"
                },
                "billing_scheme": "testscheme",
                "lookup_key": "test_lookup_key"
            },
            "quantità": 1
        }
    ]
}

Risposta

{
    "id": "cs_1676158633408200704",
    "oggetto": "checkout.session",
    "creato": 1688462334000,
    "livemode": false,
    "currency": "THB",
    "cliente": "",
    "modalità": "pagamento",
    "stato": "open",
    "url": "https://checkouttest.wooshpay.com/pay/cs_test_1676158633408200704?key=pk_test_NTE2NzQzMzIzODEyNTI4MTY4OTYxOjEyVWdaRjhhSGpqOFZhRDZvaFRyc1RZbzE2ODgwMjY5MjU5NTk",
    "cancel_url": "www.wooshpay.com",
    "voci_di_linea": {
        "oggetto": "elenco",
        "dati": [
            {
                "id": "li_1676158633437560832",
                "oggetto": "item",
                "valuta": "THB",
                "descrizione": "mela",
                "prezzo": {
                    "id": "price_1676158633450143744",
                    "oggetto": "prezzo",
                    "creato": 1688462334000,
                    "livemode": false,
                    "active": true,
                    "valuta": "THB",
                    "nickname": "apple",
                    "prodotto": {
                        "id": "prod_1676158633462726656",
                        "oggetto": "prodotto",
                        "creato": 1688462334000,
                        "livemode": false,
                        "active": true,
                        "nome": "apple",
                        "aggiornato": 1688462334000
                    },
                    "tipo": "one_time",
                    "importo_unità": 100,
                    "schema di fatturazione": "per_unità",
                    "lookup_key": "test_lookup_key"
                },
                "quantità": 1,
                "importo_subtotale": 100,
                "importo_totale": 100
            }
        ]
    },
    "Intento di pagamento": "pi_1676158633626304512",
    "tipi_di_pagamento": [
        "promptpay"
    ],
    "payment_status": "unpaid",
    "success_url": "https://wooshpay.com/",
    "importo_subtotale": 100,
    "importo_totale": 100,
    "indirizzo_di_fatturazione_raccolta": "auto",
    "scadenza": 1688548734385,
    "link_di_pagamento": "",
    "client_secret": "pi_1676158633626304512_secret_JbvbX6yCPEBB886Z46Rs5vw8"
}

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.