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.
| Status | Bedeutung | Endgültig |
|---|---|---|
CREATED | Die Transaktion wurde erstellt. | Nein |
READY_TO_PROCESS | Die Transaktion ist bereit zur Verarbeitung. | Nein |
PENDING | Die Transaktion wartet auf eine Aktion oder Prüfung. | Nein |
PROCESSING | Die Transaktion wird verarbeitet. | Nein |
EXCHANGING | Die Währungsumrechnung läuft. | Nein |
COMPLETED | Die Transaktion ist abgeschlossen. | Ja |
CANCELLING | Die Stornierung läuft. | Nein |
CANCELED | Die Transaktion wurde storniert. | Ja |
REFUNDING | Die Erstattung läuft. | Nein |
REFUNDED | Die 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.
| Status | Bedeutung | Empfohlene Aktion |
|---|---|---|
CREATED | Die Rechnung ist erstellt. Volet.com hat die Verarbeitung einer Zahlung dafür noch nicht abgeschlossen. | Bestellung offen lassen. |
PROCESSING | Volet.com verarbeitet die Zahlung. | Bestellung offen lassen. |
COMPLETED | Die Zahlung ist abgeschlossen, das Guthaben ist Ihrem Konto gutgeschrieben. Endgültiger Status. | Bestellung als bezahlt markieren und ausführen. |
FAILED | Die 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.
| Status | Bedeutung |
|---|---|
NEW | Die Rechnung ist erstellt, eine Zahlung ist noch nicht eingegangen. |
RECEIVED | Eine Blockchain-Transaktion für die Rechnung ist eingegangen. Prüfungen können noch laufen, daher ist das Guthaben noch nicht gutgeschrieben. |
EXCHANGING | Volet.com rechnet die erhaltene Kryptowährung in die Empfängerwährung um. |
COMPLETED | Die Rechnung ist verarbeitet, das Guthaben ist Ihrem Konto gutgeschrieben. |
REFUND_CONFIRMATION | Eine Erstattung der Zahlung wartet auf Bestätigung. |
REFUND_REQUESTED | Eine Erstattung ist beantragt. |
REFUNDED | Die Zahlung wurde an den Kunden zurückgegeben. |
CLOSED | Die 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 alssenderAmountgesendet.OVERPAYMENT— der Kunde hat mehr alssenderAmountgesendet. 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.
Siehe auch
- Fehler — Fehlerformat und Fehlerbehandlung
- API-Integration für die Zahlungsannahme — der vollständige Zahlungsablauf
- API-Integration für Massenauszahlungen — der vollständige Auszahlungsablauf