Skip to main content
GET /v1/checkouts/{checkoutId}  ·  Requer o escopo checkouts:read
Busca uma sessão de checkout. Consulte este endpoint periodicamente depois de enviar o comprador para a checkout_url para ver quando o status vira completed. Se a sessão estiver open e já tiver passado do expires_at, esta chamada a marca como expired antes de retornar.

​
Parâmetros de caminho

​
string
obrigatório
O ID do checkout, ex. checkout_7f8a9b0c-1d2e-4f3a-8b4c-5d6e7f8a9b0c. Se não for um ID checkout_ válido → 400 (invalid_checkout_id).

​
Requisição

cURL

​
Resposta

200 OK com o objeto de checkout.

​
Erros

Para ser avisado sem ficar consultando, assine o webhook payment.succeeded. Ele não repete em caso de falha, então mantenha uma consulta periódica deste endpoint como reconciliação. Veja Webhooks.