Splits (repasse)

Documentação da API · Zypher Global

Gerar credenciais

Splits repassam automaticamente uma parte do valor líquido de um cash-in para outras contas da plataforma. Envie o campo splits no corpo do cash-in, funciona em todas as moedas habilitadas, e nos DOIS modos (dinâmico por valor E chave/CLABE fixa de valor aberto).

Como enviar
"splits": [
  { "username": "usuario1", "percentage": 10 },
  { "username": "usuario2", "percentage": 5 }
]

Regras

  • Cada item tem username (usuário de destino na plataforma) e percentage (percentual sobre o líquido).
  • A soma total dos percentuais, considerando Dashboard + payload, não pode ultrapassar 90%. Se ultrapassar, TODOS os splits são ignorados e 100% do líquido fica na conta de origem.
  • São aplicados sobre o valor LÍQUIDO (após a taxa), no mesmo instante da confirmação do cash-in, cada destino no seu próprio saldo.
  • Cash-out NÃO aceita splits (é só na entrada).

Por moeda

  • BRL — repasse em reais, no saldo BRL do destino (líquido após a taxa PIX).
  • MXN — repasse em pesos, no saldo MXN do destino (líquido após a taxa SPEI).
  • USDT — o repasse é sobre o USDT creditado, no saldo USDT do destino (aplicado quando a entrada on-chain confirma).

Nos dois modos

  • Cobrança dinâmica (com amount): os splits valem só para AQUELE pagamento.
  • Chave PIX / CLABE fixa (sem amount): os splits ficam AMARRADOS à chave e são aplicados em cada pagamento que ela receber. Reenviar splits numa nova chamada atualiza a regra da chave.
Regra de cascata e teto (90%) valem igual nos dois modos. Detalhes de cada fluxo em Cash In · Cobranças.
Esta página foi útil?