Dokumentation / Erste Schritte

Sandbox

Eine separate Coinetic-Instanz ohne echte Netzwerke. API, Signaturen, Bezahlseite, Status und Webhooks mit Wiederholungen funktionieren wie in Produktion – nur die Zahlungen werden simuliert.

Was	Adresse
API	`https://sandbox.coinetic.money`
Dashboard	https://sandbox.coinetic.money/merchant

Sandbox- und Produktionsschlüssel sind verschieden. Ein Sandbox-Schlüssel funktioniert nicht in Produktion und umgekehrt.

Testzahlungen per Button

Auf der Sandbox-Bezahlseite finden Sie nach der Wahl der Währung den Block „Sandbox: Testzahlung“:

Button	Was passiert
Exakt zahlen	Zahlung über den vollen Betrag: sofort `detected`, nach ~3 s `paid`
Unterzahlung 10 %	90 % des Betrags → `underpaid`
Rest nachzahlen	(nach einer Unterzahlung) der Rest → `paid`
Überzahlung 10 %	110 % → `overpaid`
Halber Betrag	50 %; erneut klicken – die zweite Hälfte → `paid`

Testzahlungen aus Autotests

Dieselben Szenarien per Anfrage. Das Token ist der Teil der checkout_url nach #t=. Die Währung muss bereits gewählt sein (auf der Seite oder per POST /v1/invoices/{id}/select mit demselben Token).

HTTP

POST /sandbox/v1/invoices/{id}/pay
Authorization: Bearer <Token aus checkout_url nach #t=>
Content-Type: application/json

{"scenario": "exact"}

Werte für scenario: exact, underpay, overpay, half, rest.

Eine Erstattung führen Sie in der Sandbox mit einem einzigen Aufruf aus – POST /v1/refunds/{id}/simulate (mehr dazu unter „Erstattungen“).

Unterschiede zur Produktion

Rechnungen und Webhooks tragen livemode: false. Ein Produktiv-Shop muss solche Rechnungen und Ereignisse ablehnen – so liefert eine versehentlich angebundene Sandbox keine Ware aus.
Webhooks und return_url dürfen auf http://localhost und http://127.0.0.1 zeigen. Öffentliche Adressen nur über https:// und Port 443, wie in Produktion.
Die AML-Prüfung ist immer „sauber“.
Die Kurse volatiler Assets sind echt und kommen von den Börsen.

Was Sie vor dem Start testen sollten

Exakte Zahlung, Unterzahlung mit Nachzahlung, Überzahlung, zwei Hälften.
Abgelaufene Rechnung: neue Rechnung für dieselbe Bestellung.
Gefälschte und veraltete Webhooks werden abgelehnt; ein wiederholter Webhook löst keine doppelte Auslieferung aus.
Rotation des Webhook-Secrets und Wechsel des API-Schlüssels ohne Ausfallzeit.