Checar Status

Checar status do pagamento do QRCode Pix.

GET /transparents/check

Checar Status

cURL

curl --request GET \
  --url https://api.abacatepay.com/v2/transparents/check \
  --header 'Authorization: Bearer <token>'

200

{
  "data": {
    "id": "pix_char_z2rSk6042t1mCKgGgeBpJe1u",
    "status": "PENDING",
    "expiresAt": "2026-03-04T15:48:59.876Z"
  },
  "error": null,
  "success": true
}

Verifica o status atual de um checkout transparente pelo seu id.

Requer a permissão CHECKOUT:READ.

Use este endpoint para confirmar se o cliente já realizou o pagamento do QR Code. O campo status indica o estado atual:

Valor	Significado
PENDING	Aguardando pagamento
PAID	PIX recebido com sucesso
EXPIRED	QR Code expirado sem pagamento
CANCELLED	Cancelado

Prefira webhooks a fazer polling — você recebe a confirmação em tempo real sem precisar consultar repetidamente.

Authorizations

Authorization · string · header · required

Todas as requisições devem incluir sua chave de API no header Authorization usando o formato Bearer <abacatepay-api-key>. Sem esse header a requisição será rejeitada.

Saiba mais sobre como criar e usar chaves de API na documentação de autenticação.

Query Parameters

id · string · required

Identificador único do Checkout Transparente

Response

200

application/json

Status retornado

data · object

Show child attributes

error · string | null

Example:

null

success · boolean

Se a requisição obteve sucesso ou não.

Example:

true