Splits (repasse)
Documentação da API · Zypher Global
Introdução
Autenticação
Sandbox
Cobrança PIX (BRL)
Cobrança SPEI (MXN)
Cobrança USDT
Saque PIX (chave)
Saque BR Code
Saque SPEI (MXN)
Saque USDT
Splits (repasse)
Consultar Saldo
Converter Moeda
Consultar Transações
Webhooks
Tratamento de erros
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) epercentage(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. Reenviarsplitsnuma 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?
