EloPago API (sandbox)

API de cobranzas con distribución (split) en guaraníes. Entorno sandbox: ninguna operación mueve dinero real; los pagos y repasses los ejecuta un proveedor simulado. Montos en enteros PYG; porcentajes en puntos básicos (1 % = 100).

Especificación OpenAPI 3.1: /openapi.json · Base: /api/v1

Autenticación e idempotencia

Authorization: Bearer ep_test_xxxxxxxx_…
Idempotency-Key: 7f3c9e1a-2b4d-4c8e-9a10-5d6e7f8a9b0c

Las credenciales se crean en Configuración y API (perfil responsable). Límite: 120 solicitudes por minuto por credencial. Errores: {"error":{"code","message","fields"}}.

Crear una cobranza con distribución

curl -X POST https://elopago.com/api/v1/charges \
  -H "Authorization: Bearer $ELOPAGO_KEY" \
  -H "Idempotency-Key: alquiler-2026-10-4B" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 1000000,
    "description": "Alquiler octubre — Depto. 4B",
    "payer": { "name": "Inquilino Demo", "email": "pagos@inquilino.example" },
    "due_date": "2026-10-30",
    "split_rule": "rul_…",
    "publish": true
  }'

Endpoints

Método	Ruta	Descripción
GET	/beneficiaries	Listar beneficiarios
POST	/beneficiaries	Registrar beneficiario (queda 'incompleto' hasta su verificación)
GET	/split-rules	Listar reglas de distribución
POST	/split/simulate	Simular la distribución de un monto con una regla y la tarifa vigente
GET	/charges	Listar cobranzas
POST	/charges	Crear cobranza (borrador o publicada)
GET	/charges/{id}	Detalle con cálculo y repasses
POST	/charges/{id}/publish	Publicar un borrador (congela regla y tarifa)
POST	/charges/{id}/cancel	Cancelar
GET	/charges/{id}/reconciliation	Conciliación de la cobranza

← Volver al sitio