Sandbox

Ein Sandbox-Shop ermöglicht es Ihnen, die Zahlungsabwicklung zu testen, ohne echte Kryptowährung zu senden. Jeder Händler kann einen Sandbox-Shop haben.

Erstellen Sie einen separaten Shop mit "sandbox": true. Ein bestehender Live-Shop kann nicht in den Sandbox-Modus umgeschaltet werden.

Eine Rechnung testen

1. Erstellen Sie eine Rechnung im Sandbox-Shop mit dem Schnellstart.
2. Speichern Sie ihre id als Ihre issuance_id.
3. Simulieren Sie eine bestätigte eingehende Zahlung:

curl -X POST 'https://platform.invoise.me/api/v1/shops/{shop_id}/sandbox/simulate' \
  -H 'Authorization: Bearer ivk_...' \
  -H 'Idempotency-Key: <saved-unique-key>' \
  -H 'Content-Type: application/json' \
  -d '{"issuance_id":"<issuance-id>","kind":"transfer.confirmed","amount":"10000000"}'

Verwenden Sie den tatsächlichen Betrag der Rechnung in Basiseinheiten. Ein leerer {}-Body identifiziert keine Zahlung und schlägt fehl.

In der Sandbox kann eine Rechnung oder simulierte Übertragung höchstens 10.000 Token betragen; ein höherer Betrag gibt 400 sandbox_amount_limit zurück. Sandbox-Rechnungen und Einzahlungsadressen werden getrennt von der Produktion gezählt. Siehe Limits.

Rufen Sie den Status-Endpunkt erneut ab. Eine vollständig bezahlte Rechnung erreicht funded; Webhook-Abonnenten können transfer.confirmed erhalten. Die Simulation fügt das angeforderte Ereignis ein, nicht eine vollständige echte Blockchain-Zahlung.

Um die Schließung einer Rechnung nach der Zahlung zu simulieren, senden Sie einen neuen Idempotenzschlüssel mit:

{"issuance_id":"<issuance-id>","kind":"invoice.closed","amount":"0"}

Das testet den Zustand settled. Um Korrekturen zu testen, simulieren Sie transfer.reverted mit reference_event_id, gesetzt auf die ID des früheren Ereignisses. Verwenden Sie für jedes neue simulierte Ereignis einen anderen gespeicherten Schlüssel.

Einen sauberen Test starten

POST /api/v1/shops/{shop_id}/sandbox/reset löscht den Sandbox-Zahlungsverlauf. Es erfordert eine Inhaber-Sitzung, eine frische MFA, falls aktiviert, und einen Idempotency-Key.

Alte Idempotenzschlüssel behalten ihre ursprünglichen Ergebnisse nach dem Zurücksetzen. Verwenden Sie neue Schlüssel für neue Testzahlungen.

Vor der Annahme echter Zahlungen

Die Sandbox prüft Ihre API und Ereignisverarbeitung. Sie belegt keine echten Netzwerkbestätigungen, Gaskosten oder den Eingang bei einer Börse. Testen Sie eine kleine echte Zahlung separat, bevor Sie sich auf diesen Weg verlassen.