Cobranças

Status da cobrança

Resposta enxuta para acompanhar o pagamento de uma cobrança, sem comprador, endereço, nota fiscal nem split.

GET/v1/charges/:chargeId/status

Base URL Produção:https://api.validapay.com.br

Base URL Sandbox:https://sandbox.validapay.com.br

Pensada para consulta repetida: enquanto status for PENDING ou AWAITING_PAYMENT, a cobrança segue em aberto; PAID preenche paidAt. O campo expiresAt diz até quando o Pix aceita pagamento, evitando uma segunda consulta só para saber a janela.

PIX e boleto trazem emv e qrCode — a mesma imagem do detalhe, data URL PNG pronta para exibir. Cartão traz os dois null.

Valores de status: PENDING, PROCESSING, AWAITING_PAYMENT, PAID, FAILED, EXPIRED, CANCELED, ARCHIVED, DISPUTE, REFUNDED, PARTIALLY_REFUNDED e CHARGED_BACK.

Para o detalhe completo, use GET /v1/charges/{chargeId}.

Authorizations

bearer

Authorization

string obrigatório

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

Escopos requeridos

charges/read

Path Parameters

chargeIdstringobrigatório

Identificador devolvido na criação da cobrança

← Anterior

Detalhes da cobrança

Cancelar cobrança

const url = 'https://sandbox.validapay.com.br/v1/charges/:chargeId/status';

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

200▾

JSON

{
  "chargeId": "cha_1771453171013_fp6iocaxb",
  "status": "PAID",
  "amount": 10.0,
  "paymentType": "PIX",
  "emv": "00020101021226910014br.gov.bcb.pix…",
  "qrCode": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAASIAAAEiAQAAAAB1xeIbAAAB...",
  "paidAt": "2026-02-18T22:22:50.031Z",
  "createdAt": "2026-02-18T22:19:31.013Z",
  "expiresAt": "2026-03-20T23:59:59.000Z"
}

← Anterior

Detalhes da cobrança

Cancelar cobrança