Flujo
Paso a paso
1
Fondea tu wallet
Mantén saldo en dólares. Consúltalo con
GET /wallets/{uuid} antes de cada lote para no rechazar pagos por saldo insuficiente.2
Consulta precio y reglas por país
GET /prices y GET /withdrawal_rules por cada destino. Las reglas cambian por país: no copies el formulario de uno a otro.3
Crea un pago por persona
POST /transactions con transactions_type: "withdrawal" y un order único por persona y por periodo. Convención sugerida:4
Informa a cada persona
Escucha
transaction.completed o transaction.denied y avisa a quien cobra. Si un pago se deniega, corrige los datos y reenvía con un order nuevo.Buenas prácticas
Para pagar en cripto en lugar de banco, usa
transactions_type: "crypto_payout" y elige la red con GET /networks (respetando withdraw_min y sumando withdraw_fee al amount).Los pagos de una cuenta se procesan en fila: lanza el lote con un timeout generoso (60–90s) y no reintentes los que siguen en curso.
Valida los datos bancarios con
POST /beneficiaries/validate_beneficiary antes del lote para bajar los rechazos.Endpoints clave
Saldo de wallet
GET /wallets/{uuid}Crear payout bancario
POST /transactions con transactions_type: "withdrawal"Crear payout cripto
POST /transactions con transactions_type: "crypto_payout"Redes cripto
GET /networks