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

# Consultar status da sessão

> Endpoint PÚBLICO de polling do status da sessão (não requer autenticação; rate limit por IP de 120 req/min). Prefira webhooks para confirmação em tempo real e use este endpoint como complemento.

Use o `checkoutToken` retornado na criação para consultar o estado da sessão. Este endpoint é público e serve como complemento ao webhook; no backend, confirme o pedido pelo evento assinado `transaction.paid`.


## OpenAPI

````yaml GET /api/v1/checkout-sessions/{token}/status
openapi: 3.0.3
info:
  title: Bob Payments API
  description: >-
    API de pagamentos Bob Payments para criar, acompanhar e conciliar transações
    com PIX e cartão de crédito.
  version: 1.0.0
servers:
  - url: https://api.payments.bob.company
    description: Servidor de produção
security: []
paths:
  /api/v1/checkout-sessions/{token}/status:
    get:
      tags:
        - Checkout
      summary: Consultar status da sessão
      description: >-
        Endpoint PÚBLICO de polling do status da sessão (não requer
        autenticação; rate limit por IP de 120 req/min). Prefira webhooks para
        confirmação em tempo real e use este endpoint como complemento.
      parameters:
        - name: token
          in: path
          required: true
          schema:
            type: string
          description: O `checkoutToken` retornado na criação da sessão
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    default: true
                    type: boolean
                  data:
                    type: object
                    properties:
                      status:
                        type: string
                        enum:
                          - PENDING
                          - PAID
                          - EXPIRED
                          - CANCELLED
                          - FAILED
                          - REFUNDED
                      paidAt:
                        nullable: true
                        type: string
                    required:
                      - status
                      - paidAt
                required:
                  - success
                  - data

````