Criar Sessão de Checkout
Descrição
Cria uma sessão de checkout no Stripe para processar o pagamento de licenças. Retorna uma URL para redirecionar o usuário ao checkout seguro do Stripe. O email do usuário autenticado é automaticamente vinculado ao checkout.
Verbo
POST
URL Base
https://api.soargi.com
Endpoint
/payment/checkout
Cabeçalhos
| Parâmetro | Valor |
|---|---|
| Authorization | Bearer Token |
| Content-Type | application/json |
Corpo da Requisição
{
"quantity": 1,
"promo_code": "PROMO123"
}Parâmetros do Corpo
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| quantity | integer | Não | Quantidade de licenças a comprar. Padrão: 1. |
| promo_code | string | Não | Código promocional do Stripe para aplicar desconto. |
Sucesso - 200
{
"url": "https://checkout.stripe.com/pay/cs_test_a1b2c3d4e5f6g7h8i9j0..."
}Erro - 401 (Token inválido)
{
"status": 401,
"error": "Invalid or expired token."
}Erro - 500 (Erro no Stripe)
{
"status": 500,
"error": "Stripe error message details..."
}Códigos de Resposta
- 200 - Sessão de checkout criada com sucesso
- 401 - Token inválido ou expirado
- 500 - Erro ao criar sessão no Stripe
Observações
- É necessário estar autenticado para acessar este endpoint.
- O email do usuário autenticado é automaticamente vinculado ao checkout.
- Após criar a sessão, redirecione o usuário para a URL retornada.
- URLs de sucesso e cancelamento já estão pré-configuradas no sistema.
- O código promocional deve ser criado previamente no Stripe.
- A quantidade de licenças é salva nos metadados da transação.
- O checkout aceita apenas pagamentos com cartão de crédito.