Referência

​

Como funciona

1. Cadastre o vendedor com Criar subconta, informando nome e CPF/CNPJ.
2. Divida o pagamento com o campo splits em Criar cobrança PIX. 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 Sacar da subconta. O PIX sai para a chave CPF/CNPJ igual ao taxId da subconta.

​

Estrutura

{
  "data": {
    "id": "sacc_9f8Kq2LmX4vTzR7pWn3bYc1H",
    "name": "João da Silva",
    "taxId": "11144477735",
    "externalId": "vendedor-42",
    "balance": {
      "available": 7000,
      "blocked": 0
    },
    "devMode": false,
    "metadata": {
      "loja": "centro"
    },
    "createdAt": "2026-10-26T14:22:10.381Z",
    "updatedAt": "2026-10-26T14:22:10.381Z"
  },
  "success": true,
  "error": null
}

​

Atributos

​

Regras

• Um titular, uma subconta: criar de novo com o mesmo CPF/CNPJ devolve a subconta que já existe, com o saldo atual. O CPF/CNPJ não pode ser o da sua loja.
• Split: só no PIX do checkout transparente, com até 10 subcontas por cobrança. A soma das partes cabe no valor da cobrança menos a taxa, e toda cobrança tem uma tarifa mínima de PIX: em cobranças de valor baixo, o espaço para o split pode ser menor do que o valor menos a sua taxa percentual. O crédito acontece quando o PIX é pago.
• Saque: sempre para a chave PIX CPF/CNPJ do titular. A taxa e os limites diários e noturnos de saque são os da sua conta, e os saques das subcontas contam no mesmo limite diário. Cada subconta pode fazer um saque a cada 30 segundos.
• Reembolso e MED: o valor de um reembolso ou de uma contestação (MED) sai sempre do saldo da sua conta, mesmo quando a cobrança teve split. O que já foi creditado na subconta não volta automaticamente.
• Débito de contestação: enquanto a sua conta tiver débito de contestação em aberto, ele é descontado do saldo disponível para saque das subcontas.
• Disponibilidade: depende do provedor de PIX da sua conta. Se ele não suportar subcontas, a criação responde com erro.

​

Permissões