Skip to main content
Sub-contas permitem dividir o valor de uma transação entre múltiplos recebedores. São ideais para plataformas marketplace onde diferentes vendedores participam da mesma venda.

​
Criar sub-conta

POST /api/v1/sub-accounts — requer X-Client-ID + X-API-Key. 
POST /api/v1/sub-accounts
Content-Type: application/json
X-Client-ID: client_...
X-API-Key: sk_...

{
  "name": "Vendedor Exemplo",
  "document": "12345678000195",
  "document_type": "cnpj",
  "email": "vendedor@example.com"
}
Resposta 201: 
{
  "id": 42,
  "name": "Vendedor Exemplo",
  "document": "12345678000195"
}

​
Incluir split em um pagamento

Após criar a sub-conta, referencie seu id no campo splits ao criar um pagamento: 
{
  "merchant_order_id": "ORD-SPLIT-001",
  "amount": 10000,
  "currency": "BRL",
  "payment_method": "card",
  "customer": { ... },
  "card": { ... },
  "splits": [
    { "subaccount_id": "42", "amount": 3000 },
    { "subaccount_id": "17", "amount": 2000 }
  ]
}
O somatório dos valores em splits não precisa cobrir o amount total. A diferença fica retida na conta principal da empresa.
Splits são suportados apenas nos gateways com has_split: true (verificável via GET /api/v1/user/gateways). Transações com splits roteadas para gateways sem suporte resultarão em erro.