Découvrez DANA, un portefeuille numérique populaire auprès des clients indonésiens. #

DANA est un portefeuille numérique indonésien qui compte plus de 30 millions d'utilisateurs. Il s'agit d'une application tout-en-un qui permet aux utilisateurs d'effectuer en toute sécurité des paiements en espèces et sans carte pour leur usage quotidien. Avec Dana, il est possible de payer en ligne, dans les magasins, de faire des recharges mobiles et de régler des factures.

Caractéristiques #

Méthode d'intégration #

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

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

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 DANA.

2. Le client se connecte à son compte DANA et effectue le paiement.

3. Le paiement est effectué et le client est redirigé 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 à collecter ainsi qu'une devise prise en charge. Si vous avez déjà intégré PaymentIntent, ajoutez dana à la liste des types de méthodes de paiement.

Demande

{
    "montant":100,
    "devise" : "IDR",
    "confirm":true,
    "payment_method_data" : {
        "type" : "dana"
    },
    "return_url" : "https://your.website"
}

Réponse

{
    "id": "pi_1646356544343769088",
    "object": "payment_intent",
    "created": 1681356963000,
    "currency": "IDR",
    "amount": 100,
    "status": "requires_action",
    "livemode": true,
    "client_secret": "pi_1646356544343769088_secret_m58mCj87dL3cj5JiUOtbdx2e",
    "next_action": {
        "type": "redirect_to_url",
        "dana_handle_redirect": {
            "url": "https://m.dana.id/m/portal/cashier/checkout?bizNo=20230413111212800110166041377848845&timestamp=1681356963277&originSourcePlatform=IPG&mid=216620000562418247453&sign=LY3%2FomMnXVJqk9uEOZJopCnSb%2FBDk64I9nIhBZdHc3wi%2Fo%2BcIVCBmCWTacAxHv%2BAKV0auNlCbkyrKvdK2B1X7aoiDv2dxO%2BAfdc7dkmny4FzOJ%2BrxNBmWerSkoexkEw1u52TMIWwLnDzwXYiGTsrs%2Bhzkew4okaJ2w9i4hMJh%2FLDRym0XwYaX9h7N0MCkrXYNY%2FfrEdY8BW%2BazU2wYWdDH%2B4fkgSs7D9YxXj%2Fu2eon2JaGuWYht93piOji22pGW9hD1ubH1vi4lZwFfp96Lp1fsgzV2uvRv6d8CTXSQw%2Fg9oeI3jFXw1bHqBZocv51QZl3AfKvXauWBSVClj4CziDw%3D%3D&forceToH5=false"
        }
    },
    "payment_method_types": [
        "dana"
    ],
    "confirmation_method": "automatic",
    "return_url": "https://your.website",
    "payment_method": "pm_1646356544205357056",
    "capture_method": "automatic"
}

Sortie de caisse #

Flux de paiement #

1. Le client sélectionne DANA 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 connexion DANA.

3. Le client se connecte à son compte DANA et effectue le paiement.

4. Le paiement est effectué et le client est redirigé vers la page que vous avez désignée.

Créer une session #

Demande

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

Réponse

{
    "id" : "cs_1676131330724724736",
    "object" : "checkout.session",
    "created" : 1688455825000,
    "livemode" : false,
    "currency" : "IDR",
    "client" : "",
    "mode" : "paiement",
    "status" : "ouvert",
    "url" : "https://checkouttest.wooshpay.com/pay/cs_test_1676131330724724736?key=pk_test_NTE2MjA5NzY5MzgxOTk5NDUyMTYxOnhXNjdQQ3JndjBVZ04wcVVwNk5yaG9PdjE2NzUzMDU5OTc0NTI",
    "cancel_url" : "www.wooshpay.com",
    "line_items" : {
        "object" : "liste",
        "data" : [
            {
                "id" : "li_1676131330754084864",
                "object" : "item",
                "currency" : "IDR",
                "description" : "pomme",
                "prix" : {
                    "id" : "price_1676131330766667776",
                    "objet" : "prix",
                    "created" : 1688455825000,
                    "livemode" : false,
                    "active" : true,
                    "currency" : "IDR",
                    "nickname" : "apple",
                    "produit" : {
                        "id" : "prod_1676131330783444992",
                        "objet" : "produit",
                        "created" : 1688455825000,
                        "livemode" : false,
                        "active" : true,
                        "name" : "apple",
                        "updated" : 1688455825000
                    },
                    "type" : "one_time",
                    "unit_amount" : 20000,
                    "billing_scheme" : "per_unit",
                    "lookup_key" : "test_lookup_key"
                },
                "quantity" : 1,
                "amount_subtotal" : 20000,
                "montant_total" : 20000
            }
        ]
    },
    "payment_intent" : "pi_1676131330947022848",
    "payment_method_types" : [
        "dana"
    ],
    "payment_status" : "non payé",
    "success_url" : "https://wooshpay.com/",
    "amount_subtotal" : 20000,
    "amount_total" : 20000,
    "billing_address_collection" : "auto",
    "expires_at" : 1688542224918,
    "payment_link" : "",
    "client_secret": "pi_1676131330947022848_secret_ENUbfvBKA7zljcENnlrG3K7q"
}

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.