Créditos
Verificar sessão de checkout
Verifica uma sessão de checkout concluída e garante que os créditos foram creditados.
GET
Visão geral
Após um checkout bem-sucedido, use este endpoint para confirmar que o pagamento foi processado e os créditos adicionados à conta. Útil como alternativa caso o webhook não tenha sido processado.Os créditos normalmente são creditados automaticamente via webhooks Stripe. Este endpoint oferece verificação manual para casos extremos ou confirmação no cliente.
Para integrações de terceiros: use
GET /credits/verify-session/{sessionId}/api com autenticação por chave de API.Autenticação
Seu token de acesso JWT (auth de sessão). Formato:
Bearer YOUR_ACCESS_TOKENParâmetros de caminho
ID da sessão Stripe Checkout retornado por
/credits/checkout.Campos da resposta
Se a verificação da sessão foi bem-sucedida.
Quantidade de créditos referentes à compra.
ID da sessão verificada.
Respostas de erro
400
Requisição inválida — pagamento não concluído ou metadados de sessão inválidos.
401
Não autorizado — token ausente ou inválido.
403
Proibido — a sessão não pertence ao usuário autenticado.
Idempotência
Este endpoint é idempotente. Se os créditos já foram adicionados via webhook, não há nova inclusão; ainda assim retorna sucesso com o valor dos créditos.Fluxo típico
- Usuário conclui o checkout na Stripe
- Stripe redireciona para sua
successUrl - Chame este endpoint para verificar e confirmar os créditos
- Exiba confirmação ao usuário
- Atualize o saldo na interface