Sub-contas
Splits de pagamento para plataformas e marketplaces.
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": [
{ "sub_account_id": "42", "amount": 3000 },
{ "sub_account_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.