Modo sandbox

El modo sandbox es el entorno de prueba de Vexorpay. Te permite desarrollar y validar tu integración completa (crear links, generar checkouts, recibir webhooks y consultar cobros) sin mover dinero real: opera con cuentas y tarjetas de prueba de Stripe.

Sandbox tiene su propio dashboard

El modo sandbox vive en su propio dashboard, separado del de producción:

El dashboard de sandbox se identifica con el banner naranja Modo sandbox. Ahí conectás tu cuenta Express de prueba y ves reflejado todo lo que crees en modo de prueba: los links de pago, los cobros, los comprobantes, los movimientos y el saldo de tu cuenta de test.

Todo lo que crees vía API con sandbox: true se ve reflejado en el dashboard de sandbox. Links, cobros y comprobantes de prueba aparecen únicamente ahí, aislados de tus datos de producción. Al revés también funciona: lo que crees desde el dashboard de sandbox queda disponible para tu integración en modo de prueba.

Cómo se activa

El modo sandbox convive con la producción y se elige request a request enviando el parámetro sandbox: true en el body de los POST que crean recursos:

• POST /api/v1/payment-links — crea un link de pago de prueba.
• POST /api/v1/payment-links/{id}/checkout — genera un checkout de prueba sobre un link sandbox.
• POST /api/v1/subscriptions/{id}/cancel y POST /api/v1/subscriptions/{id}/portal — el flag va en el body.

Usás la misma API key de siempre: la distinción entre modo real y modo de prueba la hace el flag sandbox, no la clave. En la respuesta, los recursos de prueba se marcan con "sandbox": true.

curl https://api.vexorpay.com/api/v1/payment-links \
  -X POST \
  -H "Authorization: Bearer vxp_u_tu_clave" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 19,
    "title": "Ebook UX (test)",
    "reference": "TEST-CATALOGO",
    "sandbox": true
  }'

Requisito previo: cuenta Express de prueba

Antes de crear links de test, tenés que conectar una cuenta Stripe Express de prueba desde el dashboard de sandbox (dashboard.sandbox.vexorpay.com). Sin esa cuenta, la API devuelve:

{
  "error": "sandbox_account_not_ready",
  "message": "Conectá tu cuenta de prueba desde el dashboard de sandbox antes de crear links de test."
}

Los checkouts de prueba usan tarjetas de prueba de Stripe (p. ej. 4242 4242 4242 4242). Nadie paga dinero real: todo queda dentro del entorno sandbox.

Consultar los recursos de prueba por API

Los listados y consultas aceptan el filtro ?sandbox=true para leer el entorno de prueba:

GET /api/v1/payment-links?sandbox=true
GET /api/v1/charges?sandbox=true
GET /api/v1/payment-links/{id}?sandbox=true
GET /api/v1/charges/{id}?sandbox=true
GET /api/v1/charges/{id}/receipt?sandbox=true
GET /api/v1/subscriptions?sandbox=true
GET /api/v1/subscriptions/{id}?sandbox=true
GET /api/v1/balance?sandbox=true
GET /api/v1/payouts?sandbox=true
GET /api/v1/acreditaciones?sandbox=true
GET /api/v1/events?sandbox=true

En payment-links, charges, subscriptions y payouts, si omitís sandbox la respuesta incluye ambos entornos; en balance, acreditaciones y events el default es el entorno de producción (sandbox: false).

Los entornos no se mezclan: un checkout de prueba solo funciona contra un link de prueba, y viceversa. El modo sandbox es un entorno de desarrollo:

• Nunca habilites sandbox: true en el flujo real de tu aplicación.
• Los datos de sandbox no generan cobros, retiros ni acreditaciones reales.
• Cuando tu integración esté lista, creá el mismo recurso sin el flag para pasar a producción.