Dokumentation / Referenz

Go-live-Checkliste

Gehen Sie sie durch, bevor Sie echtes Geld annehmen. Ihre Häkchen werden nur in Ihrem Browser gespeichert.

Erledigt: 0 von 0

Sicherheit

Das Secret des API-Schlüssels liegt nur auf dem Server (Secret-Manager oder Umgebungsvariable), nicht in Git, nicht in der App und nicht im Browser.
Für die Produktion wurde ein eigener Schlüssel erstellt; Sandbox-Schlüssel werden in Produktion nicht verwendet.
Webhook: https://, öffentliche Adresse, Port 443; die Signatur wird über den rohen Body geprüft; Zeitfenster 5 Minuten.
Bestellungen werden nur bei Status paid oder overpaid aus GET /v1/invoices/{id} ausgeliefert, nicht anhand des Webhooks oder der return_url.
Die Auslieferung ist idempotent: Ein wiederholter Webhook liefert die Bestellung nicht ein zweites Mal aus.
Rechnungen und Ereignisse mit livemode: false werden abgelehnt.
Die Serveruhr ist synchronisiert (NTP).

Zuverlässigkeit

Jeder POST /v1/invoices trägt einen Idempotency-Key aus der Bestellnummer; nach einem Netzwerkfehler wird mit demselben Schlüssel wiederholt.
Der Webhook-Handler antwortet innerhalb von 10 Sekunden, aufwendige Arbeit läuft über eine Queue.
Es gibt einen Fallback-Abgleich: Bestellungen, die länger als N Minuten warten, werden über GET /v1/invoices/{id} nachgeprüft.
underpaid, expired, late_payment, manual_review und invoice.reorged werden behandelt.

Kunde

Die Bestellseite zeigt klar: Zahlung ausstehend, bezahlt, Unterzahlung, abgelaufen.
Solange die Rechnung gilt, gibt es einen Link „Zur Zahlung“ auf die checkout_url.
Die mobile App öffnet die Zahlung im System-Browser, die return_url ist ein universeller Link.
Die Regeln von App Store und Google Play für digitale Güter sind berücksichtigt.

In der Sandbox getestet

Exakte Zahlung, Unterzahlung mit Nachzahlung, Überzahlung, zwei Hälften.
Abgelaufene Rechnung: neue Rechnung für dieselbe Bestellung.
Gefälschte und veraltete Webhooks werden abgelehnt; eine Wiederholung führt nicht zu doppelter Auslieferung.
Rotation des Webhook-Secrets und Wechsel des API-Schlüssels ohne Ausfallzeit.

Alles abgehakt?Erstellen Sie den Produktionsschlüssel im Dashboard, stellen Sie baseUrl auf https://pay.coinetic.money um – und nehmen Sie die ersten echten Zahlungen an.