Sandbox

Una tienda sandbox te permite probar la gestión de pagos sin enviar cripto real. Cada comercio puede tener una tienda sandbox.

Crea una tienda aparte con "sandbox": true. Una tienda en producción existente no se puede pasar a modo sandbox.

Prueba una factura

1. Crea una factura en la tienda sandbox siguiendo la guía de inicio rápido.
2. Guarda su id como tu issuance_id.
3. Simula un pago entrante confirmado:

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"}'

Usa el importe real de la factura en unidades base. Un cuerpo {} vacío no identifica un pago y fallará.

En sandbox, una factura o transferencia simulada puede ser de como máximo 10,000 tokens; un importe mayor devuelve 400 sandbox_amount_limit. Las facturas y direcciones de depósito de sandbox se cuentan por separado de las de producción. Consulta Límites.

Consulta de nuevo el endpoint de estado. Una factura totalmente financiada llega a funded; los suscriptores de webhooks pueden recibir transfer.confirmed. La simulación inserta el evento solicitado, no un pago real completo en la cadena.

Para simular el cierre de la factura tras la financiación, envía una clave de idempotencia nueva con:

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

Eso prueba el estado settled. Para probar correcciones, simula transfer.reverted con reference_event_id definido con el ID del evento anterior. Usa una clave guardada distinta para cada nuevo evento simulado.

Empieza una prueba limpia

POST /api/v1/shops/{shop_id}/sandbox/reset elimina el historial de pagos de sandbox. Requiere una sesión de propietario, un MFA reciente si está activado, y una Idempotency-Key.

Las claves de idempotencia antiguas conservan sus resultados originales tras el reinicio. Usa claves nuevas para los nuevos pagos de prueba.

Antes de aceptar pagos reales

Sandbox comprueba tu API y el manejo de eventos. No demuestra confirmaciones reales de la red, costos de gas ni la recepción en un exchange. Prueba un pequeño pago real por separado antes de confiar en esa vía.