Zum Hauptinhalt springen

Status

Die Merchant API verwendet drei Gruppen von Status: Transaktionsstatus für Auszahlungen, Überweisungen und andere Transaktionen, Zahlungsstatus für Bestellungen, die über Krypto-Rechnungen bezahlt werden, und Rechnungsstatus, die eine Krypto-Zahlung genauer beschreiben.

Transaktionsstatus​

Zurückgegeben von Transaktion abrufen und Transaktionsverlauf abrufen.

StatusBedeutungEndgültig
CREATEDDie Transaktion wurde erstellt.Nein
READY_TO_PROCESSDie Transaktion ist bereit zur Verarbeitung.Nein
PENDINGDie Transaktion wartet auf eine Aktion oder Prüfung.Nein
PROCESSINGDie Transaktion wird verarbeitet.Nein
EXCHANGINGDie Währungsumrechnung läuft.Nein
COMPLETEDDie Transaktion ist abgeschlossen.Ja
CANCELLINGDie Stornierung läuft.Nein
CANCELEDDie Transaktion wurde storniert.Ja
REFUNDINGDie Erstattung läuft.Nein
REFUNDEDDie Transaktion wurde erstattet.Ja

Betrachten Sie eine Auszahlung erst dann als abgeschlossen, wenn ihr Status COMPLETED ist. Verfolgen Sie eine Transaktion, bis sie einen endgültigen Status erreicht.

Ein endgültiger Status kann sich noch ändern, wenn später eine Erstattung erfolgt: Eine Transaktion mit COMPLETED wechselt dann zu REFUNDING und REFUNDED.

Zahlungsstatus​

Zurückgegeben in paymentStatus von Zahlungsauftrag abrufen.

StatusBedeutungEmpfohlene Aktion
CREATEDDie Rechnung ist erstellt. Volet.com hat die Verarbeitung einer Zahlung dafür noch nicht abgeschlossen.Bestellung offen lassen.
PROCESSINGVolet.com verarbeitet die Zahlung.Bestellung offen lassen.
COMPLETEDDie Zahlung ist abgeschlossen, das Guthaben ist Ihrem Konto gutgeschrieben. Endgültiger Status.Bestellung als bezahlt markieren und ausführen.
FAILEDDie Zahlung ist fehlgeschlagen oder ihre Transaktion wurde storniert. Endgültiger Status.Bestellung nicht ausführen.

paymentStatus hat keinen Wert für Erstattungen. Eine Erstattung zeigt sich in transaction.status und invoice.invoiceStatus.

Läuft die Rechnung ab, wechselt paymentStatus nicht von selbst zu FAILED: Der Kunde kann auch nach Ablauf noch eine Zahlung senden.

Rechnungsstatus​

Zurückgegeben in invoice.invoiceStatus von Zahlungsauftrag abrufen. Nutzen Sie sie, um eine problematische Zahlung zu erklären, nicht um zu entscheiden, ob die Bestellung bezahlt ist.

StatusBedeutung
NEWDie Rechnung ist erstellt, eine Zahlung ist noch nicht eingegangen.
RECEIVEDEine Blockchain-Transaktion für die Rechnung ist eingegangen. Prüfungen können noch laufen, daher ist das Guthaben noch nicht gutgeschrieben.
EXCHANGINGVolet.com rechnet die erhaltene Kryptowährung in die Empfängerwährung um.
COMPLETEDDie Rechnung ist verarbeitet, das Guthaben ist Ihrem Konto gutgeschrieben.
REFUND_CONFIRMATIONEine Erstattung der Zahlung wartet auf Bestätigung.
REFUND_REQUESTEDEine Erstattung ist beantragt.
REFUNDEDDie Zahlung wurde an den Kunden zurückgegeben.
CLOSEDDie Rechnung ist geschlossen.

invoice.penalties zeigt, worin die erhaltene Zahlung von der Rechnung abweicht. Stimmt die Zahlung überein, ist die Liste leer:

  • UNDERPAYMENT — der Kunde hat weniger als senderAmount gesendet.
  • OVERPAYMENT — der Kunde hat mehr als senderAmount gesendet. Eine kleine Überzahlung innerhalb der zulässigen Toleranz wird nicht markiert.
  • EXPIRED — die Zahlung ist nach Ablauf der Rechnung eingegangen. Eine solche Zahlung wird nicht automatisch gutgeschrieben.

invoice.externalStatus fasst invoiceStatus und penalties zu einem Wert zusammen, zum Beispiel UNDERPAYMENT_RECEIVED oder EXPIRED_PAYMENT_REFUNDED. PAYMENT_RECEIVED bedeutet nicht, dass das Guthaben gutgeschrieben ist. Verwenden Sie externalStatus nur zur Anzeige.