Découvrez PromptPay, un service de transfert de fonds instantané très populaire en Thaïlande.

PromptPay est une solution d'infrastructure développée et réglementée par l'autorité responsable de la politique de paiement, la Banque de Thaïlande (BoT). Ses feuilles de route pour le système de paiement modernisent l'infrastructure de paiement dans le pays aux côtés des banques. Pour transférer des fonds entre les banques, les utilisateurs sont identifiés par des procurations telles que le numéro de téléphone mobile, le numéro d'identification national, le numéro d'enregistrement de l'entreprise ou le numéro du portefeuille numérique.

Caractéristiques #

Flux de paiement #

Méthode d'intégration #

Valeurs de l'énumération des méthodes de paiement : paiement rapide

Il existe deux méthodes d'intégration pour PromptPay

1. API directe
2. Sortie de caisse

Direct API #

Comment s'intégrer #

Pour une intégration API directe, vous pouvez créer un PaymentIntent et obtenir l'url en une seule étape. Voici la démonstration de la création d'une intention de paiement :

Créer un PaymentIntent

Un PaymentIntent est un objet qui représente votre intention de percevoir un paiement de la part de votre client et qui suit le cycle de vie du processus de paiement. Créez un PaymentIntent sur votre serveur et indiquez le montant à collecter ainsi qu'une devise prise en charge. Si vous avez déjà intégré PaymentIntent, ajoutez promptpay à la liste des types de méthodes de paiement.

Demande

{
    "montant":1000,
    "devise" : "THB",
    "confirm":true,
    "payment_method_data" : {
        "type" : "promptpay"
    },
    "return_url" : "https://your.website"
}

Réponse

{
    "id" : "pi_1664208234002513920",
    "object" : "payment_intent",
    "created" : 1685613137000,
    "currency" : "THB",
    "montant" : 1000,
    "status" : "requires_action",
    "livemode" : false,
    "client_secret": "pi_1664208234002513920_secret_tzDL9JipXe0RE3qGTkNVty9j",
    "next_action" : {
        "type" : "promptpay_handle_redirect",
        "promptpay_handle_redirect" : {
            "url" : "https://apitest.wooshpay.com/v1/receives/c12/pay/pi_1664208234002513920"
        }
    },
    "payment_method_types" : [
        "promptpay"
    ],
    "confirmation_method" : "automatic",
    "return_url" : "https://your.website",
    "payment_method" : "pm_1664208233880879104",
    "capture_method" : "automatic"
}

Sortie de caisse #

Créer une session #

Demande

{
    "cancel_url" : "www.wooshpay.com",
    "mode" : "paiement",
    "success_url" : "https://wooshpay.com/",
    "payment_method_types" : [
        "promptpay"
    ],
    "line_items" : [
        {
            "price_data" : {
                "currency" : "THB",
                "unit_amount" : 100,
                "nickname" : "apple",
                "product_data" : {
                    "name" : "pomme"
                },
                "billing_scheme" : "testscheme",
                "lookup_key" : "test_lookup_key"
            },
            "quantity" : 1
        }
    ]
}

Réponse

{
    "id" : "cs_1676158633408200704",
    "object" : "checkout.session",
    "created" : 1688462334000,
    "livemode" : false,
    "currency" : "THB",
    "client" : "",
    "mode" : "paiement",
    "status" : "ouvert",
    "url" : "https://checkouttest.wooshpay.com/pay/cs_test_1676158633408200704?key=pk_test_NTE2NzQzMzIzODEyNTI4MTY4OTYxOjEyVWdaRjhhSGpqOFZhRDZvaFRyc1RZbzE2ODgwMjY5MjU5NTk",
    "cancel_url" : "www.wooshpay.com",
    "line_items" : {
        "object" : "liste",
        "data" : [
            {
                "id" : "li_1676158633437560832",
                "objet" : "item",
                "devise" : "THB",
                "description" : "pomme",
                "prix" : {
                    "id" : "price_1676158633450143744",
                    "objet" : "prix",
                    "created" : 1688462334000,
                    "livemode" : false,
                    "active" : true,
                    "currency" : "THB",
                    "pseudo" : "apple",
                    "produit" : {
                        "id" : "prod_1676158633462726656",
                        "objet" : "produit",
                        "created" : 1688462334000,
                        "livemode" : false,
                        "active" : true,
                        "name" : "apple",
                        "updated" : 1688462334000
                    },
                    "type" : "one_time",
                    "unit_amount" : 100,
                    "billing_scheme" : "per_unit",
                    "lookup_key" : "test_lookup_key"
                },
                "quantity" : 1,
                "amount_subtotal" : 100,
                "amount_total" : 100
            }
        ]
    },
    "payment_intent" : "pi_1676158633626304512",
    "payment_method_types" : [
        "promptpay"
    ],
    "payment_status" : "non payé",
    "success_url" : "https://wooshpay.com/",
    "amount_subtotal" : 100,
    "amount_total" : 100,
    "billing_address_collection" : "auto",
    "expires_at" : 1688548734385,
    "payment_link" : "",
    "client_secret": "pi_1676158633626304512_secret_JbvbX6yCPEBB886Z46Rs5vw8"
}

Prochaine étape #

Vous pouvez ajouter d'autres fonctionnalités à votre intégration en fonction de vos besoins.

Créer un Webhook #

Écoutez les événements sur votre compte WooshPay afin que votre intégration puisse déclencher automatiquement des réactions. Créez un webhook qui se concentre principalement sur enabled_events et url.