Pago masivo

La API no tiene un endpoint de lote: envías un pago por línea, una salida a la vez por empresa, con una clave derivada de cada línea.

PasosCopiar enlace

1. Verifica saldo con GET /v1/balances.
2. Para cada línea, calcula la clave: lote-2026-11-pago-0001.
3. Crea el pago. Si responde 409 payment_in_flight, espera y repite con la misma clave.
4. Guarda el pay_ junto a tu línea.
5. Sigue los estados por webhook o con GET /v1/payments.

Si tu proceso se cae a la mitad, vuelve a correr todo el lote: las líneas ya enviadas devuelven su respuesta original con Idempotent-Replayed: true.

RitmoCopiar enlace

Respeta 5 escrituras por segundo por llave. Sólo hay una salida de dinero en vuelo por empresa, así que paralelizar no acelera.

Errores comunesCopiar enlace

• Claves generadas al azar: un reinicio paga dos veces.
• Detener el lote por un 422 en una línea. Regístralo y sigue.

Qué sigueCopiar enlace

Conciliar.

Ver esta página en Markdown