> ## 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.

# Transações

> Entenda o recurso da API que representa uma tentativa de pagamento.

Uma transação registra uma tentativa de movimentar um valor com um método de pagamento. Ela contém o valor, o método, o cliente e o estado atual.

## Pagamento e transação

Use **pagamento** para falar da experiência completa oferecida ao comprador. Use **transação** para falar do recurso retornado pela API.

Uma sessão de checkout pode conduzir o comprador por essa experiência. A transação registra o resultado do método escolhido.

## Ciclo de vida

| Estado            | O que significa                                 |
| ----------------- | ----------------------------------------------- |
| `waiting_payment` | O comprador ainda precisa concluir uma ação     |
| `processing`      | A Bob recebeu o pagamento e aguarda confirmação |
| `paid`            | O pagamento foi confirmado                      |
| `expired`         | O prazo para pagamento terminou                 |
| `cancelled`       | A transação foi cancelada                       |
| `refunded`        | O valor foi devolvido                           |

Os estados disponíveis podem variar por método. Implemente apenas os estados publicados na referência do fluxo que você usa.

## Como acompanhar

Use a consulta de status para atualizar a interface. No backend, processe os eventos de webhook como fonte de verdade.

## Próximos passos

<CardGroup cols={2}>
  <Card title="Consultar status" icon="magnifying-glass" href="/pages/pix/check-status">
    Consulte uma transação pelo identificador.
  </Card>

  <Card title="Listar transações" icon="list" href="/pages/pix/list">
    Recupere as transações do projeto.
  </Card>

  <Card title="Configurar webhooks" icon="bell" href="/pages/webhooks">
    Receba mudanças de estado automaticamente.
  </Card>

  <Card title="Evitar duplicidade" icon="rotate" href="/pages/idempotency">
    Repita operações de criação com segurança.
  </Card>
</CardGroup>