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

# Pagina y versiona tu integración

> Recorre colecciones con cursores y conserva compatibilidad con la versión de la API.

Las colecciones grandes usan paginación por cursor. Trata cada cursor como un valor opaco ligado al comercio, ambiente y filtros.

## Recorre una colección

Envía `limit` y reutiliza `next_cursor` sin modificarlo:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl -sS "$SIMPLEPAY_API_BASE/v1/payment-operations/payments?limit=25" \
  -H "Authorization: Bearer $SIMPLEPAY_API_KEY"
```

Detente cuando `has_more` sea `false`. No reutilices un cursor con otra llave, ambiente o conjunto de filtros.

## Conserva la versión

Los recursos, errores y eventos mantienen nombres estables dentro de `v1`. Un cambio incompatible requiere una nueva versión o una migración con fecha de retiro.

<Info>Los replays de webhooks conservan la semántica del evento original.</Info>