Redirección y regreso
Al terminar esta página sabrás qué parámetros trae la URL de regreso y por qué nunca debes usarla para marcar una obligación como pagada.
Ir al checkout
Sección titulada «Ir al checkout»Redirige el navegador del pagador a checkout_url, tal como la devolvió
POST /v1/checkout-sessions (ver Sesiones de checkout). Neat aloja
toda la experiencia de pago ahí: inicio de sesión del pagador, selección de tarjeta y confirmación. Tu
servidor no participa en esa parte del flujo ni recibe datos de tarjeta.
Regreso al comercio
Sección titulada «Regreso al comercio»Al terminar, con pago exitoso, con error o porque el pagador salió sin pagar, Neat redirige el
navegador a la URL registrada bajo tu return_id, con estos parámetros de consulta:
https://comercio.example/regreso?session_id=cs_164596add1a3&status=pagado&payment_status=succeeded&payment_id=pay_3ac4efd9f068| Parámetro | Siempre presente | Valores |
|---|---|---|
session_id |
Sí | El identificador de la sesión. |
status |
Sí | abortado o pagado. |
payment_status |
Sí | not_started, pending, failed, succeeded. |
payment_id |
Solo si ya existe un intento de cobro | El pago más reciente de la sesión. |
status: "pagado" significa que, al momento de la redirección, la sesión tenía un pago confirmado
(succeeded, partially_refunded o refunded). En cualquier otro caso (el pagador salió antes de
pagar, el intento falló o quedó pending) el valor es abortado; usa payment_status para
distinguir esos tres casos.
Ejemplos:
https://comercio.example/regreso?session_id=cs_164596add1a3&status=pagado&payment_status=succeeded&payment_id=pay_3ac4efd9f068https://comercio.example/regreso?session_id=cs_5b05557c4a90&status=abortado&payment_status=not_startedPor qué el regreso no confirma el pago
Sección titulada «Por qué el regreso no confirma el pago»La redirección es para mostrar una pantalla al pagador; no es prueba de cobro. El navegador puede cerrarse antes de completar la redirección, el parámetro puede perderse en un proxy, y nada impide que alguien arme esa misma URL a mano. Antes de marcar una obligación como pagada, confirma con una de estas dos fuentes:
- El webhook
payment.succeeded, verificado por firma, ver Webhooks: eventos y firma y Verificar la firma. GET /v1/checkout-sessions/{sessionId}, ver Sesiones de checkout.
Si el pagador cierra la página antes de volver a tu sitio, el cobro sigue su curso del lado de Neat: consulta la sesión o espera el webhook, no le pidas al pagador que repita el pago.