Créditos
Verificar sesión de pago
Verificar una sesión de pago completada y comprobar que los créditos se hayan añadido.
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
Su token de acceso JWT (autenticación por sesión). Formato:
Bearer YOUR_ACCESS_TOKENParámetros de ruta
Identificador de la sesión de pago de Stripe devuelto por
/credits/checkout.Campos de respuesta
Indica si la verificación de la sesión se realizó correctamente.
Cantidad de créditos correspondientes a la compra.
Identificador de la sesión verificada.
Respuestas de error
400
Solicitud incorrecta: pago no completado o metadatos de sesión no válidos.
401
No autorizado: token no válido o ausente.
403
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
- El usuario completa el pago en Stripe
- Stripe redirige a su
successUrl - Llame a este extremo para verificar y confirmar los créditos
- Muestre la confirmación al usuario
- Actualice el saldo de créditos en su interfaz
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 encabezadoAuthorization: