Codex · III

Status & Rückerstattungen

Transaktionsstatus

Jede Transaktionszeile im Dashboard hat einen dieser Status. Der Status spiegelt das jüngste Ereignis dieser Transaktion wider; Rückerstattungen und Streitfälle aktualisieren die bestehende Zeile, statt eine Geschwisterzeile einzufügen.

StatusBedeutung
succeededZahlung abgeschlossen. Geld ist auf Ihrem Konto (abzüglich Anbietergebühren).
pendingZahlung ist unterwegs. Üblich bei asynchronen Zahlungsmethoden (ACH, manche Krypto-Wege), bei denen die Bestätigung Minuten bis Stunden dauert.
failedZahlung wurde nicht abgeschlossen: Karte abgelehnt, abgelaufene Autorisierung, harte Ablehnung. Es bewegte sich kein Geld.
partialKäufer zahlte weniger als in Rechnung gestellt (üblich, wenn ein Krypto-Käufer einen um Netzwerkgebühren verringerten Betrag sendet). Der amount der Zeile spiegelt das tatsächlich Erhaltene wider; prüfen Sie metadata.invoicedAmount für das Geforderte.
refundedGeld wurde dem Käufer zurückgegeben, ganz oder teilweise. Der amount der Zeile ist der erstattete Betrag; Rückerstattungen können Tage oder Wochen nach der ursprünglichen Zahlung erfolgen.
disputedDer Käufer (oder seine Bank) hat einen Streitfall oder eine Rückbuchung eröffnet. Prüfen Sie die Oberfläche des Anbieters auf das Antwortfenster. Der metadata.reason der Zeile trägt die Einstufung des Anbieters wortwörtlich.
pending_manualEine Zahlen-per-Post-Transaktion wartet auf Ihre physische Bestätigung. Siehe den nächsten Abschnitt.
manual_canceledSie haben bei einer ausstehenden Zahlen-per-Post-Zeile Abbrechen geklickt, bevor die Zahlung des Käufers eintraf.
manual_expiredEine ausstehende Zahlen-per-Post-Zeile lag 30 Tage ohne Bestätigung und ist automatisch abgelaufen.
manual_revokedSie haben den Eingang einer Zahlen-per-Post-Zahlung bestätigt, die Bestätigung aber später rückgängig gemacht (z. B. stellte sich die Zahlung als ungültig heraus). Die Zeile geht von succeeded zurück in diesen Endzustand.

Rückerstattungen, Streitfälle, Teilzahlungen

Coin Moebius hört auf diese Anbieterereignisse und aktualisiert die ursprüngliche Transaktionszeile im Dashboard. Konkret:

  • Rückerstattungen: Stripes charge.refunded-Ereignis (vollständige oder teilweise Rückerstattungen, einschließlich amount_refunded, sodass Teilrückerstattungen den zurückgegebenen Anteil zeigen). NOWPayments refunded-IPN. Der Status der Zeile wechselt zu refunded, der amount spiegelt den erstatteten Betrag wider, und metadata.originalChargeId / metadata.originalAmount tragen den ursprünglichen Zahlungskontext.
  • Streitfälle (Rückbuchungen): Stripes charge.dispute.created-Ereignis. Der Status der Zeile wechselt zu disputed. Der vom Anbieter angegebene Grund wird wortwörtlich an metadata.reason durchgereicht, Sie können ihn in Ihrer eigenen Oberfläche darstellen, wie Sie möchten.
  • Teilzahlungen: NOWPayments partially_paid-IPN. Der Status der Zeile wechselt zu partial. Der amount spiegelt das tatsächlich Erhaltene wider (actually_paid); metadata.invoicedAmount ist das Geforderte.

In v1 werden diese Ereignisse im Dashboard und über den /status-Endpunkt angezeigt. Eine künftige Version wird E-Mail-Benachrichtigungen und einen ausgehenden Webhook-Weiterleiter hinzufügen, sodass Ihr eigenes Backend automatisch reagieren kann. Richten Sie vorerst einen kleinen Polling-Job ein (siehe den nächsten Abschnitt) oder prüfen Sie das Dashboard.

Bereit, es zu verkabeln?

Der kostenlose Tarif deckt die meisten Websites ab und verlangt nie eine Karte.