Integrações server-to-server que usam PIX direto pela API podem pular a sessão e criar a transação diretamente.
O que a sessão contém
Você define a cobrança ao criar a sessão:
Em resposta, a Bob devolve o
checkoutToken, a checkoutUrl e — se você enviou webhookUrl — o webhookSecret para verificar as assinaturas. O secret aparece só nessa resposta; guarde-o.
Ciclo de vida
1
Criada
A sessão nasce com status
PENDING e uma checkoutUrl pronta para o comprador.2
Em pagamento
O comprador escolhe um método e conclui o pagamento pela
checkoutUrl ou pelo SDK.3
Concluída ou expirada
Ao pagar, a sessão gera uma transação e dispara o webhook. O link da sessão dura 24h por padrão (
expiresAt) — o PIX gerado dentro dela segue a expiração configurada no projeto.Sessão e transação
A sessão é o recurso que apresenta o pagamento ao comprador; a transação é o registro do que aconteceu. Uma sessão paga resulta em uma transação com o desfecho final (paid, expired, …).
Próximos passos
Criar sessão de checkout
Todos os campos de criação, com playground interativo.
Checkout hospedado
O fluxo completo de ponta a ponta.
Transações
O recurso que registra cada tentativa de pagamento.
Consultar status da sessão
Faça polling do estado da sessão como complemento ao webhook.