Passer au contenu principal

Requête

POST /v3/bills/discover prend trois champs :

Réponse

200 signifie que la découverte a été acceptée. Les factures ne figurent pas dans cette réponse.

Interroger jusqu’à READY

Appelez GET /v3/bills/transactions/{transactionId} toutes les 2 à 3 secondes jusqu’à ce que status quitte PENDING. Une découverte se termine normalement en quelques secondes ; en période de charge, elle peut prendre quelques minutes.

L’objet bill

Le client paie amount + fee. Les frais sont configurés par facturier et peuvent changer ; affichez toujours les valeurs de la réponse.

Résultats

error.code sur une découverte FAILED :

Erreurs synchrones

Elles sont renvoyées immédiatement, et aucune transaction n’est créée.

À propos de ref

  • Obligatoire, jusqu’à 100 caractères.
  • Doit être unique parmi vos transactions pour ce partenaire. La réutiliser renvoie 403 DUPLICATED_REF.
  • Enregistrée sur la transaction et renvoyée comme ref dans chaque réponse.
  • Permet de reprendre après une expiration réseau : GET /v3/bills/transactions/by-ref?ref=… vous indique si la découverte a été créée.
Générez une nouvelle ref pour chaque appel.

Suivant : Paiement des factures

Payer une facture ou plusieurs en une seule commande