Modo prueba (sandbox)

Cada módulo está en modo prueba o en producción; lo elegís en tu panel de comercio → Sitios → módulo. Los módulos nuevos empiezan en prueba.

• En prueba el paymentbox usa un simulador: elegís aprobar o rechazar, no se cobra dinero y no se registra ningún pago real (ni saldo ni comisiones).
• Igual se envía el webhook, con "sandbox": true y la cabecera X-Epayouts-Sandbox: 1, para que pruebes tu integración de punta a punta.
• La API responde "sandbox": true al crear el pago, y los pagos de prueba se consultan con GET /v2/payments?sandbox=true o por id.
• En prueba el sitio no necesita estar verificado; para pasar a producción, sí.
• Los pagos de prueba no se pueden devolver (409 payment_not_refundable).

Ejemplo de aviso de un pago de prueba

Cuando aprobás el pago en el simulador, tu URL de notificación recibe esto (si lo rechazás, llega igual con "event": "payment.failed" y "status": "failed"). Es el mismo formato que un pago real; lo que cambia es "sandbox": true y la cabecera X-Epayouts-Sandbox. La firma se verifica igual, con la misma clave.

POST /tu-url-de-notificacion HTTP/1.1
Content-Type: application/json
X-Epayouts-Event: payment.completed
X-Epayouts-Delivery: 5821
X-Epayouts-Signature: t=1790416800,v1=9c1f0e7a2b…
X-Epayouts-Sandbox: 1

{
  "event": "payment.completed",
  "sandbox": true,
  "code": "b7e1c2d3-4f5a-4b6c-9d8e-7f6a5b4c3d2e",
  "ucode": "TEST-1001",
  "method": "ppal",
  "effective_method": "ppal",
  "amount": "10.00",
  "currency": "EUR",
  "status": "completed",
  "created_at": "2026-09-30T10:00:00+00:00"
}