Checkout Sessions
Sessões de checkout hospedado criadas pelo seller.
- post
/v1/checkout-sessions— Criar sessão de checkout
/v1/checkout-sessionsCriar sessão de checkout (createCheckoutSession)
Cria uma sessão de checkout hospedado de uma oferta active (ttl_minutes de 5 a 1440, padrão 30). O client_secret é exibido só na primeira resposta; um replay devolve a sessão com secret_already_revealed: true. Repetir a requisição com a mesma Idempotency-Key e o mesmo corpo devolve a mesma resposta com idempotent-replayed: true; corpo diferente → 409 IDEMPOTENCY_CONFLICT.
- Autenticação: API key (
sk_test_...) ou sessão do app do seller - Escopos:
offers:read - URL:
https://api.v2.wolfpayteste.online/v1/checkout-sessions
Parâmetros
| Nome | Onde | Tipo | Detalhes |
|---|---|---|---|
Idempotency-Keyobrigatório | cabeçalho | string | Chave escolhida pelo cliente (8 a 255 caracteres). Mesma chave + mesmo corpo = mesma resposta; corpo diferente = 8 a 255 caracteres |
wolf-organization-id | cabeçalho | string | Só para sessão do app do seller com mais de uma organização (senão Padrão |
Corpo da requisição
Objeto CreateCheckoutSessionRequest
| Campo | Tipo | Detalhes |
|---|---|---|
offer_id obrigatório | string | Começa com |
ttl_minutes | integer | de 5 a 1440 |
{
"offer_id": "off_1b2c3d4e5f60718293a4b5c6d7e8f901",
"ttl_minutes": 30
}Resposta 201
Sessão criada (ou replay sem o segredo).
Um destes formatos:
{
"id": "cs_2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f",
"offer_id": "off_1b2c3d4e5f60718293a4b5c6d7e8f901",
"amount_minor": "9900",
"currency": "BRL",
"status": "open",
"payment_intent_id": null,
"expires_at": "2026-11-06T12:30:00.000Z",
"client_secret": "csec_EXEMPLO_segredo_de_uso_unico_da_sessao"
}