Límites y comportamiento a tener en cuenta
Estado real de la API pública hoy. Lo que dice No está identificado como hueco; ver huecos conocidos.
| Tema | Hoy |
|---|---|
| Crear o consultar un pago por API | No. El pago nace en la página de pago; se conoce por webhook. |
Idempotency-Key en la API pública | No. Reintentar un POST puede duplicar el recurso. (La pasarela sí usa idempotencia hacia sus proveedores.) |
| Paginación | No hay paginación general en los listados. |
| Límite de peticiones (rate limit) | No para tráfico de integradores. Solo el registro anónimo tiene límite. Sé considerado con la frecuencia. |
| Versionado | Cabecera X-API-VERSION, solo 1.0, sin política de depreciación. |
| Webhooks | Entrega al menos una vez, 5 intentos, sin garantía de orden. Detalle. |
| Consultar o reenviar entregas de webhook | No. |
| Sandbox hospedado | No. Hay un entorno local. |
| Idioma de los mensajes | Español. |
Buenas prácticas mientras tanto
- Una referencia por pedido (
reference) y un link por pedido: es tu llave de conciliación. - Antes de reintentar una creación, lista tus links y busca por
reference. - Deduplica los webhooks por
idy hazlos idempotentes. - Concilia periódicamente: si un pedido sigue pendiente mucho tiempo, revisa el link y pregunta a soporte; no marques como pagado por suposición.