Statuts
La Merchant API utilise trois ensembles de statuts : les statuts des transactions pour les paiements, les transferts et les autres transactions ; les statuts des paiements pour les commandes payées par facture crypto ; et les statuts des factures, qui décrivent un paiement crypto plus en détail.
Statuts des transactions
Renvoyés par Récupération d’une transaction et Récupération de l’historique des transactions.
| Statut | Signification | Final |
|---|---|---|
CREATED | La transaction a été créée. | Non |
READY_TO_PROCESS | La transaction est prête à être traitée. | Non |
PENDING | La transaction attend une action ou un contrôle. | Non |
PROCESSING | La transaction est en cours de traitement. | Non |
EXCHANGING | La conversion de devise est en cours. | Non |
COMPLETED | La transaction est effectuée. | Oui |
CANCELLING | L’annulation est en cours. | Non |
CANCELED | La transaction a été annulée. | Oui |
REFUNDING | Le remboursement est en cours. | Non |
REFUNDED | La transaction a été remboursée. | Oui |
Ne considérez un paiement comme effectué que lorsque son statut est COMPLETED. Suivez la transaction jusqu’à ce qu’elle atteigne un statut final.
Un statut final peut encore changer si un remboursement est effectué plus tard : une transaction COMPLETED passe alors à REFUNDING, puis à REFUNDED.
Statuts des paiements
Renvoyés dans paymentStatus par Récupération d’une commande de paiement.
| Statut | Signification | Action recommandée |
|---|---|---|
CREATED | La facture est créée. Volet.com n’a pas encore fini de traiter un paiement pour celle-ci. | Laissez la commande en attente. |
PROCESSING | Volet.com traite le paiement. | Laissez la commande en attente. |
COMPLETED | Le paiement est effectué et les fonds sont crédités sur votre compte. Statut final. | Marquez la commande comme payée et exécutez-la. |
FAILED | Le paiement a échoué ou sa transaction a été annulée. Statut final. | N’exécutez pas la commande. |
paymentStatus n’a pas de valeur pour les remboursements. Un remboursement apparaît dans transaction.status et dans invoice.invoiceStatus.
À l’expiration de la facture, paymentStatus ne passe pas à FAILED de lui-même : le client peut encore envoyer un paiement après l’expiration.
Statuts des factures
Renvoyés dans invoice.invoiceStatus par Récupération d’une commande de paiement. Servez-vous-en pour expliquer un paiement problématique, pas pour décider si la commande est payée.
| Statut | Signification |
|---|---|
NEW | La facture est créée et aucun paiement n’a encore été reçu. |
RECEIVED | Une transaction blockchain pour la facture a été reçue. Des contrôles peuvent encore être en cours : les fonds ne sont donc pas encore crédités. |
EXCHANGING | Volet.com convertit la crypto reçue dans la devise du destinataire. |
COMPLETED | La facture est traitée et les fonds sont crédités sur votre compte. |
REFUND_CONFIRMATION | Un remboursement du paiement attend une confirmation. |
REFUND_REQUESTED | Un remboursement a été demandé. |
REFUNDED | Le paiement a été renvoyé au client. |
CLOSED | La facture est clôturée. |
invoice.penalties indique en quoi le paiement reçu diffère de la facture. La liste est vide lorsque le paiement correspond :
UNDERPAYMENT— le client a envoyé moins quesenderAmount.OVERPAYMENT— le client a envoyé plus quesenderAmount. Un petit paiement excédentaire dans la tolérance autorisée n’est pas signalé.EXPIRED— le paiement est arrivé après l’expiration de la facture. Un tel paiement n’est pas crédité automatiquement.
invoice.externalStatus regroupe invoiceStatus et penalties en une seule valeur, par exemple UNDERPAYMENT_RECEIVED ou EXPIRED_PAYMENT_REFUNDED. PAYMENT_RECEIVED ne signifie pas que les fonds sont crédités. N’utilisez externalStatus que pour l’affichage.
Voir aussi
- Erreurs — format des erreurs et gestion des erreurs
- Intégration API pour accepter des paiements — le parcours de paiement complet
- Intégration API pour les paiements de masse — le parcours de paiement de masse complet