Split e subcontas

Split de pagamento é a divisão automática do valor de uma venda entre mais de um recebedor. No seu gateway white label, o split acontece entre lojistas da sua operação: quando o pagamento é confirmado, cada recebedor é creditado no próprio saldo, sem transferência manual. Você pode definir regras padrão para um lojista no painel administrativo, ou o sistema do lojista pode enviar a divisão em cada cobrança pela API.

Uma conta para cada lojista

Antes de falar de split, vale entender como a plataforma organiza o dinheiro. A plataforma mantém um ledger operacional por empresa, que registra créditos, débitos, taxas, reservas, splits, estornos e saques. Na prática, cada lojista da sua operação tem:

• saldo disponível e saldo reservado;
• transações, recebimentos e extrato;
• taxas próprias, com faixas por valor;
• status de cadastro e documentos de KYC/KYB;
• chaves de API, webhooks e logs.

No painel administrativo, você gere esses lojistas e as subcontas da operação, com acesso aos dados de cada uma, respeitando permissões e a segregação entre empresas.

Dois jeitos de configurar o split

Regra padrão no painel administrativo

Na ficha do lojista, você cadastra regras de split padrão. Cada regra tem:

• o recebedor, outra empresa da sua operação;
• o tipo, percentual ou valor fixo;
• o valor, em porcentagem ou em reais.

É o caminho para parcerias fixas, como um lojista que sempre repassa uma parte das vendas para um sócio ou um afiliado cadastrado na operação.

Split por cobrança na API

O sistema do lojista pode enviar a divisão na hora de criar a cobrança. Cada recebedor entra com o tipo e o valor:

"splits": [
  { "recipient_id": "id-do-lojista-B", "type": "PERCENTAGE", "percent": 40 },
  { "recipient_id": "id-do-lojista-C", "type": "FIXED", "amount": 1500 }
]

O tipo percentual incide sobre o valor líquido. O tipo fixo usa centavos. A soma dos percentuais não pode passar de 100%, e uma divisão inválida é recusada antes de a cobrança ser criada. Mais detalhes na página da API da sua operação.

Regras que valem para todo split

• O recebedor precisa ser uma empresa cadastrada e ativa na sua operação, diferente de quem cobra.
• O crédito acontece quando o pagamento é confirmado.
• A reserva incide só sobre o que sobra para o lojista que cobrou.
• Cada movimento fica registrado no ledger e aparece no extrato de cada parte.

Cuidados ao configurar

• Cadastre e aprove o recebedor antes. Ele precisa estar ativo na operação para receber.
• Escreva o acordo comercial. O split executa a regra; o acordo entre as partes deve estar documentado fora da plataforma.
• Revise regras padrão quando a parceria mudar. Uma regra antiga continua dividindo as vendas até ser removida.
• Teste em produção com valor baixo. O ambiente de testes não aceita split, então faça a primeira divisão real com uma cobrança pequena.

Para que serve o split numa operação white label

O split abre modelos de negócio que um gateway simples não atende:

• marketplaces, em que a venda de um vendedor é dividida com a plataforma;
• coprodução e afiliação, em que o valor é dividido entre parceiros;
• franquias e redes de unidades, em que parte de cada venda vai para a franqueadora;
• parcerias comerciais, com repasse fixo por venda.

Isso ajuda a sua operação a atrair lojistas com modelos mais complexos. Sem split, esses lojistas teriam de receber o valor cheio e fazer os repasses por conta própria, com transferências manuais, conferência de planilha e risco de erro. Com o split, cada parte vê no próprio extrato o que recebeu de cada venda. Se você ainda está desenhando o seu modelo, o guia da subadquirente white label mostra o que a operação recebe por completo.

Split no checkout e nos links

As vendas por checkout e links de pagamento entram no mesmo ledger do lojista, com as mesmas taxas e reservas. A divisão por cobrança, enviada em cada venda, é feita pela API.