Splits (reparto)

Documentación de la API · Zypher Global

Generar credenciales

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) y percentage (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. Reenviar splits en 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?