Paiements par jeton

S’applique à l’initiation de paiements par Token avec une carte de crédit

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 numérique 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=1&currency=EUR&description=test&method=v3.CreateCardPayments&notify_url=https://www.yabandpay.com/notify&operation=11&order_id=1725875543&pay_method=online&payment_token_object=VnXaRabcsedfsSlPFZXavcsdfasdEFDd&request_id=hjf5lv32i40lh7oh86j6az98tnscwv37&sub_pay_method=Token&time=1725875543&timeout=0&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": 1725875543,
    "data": {
        "3ds_initiate": "01",
        "description": "test",
        "timeout": "0",
        "pay_method": "online",
        "sub_pay_method": "Token",
        "operation": "11",
        "order_id": 1725875543,
        "amount": "1",
        "currency": "EUR",
        "payment_token_object": "VnXaRabcsedfsSlPFZXavcsdfasdEFDd",
        "notify_url": "https://www.yabandpay.com/notify",
        "request_id": "hjf5lv32i40lh7oh86j6az98tnscwv37"
    }
}

Exemple de réponse:

{
    "status": true,
    "code": "200",
    "data": {
        "order_id": "YOUR_ORDER_ID",
        "trade_id": "109bb0e9-e1fb-49cb-c537-ec944f33c388",
        "amount": "1.00",
        "currency": "EUR",
        "state": "paid"
    },
    "message": "",
    "response_id": "202409091752241912726578"
}

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 de la réponse:

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

2. Si l’appel échoue, "status": false est renvoyé. If you receive Invalid Token, we recommend calling HPP Token again to obtain a new Token.

Le champ API returns the payment status synchronously. Nous recommandons vivement d’utiliser à la fois Order Query and Asynchronous Notifications afin de synchroniser et mettre à jour le statut du paiement et de maintenir les informations exactes en temps réel. a) If the order status state is paid, payment succeeded; b) if the order status state is authorized, authorization succeeded. To capture funds after successful authorization, call the authorization capture API.

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: