/sessions/{id}
Lê uma session com status, gateway, cliente e metadados. O mesmo formato chega nos webhooks session.*.
Autorização
Bearer token: a key de um app, em Apps (sk_app_live_… ou sk_app_test_…), ou a tenant key, em Settings (sk_live_… ou sk_test_…). A key define o modo: uma key live só vê dados live, uma key test só dados de sandbox.
Parâmetros
O id do recurso.
Response body
200A session.
pending: criada; processing: no checkout do gateway; paid: paga; failed: recusada; expired: abandonada; refunded: reembolsada.
Decimal com ponto, como string.
O que o gateway reembolsou até agora, no máximo amount. Igual a amount num reembolso total; menor depois de um parcial. Cada reembolso manda session.refunded de novo com o novo total.
true para os pagamentos de teste de gateway do dashboard.
A subscription a que este ciclo pertence.
A configuração que processa o pagamento.
O que o produto mandou no /connect, devolvido de volta. Os ciclos de renovação de uma subscription também trazem o metadata do checkout, mais description e billing_reason.
O seu próprio id para o cliente, como mandado no /connect.
O chargeback que o banco do cliente abriu neste pagamento, ou null. A resposta é feita no dashboard do gateway; o app recebe session.disputed quando ele abre e session.dispute_closed quando o banco decide.
O id da disputa no gateway.
O status do gateway: needs_response ou under_review enquanto aberta; won ou lost depois de fechada.
Por que o cliente contestou, como o gateway informa.
O valor retido pelo banco, decimal com ponto.
O último dia para enviar provas ao gateway.
Quando o banco decidiu; null enquanto aberta.
401Secret key ausente ou inválida.
O que deu errado.
404Recurso não encontrado para este tenant.
O que deu errado.