Aller au contenu principal

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.

StatutSignificationFinal
CREATEDLa transaction a été créée.Non
READY_TO_PROCESSLa transaction est prête à être traitée.Non
PENDINGLa transaction attend une action ou un contrôle.Non
PROCESSINGLa transaction est en cours de traitement.Non
EXCHANGINGLa conversion de devise est en cours.Non
COMPLETEDLa transaction est effectuée.Oui
CANCELLINGL’annulation est en cours.Non
CANCELEDLa transaction a été annulée.Oui
REFUNDINGLe remboursement est en cours.Non
REFUNDEDLa 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.

StatutSignificationAction recommandée
CREATEDLa facture est créée. Volet.com n’a pas encore fini de traiter un paiement pour celle-ci.Laissez la commande en attente.
PROCESSINGVolet.com traite le paiement.Laissez la commande en attente.
COMPLETEDLe 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.
FAILEDLe 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.

StatutSignification
NEWLa facture est créée et aucun paiement n’a encore été reçu.
RECEIVEDUne 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.
EXCHANGINGVolet.com convertit la crypto reçue dans la devise du destinataire.
COMPLETEDLa facture est traitée et les fonds sont crédités sur votre compte.
REFUND_CONFIRMATIONUn remboursement du paiement attend une confirmation.
REFUND_REQUESTEDUn remboursement a été demandé.
REFUNDEDLe paiement a été renvoyé au client.
CLOSEDLa 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 que senderAmount.
  • OVERPAYMENT — le client a envoyé plus que senderAmount. 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.