Pix
Status da cobrança
GET
/v1/charges/:chargeId/statusBase URL Produção:
https://api.validapay.com.brBase URL Sandbox:
https://sandbox.validapay.com.brAuthorizations
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órioIdentificador devolvido na criação da cobrança
Resposta enxuta para acompanhar o pagamento de uma cobrança, sem comprador, endereço, nota fiscal nem split.
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.
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}.
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
200200▾
JSON
{
"chargeId": "cha_1771453171013_fp6iocaxb",
"status": "PAID",
"amount": 10.0,
"paymentType": "PIX",
"emv": "00020101021226910014br.gov.bcb.pix…",
"paidAt": "2026-02-18T22:22:50.031Z",
"createdAt": "2026-02-18T22:19:31.013Z",
"expiresAt": "2026-03-20T23:59:59.000Z"
}