TrueMoney est une application de portefeuille électronique couvrant 6 pays de l'Union européenne. SEA (Thaïlande, Cambodge, Myanmar, Indonésie, Philippines et Vietnam). En Thaïlande, la plateforme comprend TrueMoney Wallet, WeCard by MasterCard, TrueMoney Cash Card, Kiosk, Express, Payment Passerelle et les envois de fonds. D'ici à décembre 2020, la plateforme comptera plus de 15 millions d'utilisateurs actifs dans toute la Thaïlande, et ce chiffre ne cessera de croître.

Caractéristiques #

Méthode d'intégration #

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

Il existe une méthode d'intégration pour TrueMoney

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 d'encaisser le paiement 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 à encaisser ainsi qu'une devise prise en charge. Si vous disposez d'une intégration Payment Intents existante, ajoutez argent fictif à la liste des types de méthodes de paiement.

Demande

{
    "montant" : 2000,
    "devise" : "THB",
    "confirm" : true,
    "payment_method_options" : {
        "truemoney" : {
            "terminal_type" : "WEB",
            "os_type" : "ANDROID"
        }
    },
    "payment_method_types" : ["truemoney"],
        "return_url" : "https://wooshpay.com"
    }

Réponse

{
    "id" : "pi_1663020464626204672",
    "object" : "payment_intent",
    "created" : 1685329951000,
    "currency" : "THB",
    "montant" : 1000,
    "status" : "requires_action",
    "livemode" : false,
    "quantité" : 2,
    "client_secret": "pi_1663020464626204672_secret_KbWwv9WBTBMVMrYZOJh3A7UH",
    "next_action" : {
        "type" : "promptpay_handle_redirect",
        "promptpay_handle_redirect" : {
            "url" : "https://apitest.wooshpay.com/v1/receives/ipay88/pay/pi_1663020464626204672"
        }
    },
    "payment_method_types" : [
        "promptpay"
    ],
    "confirmation_method" : "automatic",
    "return_url" : "https://your.website",
    "payment_method" : "pm_1663020464512958464",
    "capture_method" : "automatic"
}

Sortie de caisse #

Flux de paiement #

1. Le client sélectionne TrueMoney dans la liste des méthodes de paiement disponibles et clique sur le bouton Payer.

2. Les clients seront redirigés vers la page de TrueMoney. Scanner le QR et approuver le paiement

Créer une session #

Demande

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

Réponse

{
    "id" : "cs_1680921737639755776",
    "object" : "checkout.session",
    "created" : 1689597947000,
    "livemode" : false,
    "currency" : "THB",
    "client" : "",
    "mode" : "paiement",
    "status" : "ouvert",
    "url" : "https://checkouttest.wooshpay.com/pay/cs_test_1680921737639755776?key=pk_test_NTE2Njg1MDgwNDUzOTY4MDc2ODAxOm9Oa3pjN043U2dYWE84VVhGZmF4cThvTTE2ODY2MzgyOTYzMjU",
    "cancel_url" : "www.wooshpay.com",
    "line_items" : {
        "object" : "liste",
        "data" : [
            {
                "id" : "li_1680921737673310208",
                "objet" : "item",
                "currency" : "THB",
                "description" : "pomme",
                "prix" : {
                    "id" : "price_1680921737681698816",
                    "objet" : "prix",
                    "created" : 1689597947000,
                    "livemode" : false,
                    "active" : false,
                    "currency" : "THB",
                    "produit" : {
                        "id" : "prod_1680921737694281728",
                        "objet" : "produit",
                        "created" : 1689597947000,
                        "livemode" : false,
                        "active" : false,
                        "name" : "apple",
                        "updated" : 1689597947000
                    },
                    "type" : "one_time",
                    "unit_amount" : 2000,
                    "billing_scheme" : "per_unit",
                    "lookup_key" : "test_lookup_key"
                },
                "quantity" : 1,
                "amount_subtotal" : 2000,
                "amount_total" : 2000
            }
        ]
    },
    "payment_intent" : "pi_1680921737866248192",
    "payment_method_types" : [
        "truemoney"
    ],
    "payment_status" : "non payé",
    "success_url" : "https://wooshpay.com/",
    "amount_subtotal" : 2000,
    "amount_total" : 2000,
    "billing_address_collection" : "auto",
    "expires_at" : 1689684346928,
    "payment_link" : "",
    "client_secret": "pi_1680921737866248192_secret_bKslLOpffohD4ni828W4Ilpu"
}

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.

Créer un remboursement #

Créez un remboursement pour restituer des fonds à votre client. Vous pouvez également effectuer des remboursements partiels, mais ils ne sont pas pris en charge par toutes les méthodes de paiement. Un remboursement partiel consiste à ne rembourser qu'une partie du montant de la transaction initiale.