Ir al contenido

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.

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.

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:

Pago confirmado
https://comercio.example/regreso?session_id=cs_164596add1a3&status=pagado&payment_status=succeeded&payment_id=pay_3ac4efd9f068
El pagador salió sin iniciar un cobro
https://comercio.example/regreso?session_id=cs_5b05557c4a90&status=abortado&payment_status=not_started

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:

  1. El webhook payment.succeeded, verificado por firma, ver Webhooks: eventos y firma y Verificar la firma.
  2. 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.