Début du processus de traitement des paiements selon le schéma Host-to-host
Endpoint: /api/h2h/start
Paramètres transmis:
| Champ | Description du champ |
|---|---|
| payment_id | numéro de suivi de l’ordre de paiement dans le système comptable du client |
| session | Identifiant de session h2h reçu lors de la conception du paiement |
Exemple de demande: { "payment_id": "12345", "session": "6EEB-220B-FB62-3405-0C57-65FA-0C4C-F6D4" }
Exemple de réussite: { "is_white": false, "session": "01777a77-210b-43d4-ad2d-9599825fc12d", "result": true, "next_step": "process", "final": false, "data": { "cardNumber": { "field": "cardNumber", "title": "Card number", "placeholder": "4444111144441111", "hidden": false, "required": true }, "month": { "field": "month", "title": "Expiry month", "placeholder": "12", "hidden": false, "required": true }, "year": { "field": "year", "title": "Expiry year", "placeholder": "25", "hidden": false, "required": true }, "cvv": { "field": "cvv", "title": "CVV", "placeholder": "***", "hidden": false, "required": true }, "cardHolder": { "field": "cardHolder", "title": "Cardholder name", "placeholder": "CARDHOLDER NAME", "hidden": false, "required": true } } }
Liste des champs retournés:
| Champ | Description du champ |
|---|---|
| error | description de l'erreur |
| session | ID de la session au cours de laquelle la requête est exécutée |
| payment_id | identifiant de paiement côté commerçant |
| result | résultat de la demande (réussie ou non) |
| next_step | ID de l'étape suivante (/api/h2h/{ID d'étape}) où envoyer les données complétées reçues sur le terrain data |
| final | La séance est-elle en phase finale ? |
| data |
Un ensemble de données qui doivent être demandées à l'utilisateur pour poursuivre l'opération. Les données sont représentées à partir d'une masse d'objets: field - nom du champ (identifiant avec lequel les données doivent être transférées à l'étape suivante) title - description du champ placeholder - exemple de remplissage d'un champ hidden - champ caché ou pas required - Ce champ est-il obligatoire ou non ? |