---
title: Sandbox
description: Die Coinetic-Sandbox: dieselbe API, Bezahlseite und Webhooks ohne echtes Geld. Testzahlungen in USDT, USDC oder Bitcoin per Button und aus Autotests.
url: https://coinetic.money/de/docs/sandbox/
lang: de
---

# 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](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“](https://coinetic.money/de/docs/refunds/)).

## 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.