Skip to main content
GET

Descripción general

Tras un pago correcto, use este extremo para confirmar que el pago se procesó y que los créditos se añadieron a la cuenta. Resulta útil como respaldo si el webhook no se procesó.
Los créditos suelen añadirse automáticamente mediante webhooks de Stripe. Este extremo permite verificación manual en casos especiales o confirmación desde el cliente.
Para integraciones de terceros: use GET /credits/verify-session/{sessionId}/api con autenticación por clave API.

Autenticación

string
requerido
Su token de acceso JWT (autenticación por sesión). Formato: Bearer YOUR_ACCESS_TOKEN

Parámetros de ruta

string
requerido
Identificador de la sesión de pago de Stripe devuelto por /credits/checkout.

Campos de respuesta

boolean
Indica si la verificación de la sesión se realizó correctamente.
integer
Cantidad de créditos correspondientes a la compra.
string
Identificador de la sesión verificada.

Respuestas de error

Solicitud incorrecta: pago no completado o metadatos de sesión no válidos.
No autorizado: token no válido o ausente.
Prohibido: la sesión no pertenece al usuario autenticado.

Idempotencia

Este extremo es idempotente. Si los créditos ya se añadieron (vía webhook), no los volverá a añadir y seguirá devolviendo éxito con la cantidad de créditos.

Flujo habitual

  1. El usuario completa el pago en Stripe
  2. Stripe redirige a su successUrl
  3. Llame a este extremo para verificar y confirmar los créditos
  4. Muestre la confirmación al usuario
  5. Actualice el saldo de créditos en su interfaz
Aunque este extremo está disponible, el flujo recomendado es escuchar los webhooks de Stripe y actualizar la interfaz en función del extremo /credits/balance.

GET /credits/verify-session//api

Este extremo verifica una sesión de pago mediante autenticación por clave API. Adecuado para integraciones de terceros.

Autenticación

Requiere autenticación por clave API. Incluya su clave en el encabezado Authorization:

Parámetros de ruta

Igual que arriba.

Respuesta

Igual que arriba.