Status

Der Lebenszyklus einer Operation, vom Klick bis zur Abrechnung.

Status	Endgültig	Bedeutung
initiated	nein	Angelegt; der Zahler hat noch nicht gehandelt
pending	nein	Der Zahler hat gehandelt; Bestätigung des Rails steht aus
success	ja	Eingezogen — die Mittel sind Ihrem Guthaben gutgeschrieben
failed	ja	Beim Rail abgelehnt oder fehlgeschlagen
cancelled	ja	Storniert (vom Zahler oder von Ihnen) vor dem Einzug
expired	ja	Der Link oder die Zahlungssitzung ist ohne Handlung abgelaufen

Regeln

• Ein endgültiger Status ändert sich nie wieder. success wird nicht zu failed; ein beanstandeter Einzug erzeugt eine neue Ressource (Rückerstattung, Streitfall), nie eine Umschreibung der Historie.
• pending kann dauern — manche Zahler bestätigen ihren USSD-Code erst Minuten später. Behandeln Sie pending niemals als Fehlschlag.
• Der Übergang, der Sie interessiert, kommt per Webhook; das Lesen (GET /v1/payments/{id}) ist das Sicherheitsnetz, nicht der Hauptmechanismus.

Leiten Sie Ihren Zustand nicht aus unserem ab

Ein Status beschreibt unsere Operation. Was aus Ihrer Bestellung werden soll, ist Ihre Entscheidung: ein success heißt nicht »versenden«, es heißt »die Mittel sind bei Ihnen«. Führen Sie Ihre eigene Zustandsmaschine und bewegen Sie sie anhand der Ereignisse, nicht umgekehrt.