La API para dispersar pagos en bolívares

Conecta tu fintech y habilita pagos en bolívares hoy, de forma simple y a la mejor tasa de cambio.

Tu primera dispersión Referencia de la API

Entregamos bolívares en Venezuela por pago móvil o por transferencia bancaria. Tres llamadas: cotizas, registras a quién se le paga y dispersas.

# 1 · Cotiza el importe exacto que quieres entregar
QUOTE=$(curl -s $BASE/v1/quotes -H "x-api-key: $KEY" -H 'content-type: application/json' \
  -d '{"deliver":{"asset":"BS","amount":5000000}}' | jq -r .id)

# 2 · Dispersa
curl -s $BASE/v1/payouts -H "x-api-key: $KEY" -H 'content-type: application/json' \
  -H "Idempotency-Key: payout-2026-0001" \
  -d '{"quoteId":"'$QUOTE'","method":"pago_movil",
       "beneficiary":{"fullName":"María Gómez","nationalId":"V12345678",
                      "bankCode":"0138","phone":"04141234567"}}'

Empieza por aquí

Tu primera dispersiónCinco curls, de la API key a bolívares entregados.

Cómo funcionaCotización, beneficiario, pago y evento: sus campos y cómo se enlazan.

Dispersar bolívaresPago móvil y transferencia, el remitente, el cambio de canal.

Estados de un pagoLos cuatro desenlaces y qué hacer con cada uno.

Lo que hay que saber antes de escribir código

`submitted` es el desenlace normal

POST /payouts devuelve submitted, no settled: la entrega es asíncrona. Diseña sobre el webhook.

El teléfono hace falta siempre

También en transferencia. El alta no lo exige, así que se puede registrar a alguien que luego no puede cobrar. Ver beneficiarios.

Dos catálogos de bancos, no uno

31 bancos alcanzables por pago móvil, 24 por transferencia. Por eso GET /payouts/banks exige method.

Mínimo y tope por operación

Por debajo de ~925 Bs no se dispersa, y el tope de pago móvil es 100.000,00 Bs. Ver límites.

Cada ejemplo de esta documentación funciona tal como está escrito contra el entorno de pruebas.