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

# v1 to v2 Migration

> Map legacy Pagou route families and operational assumptions to the recommended v2 integration model.

Use this page to migrate incrementally while keeping v2 as the end state.

## Route mapping

| v1                                 | v2 replacement                                                    |
| ---------------------------------- | ----------------------------------------------------------------- |
| `GET /v1/health-check`             | `GET /v2/transactions` as an authenticated smoke test             |
| `POST /pix/v1/payment`             | `POST /v2/transactions` with `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`    | modern webhook handling plus operational configuration discipline |

## Recommended order

1. Standardize credentials and auth handling.
2. Move create and refund writes to v2.
3. Update webhook consumers to the v2 operating model.
4. Leave v1 docs only for long-tail maintenance.