Links de pagamento

Buscar sessão de pagamento

Retorna os dados de uma sessão de checkout ativa, como produtos disponíveis e formas de pagamento.

GET/v1/checkout-sessions/:id
Base URL Produção:https://api.validapay.com.br
Base URL Sandbox:https://sandbox.validapay.com.br

Authorizations

bearer

Authorization

string · header · required

Cabeçalho de autenticação Bearer no formato Bearer {{token}} onde {{token}} é o seu token OAuth2.

Escopos requeridos

checkouts/read

Path Parameters

NameTypeRequiredDescription
idstringRequiredID da sessão de checkout (ex: cs_xxx) - required
const url = 'https://sandbox.validapay.com.br/v1/checkout-sessions/:id';

const options = {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer {{token}}'
  },
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

Response Examples

200200
{
  "id": "cs_xxx",
  "status": "PENDING",
  "priceId": "price_xxx"
}
404404
{
    "error": {
        "message": "Sessão não encontrada",
        "code": "SESSION_NOT_FOUND",
        "details": null,
        "timestamp": "2026-07-14T21:39:36.322Z"
    }
}