Documentatie / Aan de slag

Sandbox

Een aparte Coinetic-omgeving zonder echte netwerken. API, handtekeningen, betaalpagina, statussen en webhooks met retries werken net als in productie — alleen de betalingen worden gesimuleerd.

Wat	Adres
API	`https://sandbox.coinetic.money`
Dashboard	https://sandbox.coinetic.money/merchant

Sandbox- en productiesleutels zijn verschillend. Een sandboxsleutel werkt niet in productie, en omgekeerd.

Testbetalingen met knoppen

Op de betaalpagina van de sandbox staat, nadat u een valuta hebt gekozen, het blok ‘Sandbox: testbetaling’:

Knop	Wat er gebeurt
Exact betalen	Betaling van het volledige bedrag: direct `detected`, na ~3 s `paid`
Onderbetaling 10%	90% van het bedrag → `underpaid`
Restant bijbetalen	(na een onderbetaling) het restant → `paid`
Overbetaling 10%	110% → `overpaid`
Half bedrag	50%; klik nog een keer — de tweede helft → `paid`

Testbetalingen vanuit geautomatiseerde tests

Dezelfde scenario's, maar via een request. Het token is het deel van checkout_url na #t=. De valuta moet al gekozen zijn (op de pagina of met POST /v1/invoices/{id}/select en hetzelfde token).

HTTP

POST /sandbox/v1/invoices/{id}/pay
Authorization: Bearer <token uit checkout_url na #t=>
Content-Type: application/json

{"scenario": "exact"}

Waarden voor scenario: exact, underpay, overpay, half, rest.

Een terugbetaling voert u in de sandbox uit met één commando — POST /v1/refunds/{id}/simulate (meer in de sectie ‘Terugbetalingen’).

Verschillen met productie

Facturen en webhooks bevatten livemode: false. Uw productiewinkel moet zulke facturen en events weigeren — zo levert een per ongeluk gekoppelde sandbox nooit producten uit.
Webhooks en return_url mogen naar http://localhost en http://127.0.0.1 wijzen. Publieke adressen alleen via https:// en poort 443, net als in productie.
De AML-check is altijd ‘schoon’.
Koersen van volatiele assets zijn echt, afkomstig van exchanges.

Wat u test vóór de livegang

Exacte betaling, onderbetaling met bijbetaling, overbetaling, twee helften.
Verlopen factuur: een nieuwe factuur voor dezelfde bestelling.
Een vervalste of verouderde webhook wordt geweigerd; een herhaalde webhook leidt niet tot dubbele levering.
Rotatie van het webhook-secret en wissel van API-sleutel zonder downtime.