Subcontas e split
Uma subconta é um vendedor, parceiro ou filial que recebe parte das suas vendas. Ela fica dentro de uma conta conectada, e cada cobrança feita por essa conta pode dizer quanto vai para cada subconta. É o split: a conta divide o dinheiro sozinha quando o cliente paga, sem você transferir nada depois.
Serve para marketplace (cada loja recebe a sua parte), comissão de afiliado ou vendedor, sócio que recebe uma porcentagem e franquia que repassa para a matriz.
Quais contas fazem
| Conta | Como a subconta recebe | Cadastro do titular | Split em |
|---|---|---|---|
| Pagar.me | na conta bancária do titular, por repasse automático ou saque pela SuyPay | link de prova de vida (KYC) | Pix, boleto e cartão |
| Asaas | numa conta Asaas própria, com login e app | link de envio de documentos | Pix, boleto e cartão |
| Woovi | num saldo que sai de uma vez para a chave Pix do titular | não precisa | Pix |
| Wyvi Pay | numa conta Wyvi do titular, sacada para a chave Pix salva na criação. Só pessoa física pela API | não precisa (CPF, e-mail, nascimento e CEP) | Pix, sobre o valor líquido |
| Pagmaster | num saldo separado dentro da sua conta, sacado para a chave Pix salva na criação | não precisa | não divide: a cobrança inteira entra na subconta (Pix e cartão) |
| Conta de teste | saldo fictício | link de teste que aprova na hora | Pix, boleto e cartão |
A Pagar.me só faz split em contas com a adquirência Pagar.me (PSP). O Asaas só cria subcontas para contas com CNPJ. Na Woovi, o recurso de subconta precisa estar liberado na conta.
Criar uma subconta
Em Subcontas → Nova subconta, escolha a conta e preencha o titular. O formulário pede só o que aquela conta exige:
- Pagar.me: e-mail, celular, data de nascimento, nome da mãe, profissão, renda mensal, endereço e a conta bancária (no mesmo CPF/CNPJ). Para empresa, também razão social, tipo, data de abertura, faturamento anual e o sócio administrador.
- Asaas: e-mail, celular, renda ou faturamento mensal e endereço; data de nascimento para pessoa física e tipo de empresa para CNPJ.
- Woovi: só o nome e a chave Pix do titular. A Woovi confere se a chave existe.
Toda subconta nova avisa seus webhooks com subaccount.created.
Situações
| Situação | Quer dizer |
|---|---|
Em cadastro (pending) |
criada, mas o titular ainda precisa concluir o cadastro ou a conta está analisando. Já recebe split; ainda não saca |
Ativa (active) |
aprovada: recebe e saca |
Recusada (refused) |
a conta não aprovou o cadastro. Não recebe split |
Bloqueada (blocked) |
suspensa ou bloqueada pela conta. Não recebe split |
Inativa (inactive) |
encerrada pela conta |
Na Pagar.me e no Asaas, abra a subconta e toque em Link de cadastro: mande o link ao titular para ele provar a identidade e enviar documentos. A situação muda sozinha quando a conta avisa (subaccount.updated); a SuyPay também confere uma vez por dia, e o botão Atualizar situação consulta na hora.
Pagmaster: a venda inteira na subconta
A Pagmaster não divide uma venda. Em vez disso, a cobrança é criada dentro da subconta e o valor todo entra no saldo dela, que paga a taxa. Na cobrança, escolha Receber numa subconta; pela API, mande uma parte só, sem amount:
{ "splits": [{ "subaccount_id": "sub_..." }] }
Dividir uma venda
Na Nova cobrança, toque em Dividir o valor com subcontas, escolha cada subconta e quanto ela recebe, em reais ou em porcentagem do valor da venda. Pela API, mande splits:
{
"method": "pix",
"amount": 10000,
"customer": { "name": "Maria Silva", "document": "12345678909", "email": "maria@email.com", "phone": "11912345678" },
"splits": [
{ "subaccount_id": "sub_loja1", "amount": 7000 },
{ "subaccount_id": "sub_afiliado", "percentage": 5 }
]
}
Regras:
- A conta principal fica com o resto e paga as taxas. As partes somam menos que o valor, e sobra o bastante para a taxa estimada. No exemplo, a conta principal fica com R$ 25,00 e paga a taxa com eles.
- Porcentagem é do valor da venda, antes das taxas, e a SuyPay guarda a parte já em centavos.
- As subcontas de uma venda são da mesma conta conectada. A cobrança vai por essa conta, sem passar pelas regras e sem troca automática de conta.
- A conta principal responde por devoluções e chargebacks. Uma devolução feita depois sai na proporção que a conta decidir.
- Chaves só cobranças não mandam
splits: split é dinheiro saindo para outra pessoa.
No link de pagamento sem forma definida, o cliente só vê as formas em que a conta faz split.
Saldo e saques da subconta
Abra a subconta para ver o saldo (Pagar.me, Asaas, Woovi) e as vendas que mandaram dinheiro para ela.
- Pagar.me: Sacar manda o valor para a conta bancária do titular. Ou ligue o repasse automático (todo dia, semana ou mês) ao criar a subconta.
- Woovi: Sacar manda o saldo inteiro para a chave Pix do titular.
- Asaas: o titular saca pelo app ou site do Asaas, com o login da subconta.
O saque da subconta só vai para o destino dela, cadastrado na conta ao criar. Ninguém escolhe outro destino pela SuyPay, por isso ele não conta no limite de 24 horas dos saques. Pela API, ele precisa de Saques pela API ligado, como qualquer saque, e de uma Idempotency-Key.
Pela API
Veja Subcontas e split na referência.