Obtenir un Token

S’applique à l’obtention d’un Token via la page de paiement hébergée de YabandPay

La page de paiement hébergée (HPP) de YabandPay est une page prête à l’emploi, entièrement gérée par YabandPay. Les marchands peuvent accepter des paiements en toute sécurité en hébergeant les données PCI sensibles dans le système YabandPay. Le formulaire peut être intégré au parcours de paiement du marchand sous forme d’iframe ou de page de redirection.

Une fois que le payeur a effectué une transaction standard par carte de crédit sur la page de paiement hébergée de YabandPay et donné son consentement, YabandPay convertit les données sensibles du titulaire en une chaîne aléatoire (un Token) afin de supprimer les informations permettant de l’identifier. Le Token peut être utilisé pour les paiements suivants :

1. Les utilisateurs peuvent payer en un clic sur la page de paiement, sans saisir les coordonnées de leur carte.
2. Les marchands peuvent utiliser ce Token pour les paiements récurrents, les abonnements et des usages similaires.

[!TIP|style:flat] Workflow

1. Activez les paiements par Token. Contactez votre chargé de compte pour activer cette fonctionnalité.

2. Obtenez le consentement de l’utilisateur. Lors de l’activation des paiements express (paiements par Token), vous devez informer clairement les consommateurs et obtenir leur consentement afin d’éviter tout litige.

3. Obtenez un Token. Commencez par initier une transaction standard par carte de crédit. YabandPay renvoie a payment url. After the user completes payment through that url and gives consent, YabandPay renvoie the Token in an asynchronous notification using the payment_token_object parameter.

4. Initiez un paiement par Token. Incluez le Token dans la payment_token_object variable. Si la validation du Token réussit, YabandPay traite le paiement. Dans le cas contraire, YabandPay renvoie une erreur. Dans ce cas, nous recommandons d’initier une nouvelle transaction standard par carte de crédit pour obtenir un Token, puis de relancer le paiement.

• Parameters

Signature example:

Sorted parameters concatenated into a URL-style query string

"3ds_initiate=01&amount=0.1&currency=EUR&description=test&email=JohnSmith@gmail.com&form_type=01&method=v3.CreateCardPayments&notify_url=https://www.yabandpay.com/notify&operation=11&order_id=1725875388&pay_method=online&request_id=dxktqiedfpkswnripi631ppg6fl2uoym&sub_pay_method=Cards HPP&time=1725875388&timeout=30&user=YOUR_CASHIER_UID"

Sign stringA using secret_key

Le champ resulting signature is:

"YOUR_SIGNATURE"

Exemple de requête:

{
    "user": "YOUR_CASHIER_UID",
    "sign": "YOUR_SIGNATURE",
    "method": "v3.CreateCardPayments",
    "time": 1725875388,
    "data": {
        "3ds_initiate": "01",
        "description": "test",
        "timeout": "30",
        "pay_method": "online",
        "sub_pay_method": "Cards HPP",
        "operation": "11",
        "form_type": "01",
        "order_id": 1725875388,
        "amount": "0.1",
        "currency": "EUR",
        "email": "JohnSmith@gmail.com",
        "notify_url": "https://www.yabandpay.com/notify",
        "request_id": "dxktqiedfpkswnripi631ppg6fl2uoym"
    }
}

Exemple de réponse:

{
    "status": true,
    "code": "200",
    "data": {
        "order_id": "YOUR_ORDER_ID",
        "trade_id": "2b2aa1af-6e97-4c01-8c52-86200bf66c82",
        "amount": "0.1",
        "currency": "EUR",
        "url": "https://pay.yabandpay.com/pay_method/Y3JlZGl0Y2FyZA==/MmIyYWExYWYtNmU5Ny00YzAxLThjNTItODYyMDBiZjY2Yzgy",
        "state": "processing"
    },
    "message": "",
    "response_id": "202409091749500451314672"
}

Informations complémentaires:

MIT & CIT :

MIT = Merchant Initiated subsequent transactions. Token payments initiated by the merchant.

CIT = Cardholder Initiated Subsequent transactions. Token payments involving the customer. When activating payments, specify whether you need MIT or CIT so the appropriate mode can be configured.

Résultat du paiement:

1. Une requête réussie renvoie "status": true.

2. Une requête échouée renvoie "status": false.

Redirect the customer to the returned url. After entering card details and completing payment at this url, the customer is redirected to redirect_url. Nous recommandons vivement d’utiliser à la fois Query Order and Asynchronous Notifications afin de maintenir les statuts de paiement exacts et à jour.

Token renvoyé:

1. After the customer grants authorization and the payment succeeds, YabandPay renvoie payment_token_object through an asynchronous notification.

2. If the customer does not grant authorization or does not complete payment, the asynchronous notification does not return payment_token_object.

3DS low-value exemption:

Les transactions respectant les limites suivantes peuvent être considérées comme des transactions de faible montant. Si le montant de la commande est inférieur ou égal au plafond applicable ci-dessous, le code de transaction 02 (low-value exemption) peut être utilisé sous réserve d’approbation.

Response codes: