Skip to main content
GET
/
charges
/
{chargeId}
/
status
Status da Cobrança
curl --request GET \
  --url https://api.example.com/charges/{chargeId}/status \
  --header 'Authorization: <authorization>'
{
  "id": "ch_flare_dc7dc11b7f984d2886d2b429",
  "object": "charge.status",
  "status": "pending",
  "is_paid": false,
  "is_expired": false,
  "is_failed": false,
  "paid_at": null,
  "expires_at": "2026-03-05T19:14:48.549Z",
  "created_at": "2026-03-05T18:14:48.552Z",
  "livemode": true
}

​
Descrição

Retorna apenas o status da cobrança. Ideal para polling — verificar periodicamente se um pagamento foi confirmado, sem carregar todos os dados da cobrança.
Use este endpoint em vez de GET /charges/{id} quando precisar verificar o status frequentemente. Ele é mais leve e rápido.

​
Parâmetros de Path

​
chargeId
string
required
ID da cobrança

​
Headers

​
Authorization
string
required
Bearer token de autenticação. Formato: Bearer flare_xxx

​
Exemplo de Requisição

curl https://api.flarepayments.com/v1/charges/ch_flare_dc7dc11b7f984d2886d2b429/status \
  -H "Authorization: Bearer flare_sua_chave_aqui"

​
Resposta 200 OK

​
id
string
ID da cobrança
​
object
string
Sempre "charge.status"
​
status
string
Status atual: pending, paid, expired, failed
​
is_paid
boolean
true se o pagamento foi confirmado
​
is_expired
boolean
true se a cobrança expirou
​
is_failed
boolean
true se houve falha no processamento
​
paid_at
string | null
Timestamp do pagamento (ISO 8601)
​
expires_at
string
Timestamp de expiração
{
  "id": "ch_flare_dc7dc11b7f984d2886d2b429",
  "object": "charge.status",
  "status": "pending",
  "is_paid": false,
  "is_expired": false,
  "is_failed": false,
  "paid_at": null,
  "expires_at": "2026-03-05T19:14:48.549Z",
  "created_at": "2026-03-05T18:14:48.552Z",
  "livemode": true
}