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

# Migração de v1 para v2

> Mapeie rotas legadas e pressupostos operacionais da v1 para o modelo recomendado da v2.

Use esta página para migrar de forma incremental, mantendo a v2 como estado final.

## Mapeamento de rotas

| v1                                 | substituição na v2                                                    |
| ---------------------------------- | --------------------------------------------------------------------- |
| `GET /v1/health-check`             | `GET /v2/transactions` como smoke test autenticado                    |
| `POST /pix/v1/payment`             | `POST /v2/transactions` com `method: "pix"`                           |
| `GET /pix/v1/transactions/{id}`    | `GET /v2/transactions/{id}`                                           |
| `POST /pix/v1/payment/refund/{id}` | `PUT /v2/transactions/{id}/refund`                                    |
| `POST /pix/v1/payment/withdraw`    | `POST /v2/transfers`                                                  |
| `POST /v1/business/integration`    | modelo moderno de webhook mais disciplina operacional de configuração |

## Ordem recomendada

1. Padronize credenciais e tratamento de autenticação.
2. Mova escritas de criação e reembolso para a v2.
3. Atualize consumidores de webhook para o modelo operacional da v2.
4. Deixe a documentação da v1 apenas para manutenção residual.