Documentación / Primeros pasos

Sandbox

Una instancia independiente de Coinetic sin redes reales. La API, las firmas, la página de pago, los estados y los webhooks con reintentos funcionan igual que en producción; lo único simulado son los pagos.

Qué	Dirección
API	`https://sandbox.coinetic.money`
Panel	https://sandbox.coinetic.money/merchant

Las claves del sandbox y las de producción son distintas. Una clave del sandbox no funciona en producción, ni viceversa.

Pagos de prueba con botones

En la página de pago del sandbox, una vez elegida la moneda, aparece el bloque «Sandbox: pago de prueba»:

Botón	Qué ocurre
Pagar importe exacto	Pago por el importe total: `detected` al instante y `paid` a los ~3 s
Pago insuficiente 10 %	90 % del importe → `underpaid`
Pagar el resto	(tras un pago insuficiente) el resto → `paid`
Sobrepago 10 %	110 % → `overpaid`
Mitad del importe	50 %; púlselo otra vez y la segunda mitad → `paid`

Pagos de prueba desde tests automatizados

Los mismos escenarios, mediante una solicitud. El token forma parte de checkout_url, tras #t=. La moneda ya debe estar elegida (en la página o con POST /v1/invoices/{id}/select y el mismo token).

HTTP

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

{"scenario": "exact"}

Valores de scenario: exact, underpay, overpay, half, rest.

En el sandbox, un reembolso se ejecuta con un solo comando: POST /v1/refunds/{id}/simulate (más detalles en la sección «Reembolsos»).

Diferencias con producción

Las facturas y los webhooks llevan livemode: false. Su tienda en producción debe rechazar esas facturas y eventos: así, un sandbox conectado por error no entregará la mercancía.
Los webhooks y return_url pueden apuntar a http://localhost y http://127.0.0.1. Las direcciones públicas, solo con https:// y puerto 443, como en producción.
La verificación AML siempre sale «limpia».
Los tipos de cambio de los activos volátiles son reales, obtenidos de los exchanges.

Qué probar antes de pasar a producción

Pago exacto, pago insuficiente con pago complementario, sobrepago y dos mitades.
Factura vencida: una factura nueva para el mismo pedido.
Un webhook falsificado o caducado se rechaza; un webhook repetido no duplica la entrega.
Rotación del secreto del webhook y cambio de la clave de API sin interrupciones.