Splits (reparto)
Documentación de la API · Zypher Global
Introducción
Autenticación
Sandbox
Cobro PIX (BRL)
Cobro SPEI (MXN)
Cobro USDT
Retiro PIX (clave)
Retiro BR Code
Retiro SPEI (MXN)
Retiro USDT
Splits (reparto)
Consultar Saldo
Convertir Moneda
Consultar Transacciones
Webhooks
Manejo de errores
Los splits reparten automáticamente una parte del valor neto de un cash-in a otras cuentas de la plataforma. Envía el campo splits en el cuerpo del cash-in, funciona en todas las monedas habilitadas, y en los DOS modos (dinámico por valor Y clave/CLABE fija de valor abierto).
Cómo enviar
"splits": [
{ "username": "usuario1", "percentage": 10 },
{ "username": "usuario2", "percentage": 5 }
]
Reglas
- Cada ítem tiene
username(usuario destino en la plataforma) ypercentage(porcentaje sobre el neto). - La suma total de los porcentajes, considerando Dashboard + payload, no puede superar el 90%. Si lo supera, TODOS los splits se ignoran y el 100% del neto queda en la cuenta de origen.
- Se aplican sobre el valor NETO (después de la tarifa), en el mismo instante de la confirmación del cash-in, cada destino en su propio saldo.
- El cash-out NO acepta splits (solo en la entrada).
Por moneda
- BRL — reparto en reales, en el saldo BRL del destino (neto tras la tarifa PIX).
- MXN — reparto en pesos, en el saldo MXN del destino (neto tras la tarifa SPEI).
- USDT — el reparto es sobre el USDT acreditado, en el saldo USDT del destino (aplicado cuando la entrada on-chain se confirma).
En los dos modos
- Cobro dinámico (con
amount): los splits valen solo para ESE pago. - Clave PIX / CLABE fija (sin
amount): los splits quedan VINCULADOS a la clave y se aplican en cada pago que reciba. Reenviarsplitsen una nueva llamada actualiza la regla de la clave.
La regla de cascada y el tope (90%) valen igual en los dos modos. Detalles de cada flujo en Cash In · Cobros.
¿Esta página fue útil?
