Skip to main content
SimplePay separa integraciones por tenant y ambiente. Para developers, eso se traduce en una regla simple: todo se prueba con sandbox antes de procesar live.

​
Modelo mental

​
Sandbox

Usa sandbox para:
  • Probar request bodies.
  • Conectar success_url y cancel_url.
  • Crear webhooks y verificar idempotencia.
  • Probar Bookable holds, slots y checkouts.
  • Validar policy preflight antes de habilitar live.
terminal

​
Live

Live requiere que tu integracion tenga:
  • API key live emitida para el tenant correcto.
  • Webhooks configurados en HTTPS.
  • Manejo idempotente de eventos.
  • Politicas de pago habilitadas para los productos y metodos que vas a usar.
  • Observabilidad suficiente para rastrear orden, checkout, payment intent y booking.
No cambies a live solo reemplazando la key en una app que no ha pasado por webhooks. El pago puede completarse aunque tu redirect falle.

​
Checklist antes de live

1

Revisa scopes

La key debe tener exactamente los scopes necesarios. Si la app solo crea checkouts, no necesita escribir schedules Bookable.
2

Prueba idempotencia

Repite la misma solicitud con el mismo Idempotency-Key y verifica que no duplica orden, hold, booking o refund.
3

Prueba webhooks duplicados

Tu handler debe aceptar el mismo event ID mas de una vez sin repetir side effects.
4

Guarda referencias

Persiste client_reference_id, IDs SimplePay, IDs de booking y event IDs.
5

Corre policy preflight

Para flujos Bookable o productos regulados, usa /v1/payment-policy/evaluate o preflight Bookable.

​
Variables recomendadas

.env
Nombra tus idempotency keys con el ID de tu sistema: order_123_checkout_v1, booking_456_refund_v1, customer_platform_abc_sync_v1.
Last modified on June 21, 2026