Split de pagamento e subcontas

​

Quando usar

​

Como funciona o split de pagamento

1. Cadastre o vendedor como subconta, com nome e CPF ou CNPJ.
2. Divida o pagamento com o campo data.splits ao criar uma cobrança Pix no checkout transparente. Quando o Pix é pago, cada parte vai para o saldo da subconta indicada, e o restante fica no seu saldo.
3. Pague o vendedor com o saque da subconta. O Pix sai para a chave CPF/CNPJ igual ao documento da subconta.

​

Regras das subcontas

• Um titular, uma subconta: a subconta é identificada pelo CPF ou CNPJ do vendedor. Criar de novo com o mesmo documento devolve a subconta que já existe, com o saldo atual, e ignora os outros campos. O CPF/CNPJ não pode ser o da sua loja.
• Saldo separado: o saldo das subcontas não entra no saldo da sua loja e não pode ser sacado por saque nem por Enviar Pix. Cada subconta tem saldo disponível e bloqueado.
• Extrato: no extrato da loja, cada parte enviada aparece como saída Split para subconta. Os saques das subcontas não aparecem no extrato nem em Listar saques.
• Liberação: as subcontas são liberadas conta a conta. Fale com o suporte. Sem a liberação, as rotas respondem Função não habilitada.

​

Regras do split

• Só no Pix do checkout transparente (method: "PIX").
• De 1 a 10 subcontas por cobrança, sem repetir a mesma subconta.
• Cada parte tem no mínimo 1 centavo.
• A soma das partes cabe no valor da cobrança menos a taxa. Toda cobrança Pix tem uma tarifa mínima: em cobranças de valor baixo, o espaço para o split pode ser menor que o valor menos a sua taxa percentual.
• As partes só são creditadas quando o Pix é pago. Cobrança expirada ou cancelada não credita nada.
• Reembolso e MED: o valor de um reembolso ou de uma contestação (MED) sai sempre do saldo da sua loja, mesmo quando a cobrança teve split. O que já foi creditado na subconta não volta sozinho.

​

Regras do saque da subconta

• O destino é sempre a chave Pix CPF/CNPJ igual ao documento da subconta. O vendedor precisa ter essa chave cadastrada no banco dele.
• O valor mínimo é R$ 1,00 (100). O amount sai do saldo da subconta, com a taxa incluída: o vendedor recebe amount menos platformFee.
• A taxa e os limites diário e noturno são os da sua conta, e os saques das subcontas contam no mesmo limite diário. Veja Saques.
• Cada subconta faz um saque a cada 30 segundos. Subcontas diferentes podem sacar em sequência, e o saque de uma subconta não trava o saque da sua loja.
• Enquanto a sua conta tiver débito de contestação em aberto, ele é descontado do saldo disponível para saque das subcontas.
• Se o envio falhar, o valor volta para o saldo da subconta.

​

Permissões

​

Pelo dashboard

​

Pela API

{
  "name": "João da Silva",
  "taxId": "111.444.777-35",
  "externalId": "vendedor-42",
  "metadata": { "loja": "centro" }
}

{
  "method": "PIX",
  "data": {
    "amount": 10000,
    "splits": [
      { "subAccountId": "sacc_9f8Kq2LmX4vTzR7pWn3bYc1H", "amount": 7000 },
      { "subAccountId": "sacc_2Hq7Lm9XpR4vTzK8sWn3bYc5", "amount": 1500 }
    ]
  }
}

{
  "id": "sacc_9f8Kq2LmX4vTzR7pWn3bYc1H",
  "amount": 7000,
  "externalId": "repasse-vendedor-42-out",
  "description": "Repasse de outubro"
}

​

Notificações

​

Testar no Modo Teste

​

Perguntas frequentes