Caractéristiques #

Méthode d'intégration #

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

Il existe deux méthodes d'intégration pour les virements bancaires

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 virement bancaire.

2. Après avoir effectué les virements bancaires locaux et cliqué sur "J'ai effectué le paiement", les clients verront "le paiement est en cours de traitement", puis seront redirigés vers return_url.

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

Créez un PaymentIntent sur votre serveur et indiquez le montant à collecter ainsi qu'une devise prise en charge.

Pour les virements bancaires, notamment, vous devez également collecter les données du client. nom, pays et courriel en payment_method_data.billing_details.

Si vous disposez déjà d'une intégration Payment Intents, ajoutez bank_transfer_uk à la liste des types de méthodes de paiement.

Demande

{
    "montant":1000,
    "devise" : "GBP",
    "confirm":true,
    "payment_method_data" : {
        "type" : "bank_transfer_eu",
        "billing_details":{
            "address" : {
                "line1" : "XX mansion",
                "ligne2" : "XX Ville",
                "ville" : "ville",
                "state" : "Californie",
                "country" : "GB",
                "postal_code" : "55555"

            },
            "name" : "Tom Elis",
            "email" : "[email protected]"
        }
    },
    "quantity" : 2,
    "merchant_user_id" : "123456",
    "merchant_order_id" : "Order112344343",
    "return_url" : "https://your.website"
}

réponse

{
    "id" : "pi_1661558941487726592",
    "object" : "payment_intent",
    "created" : 1684981497000,
    "currency" : "GBP",
    "amount" : 1000,
    "status" : "requires_action",
    "description" : "description du produit",
    "livemode" : false,
    "quantity" : 2,
    "merchant_user_id" : "123456",
    "merchant_order_id" : "Order112344343",
    "client_secret": "pi_1661558941487726592_secret_g4Xl2kP98fwFD5x4HSVyK0Rm",
    "next_action" : {
        "type" : "bank_transfer_uk_handle_redirect",
        "bank_transfer_uk_handle_redirect" : {
            "url" : "https://pay-sandbox.tazapay.com/marketplace/paymentdetails/8t0-UMIIGKyeiECODNFV6ldbGjpumbMOsbqpmuw7sg8NXjQ_B_YxmEXSnr_nHAeZ"
        }
    },
    "payment_method_types" : [
        "bank_transfer_uk",
        "bank_transfer_eu",

    ],
    "confirmation_method" : "automatique",
    "return_url" : "https://your.website",
    "payment_method" : "pm_1661558941370286080",
    "capture_method" : "automatic"
}

Sortie de caisse #

Flux de paiement #

1. Le client sélectionne le virement bancaire dans la liste des modes de paiement disponibles et remplit les informations relatives au paiement.

2. Les clients envoient de l'argent sur un compte bancaire local

3. Après avoir effectué des virements bancaires locaux et cliqué sur "J'ai effectué le paiement", la page indiquera aux clients que le paiement est en cours de traitement et sera ensuite redirigée vers return_url.

Créer une session #

Demande

{
    "cancel_url" : "www.wooshpay.com",
    "mode" : "paiement",
    "success_url" : "https://wooshpay.com/",
    "payment_method_types" : [
        "bank_transfer_eu",
        "bank_transfer_uk"
    ],
    "line_items" : [
        {
            "price_data" : {
                "currency" : "EUR",
                "produit" : null,
                "unit_amount" : 100000,
                "active" : true,
                "metadata" : {
                    "key1" : "value1",
                    "key2" : "valeur2"
                },
                "surnom" : "apple",
                "product_data" : {
                    "id" : null,
                    "name" : "apple",
                    "active" : true,
                    "description" : "miam miam",
                    "url" : "www.wooshpay.com"
                },
                "billing_scheme" : "testscheme",
                "lookup_key" : "test_lookup_key"
            },
            "quantity" : 1
        }
    ]
}

Réponse

{
    "id" : "cs_1661288382405279744",
    "object" : "checkout.session",
    "created" : 1684916990000,
    "currency" : "EUR",
    "client" : "",
    "mode" : "paiement",
    "livemode" : false,
    "status" : "ouvert",
    "url" : "https://checkouttest.wooshpay.com/pay/cs_test_1661288382405279744?key=pk_test_NTE2NTc5NDIzMjU1MzM0Nzg5MTMxOjMzb1M2aUVkNkNvalZPRE1nTW5ITDhYcDE2ODQxMTkyMjgzMTQ",
    "cancel_url" : "www.wooshpay.com",
    "line_items" : {
        "object" : "liste",
        "data" : [
            {
                "id" : "li_1661288382443028480",
                "object" : "item",
                "currency" : "EUR",
                "description" : "pomme",
                "prix" : {
                    "id" : "price_1661288382476582912",
                    "objet" : "prix",
                    "created" : 1684916990000,
                    "active" : true,
                    "currency" : "EUR",
                    "metadata" : {
                        "key1" : "value1",
                        "key2" : "valeur2"
                    },
                    "surnom" : "pomme",
                    "produit" : {
                        "id" : "prod_1661288382493360128",
                        "objet" : "produit",
                        "created" : 1684916990000,
                        "active" : true,
                        "description" : "miam miam",
                        "nom" : "pomme",
                        "livemode" : false,
                        "url" : "www.wooshpay.com",
                        "updated" : 1684916990000
                    },
                    "type" : "one_time",
                    "livemode" : false,
                    "unit_amount" : 100000,
                    "billing_scheme" : "per_unit",
                    "lookup_key" : "test_lookup_key"
                },
                "quantity" : 1,
                "amount_subtotal" : 100000,
                "montant_total" : 100000
            }
        ]
    },
    "payment_intent" : "pi_1661288382682103808",
    "payment_method_types" : [
        "bank_transfer_eu",
        "bank_transfer_uk"
    ],
    "payment_status" : "unpaid",
    "success_url" : "https://wooshpay.com/",
    "amount_subtotal" : 100000,
    "amount_total" : 100000,
    "billing_address_collection" : "auto",
    "expires_at" : 1685003390272,
    "payment_link" : "",
    "client_secret": "pi_1661288382682103808_secret_VNK78femqxwsDZbKCRRKvQHR"
}

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.