Découvrez 9Pay, un portefeuille numérique populaire auprès des clients vietnamiens. #

Avec plus de millions d'utilisateurs, 9Pay est un portefeuille numérique de premier plan au Viêt Nam, qui répond aux divers besoins de paiement des particuliers. Il s'agit d'une application tout-en-un qui offre une gamme de fonctionnalités pratiques pour une utilisation quotidienne.

Caractéristiques #

Sous-produits #

Méthode d'intégration #

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

Il existe deux méthodes d'intégration pour 9Pay

1. API directe
2. Sortie de caisse

Direct API #

Flux de paiement #

1. Pour l'intégration API directe, après avoir créé une intention de paiement par OpenAPI, les clients seront redirigés vers la page de connexion de 9Pay. Les clients sélectionnent la méthode de paiement

2. Par exemple, le client sélectionne le portefeuille électronique 9Pay. Il scanne ensuite le code QR pour effectuer le paiement.

3. Ensuite, les clients seront redirigés vers la page que vous avez désignée.

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 à percevoir ainsi qu'une devise prise en charge. Si vous avez déjà intégré PaymentIntent, ajoutez 9pay à la liste des types de méthodes de paiement.

Demande

{
    "montant":10000,
    "devise" : "VND",
    "confirm":true,
    "payment_method_data" : {
        "type" : "9pay"
    },
    "return_url" : "https://swooshtransfer.com/"
}

Réponse

{
    "id" : "pi_1668947502776188928",
    "object" : "payment_intent",
    "created" : 1686743067000,
    "livemode" : false,
    "currency" : "VND",
    "montant" : 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" : "automatique",
    "return_url" : "https://swooshtransfer.com/",
    "payment_method" : "pm_1668947502629388288",
    "capture_method" : "automatic"
}

Sortie de caisse #

Flux de paiement #

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

1. Les clients seront redirigés vers la page de connexion de 9Pay.

1. Par exemple, le client sélectionne le portefeuille électronique 9Pay. Il scanne ensuite le code QR pour effectuer le paiement.

1. Ensuite, les clients seront redirigés vers la page que vous avez désignée.

Créer une session #

Demande

{
    "cancel_url" : "https://swooshtransfer.com/",
    "mode" : "paiement",
    "success_url" : "https://swooshtransfer.com/",
    "payment_method_types" : [
        "9pay"
    ],
    "line_items" : [
        {
            "price_data" : {
                "currency" : "VND",
                "produit" : null,
                "unit_amount" : 10000,
                "active" : true,
                "metadata" : {
                    "key1" : "value1",
                    "key2" : "valeur2"
                },
                "surnom" : "apple",
                "product_data" : {
                    "id" : null,
                    "name" : "apple",
                    "active" : true,
                    "description" : "très délicieux",
                    "métadonnées" : {
                        "key1" : "value1",
                        "key2" : "valeur2"
                    },
                    "url" : "www.baidu.com"
                },
                "billing_scheme" : "testscheme",
                "lookup_key" : "test_lookup_key"
            },
            "quantity" : 1
        }
    ]
}

Réponse

{
    "id" : "cs_1668947425479360512",
    "object" : "checkout.session",
    "created" : 1686743048000,
    "livemode" : false,
    "currency" : "VND",
    "client" : "",
    "mode" : "paiement",
    "statut" : "ouvert",
    "url" : "https://checkouttest.wooshpay.com/pay/cs_test_1668947425479360512?key=pk_test_NTE2Njg1MDgwNDUzOTY4MDc2ODAxOm9Oa3pjN043U2dYWE84VVhGZmF4cThvTTE2ODY2MzgyOTYzMjU",
    "cancel_url" : "https://swooshtransfer.com/",
    "line_items" : {
        "object" : "liste",
        "data" : [
            {
                "id" : "li_1668947425508720640",
                "object" : "item",
                "devise" : "VND",
                "description" : "pomme",
                "prix" : {
                    "id" : "price_1668947425533886464",
                    "objet" : "prix",
                    "created" : 1686743048000,
                    "livemode" : false,
                    "active" : true,
                    "currency" : "VND",
                    "metadata" : {
                        "key1" : "value1",
                        "key2" : "valeur2"
                    },
                    "surnom" : "pomme",
                    "produit" : {
                        "id" : "prod_1668947425546469376",
                        "objet" : "produit",
                        "created" : 1686743048000,
                        "livemode" : false,
                        "active" : true,
                        "description" : "très délicieux",
                        "metadata" : {
                            "key1" : "value1",
                            "key2" : "valeur2"
                        },
                        "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,
                "montant_total" : 10000
            }
        ]
    },
    "payment_intent" : "pi_1668947425710047232",
    "payment_method_types" : [
        "9pay"
    ],
    "payment_status" : "non payé",
    "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"
}

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.