> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abacatepay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Checar Status

> Checar status do pagamento do QRCode Pix.

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

<Card horizontal>
  Requer a permissão `CHECKOUT:READ`.
</Card>

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                      |

<Tip title="Polling ou webhook?" horizontal>
  Prefira [webhooks](/pages/webhooks) a fazer polling — você recebe a confirmação em tempo real sem precisar consultar repetidamente.
</Tip>


## OpenAPI

````yaml GET /transparents/check
openapi: 3.1.0
info:
  title: API AbacatePay
  description: API para gerenciamento de cobranças e pagamentos usando o AbacatePay.
  version: 1.0.0
servers:
  - url: https://api.abacatepay.com/v2
    description: Único servidor para os ambientes de produção e sandbox.
security: []
paths:
  /transparents/check:
    get:
      summary: Checar Status
      description: Checar status do pagamento do QRCode Pix.
      parameters:
        - name: id
          in: query
          description: Identificador único do Checkout Transparente
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Status retornado
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      id:
                        type: string
                        description: Identificador único do Checkout Transparente.
                        example: pix_char_z2rSk6042t1mCKgGgeBpJe1u
                      status:
                        type: string
                        description: Informação sobre o andamento do QRCode Pix.
                        enum:
                          - PENDING
                          - EXPIRED
                          - CANCELLED
                          - PAID
                          - UNDER_DISPUTE
                          - REFUNDED
                          - REDEEMED
                          - APPROVED
                          - FAILED
                        example: PENDING
                      expiresAt:
                        type: string
                        description: Data de expiração do QRCode Pix
                        example: '2026-03-04T15:48:59.876Z'
                  error:
                    type: string
                    nullable: true
                    example: null
                  success:
                    $ref: '#/components/schemas/Success'
        '401':
          description: Não autorizado. Falha na autenticação.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: >-
                      Mensagem de erro descrevendo o motivo da falha na
                      autenticação.
                    example: Token de autenticação inválido ou ausente.
      security:
        - bearerAuth: []
components:
  schemas:
    Success:
      type: boolean
      description: Se a requisição obteve sucesso ou não.
      example: true
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >
        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](/pages/authentication).

````