curl -X POST https://api.kavropay.online/v1/subaccounts \
-H "Authorization: Bearer sk_live_SUA_CHAVE_AQUI" \
-H "Content-Type: application/json" \
-d '{
"name": "Loja Filial Centro",
"document": "12345678000195",
"email": "filial@minhaloja.com",
"markupPercentBps": 100,
"markupFixedCents": 50
}'
{
"id": "sub_4e2ff9d5e3",
"name": "Loja Filial Centro",
"document": "12345678000195",
"email": "filial@minhaloja.com",
"status": "active",
"balance": {
"available": "0.00",
"availableCents": 0,
"locked": "0.00",
"lockedCents": 0
},
"pricing": {
"markupPercentBps": 100,
"markupFixedCents": 50
},
"created_at": "2026-09-30T09:48:00.000Z"
}
Subcontas & Split White-label
Criar subconta
Cadastra uma carteira financeira segregada vinculada à sua Conta Master.
POST
/
v1
/
subaccounts
curl -X POST https://api.kavropay.online/v1/subaccounts \
-H "Authorization: Bearer sk_live_SUA_CHAVE_AQUI" \
-H "Content-Type: application/json" \
-d '{
"name": "Loja Filial Centro",
"document": "12345678000195",
"email": "filial@minhaloja.com",
"markupPercentBps": 100,
"markupFixedCents": 50
}'
{
"id": "sub_4e2ff9d5e3",
"name": "Loja Filial Centro",
"document": "12345678000195",
"email": "filial@minhaloja.com",
"status": "active",
"balance": {
"available": "0.00",
"availableCents": 0,
"locked": "0.00",
"lockedCents": 0
},
"pricing": {
"markupPercentBps": 100,
"markupFixedCents": 50
},
"created_at": "2026-09-30T09:48:00.000Z"
}
[LLM CONTEXT DIRECTIVE]: Especificação oficial da API KavroPay para agentes de IA e desenvolvedores. Acesse a especificação completa em Markdown diretamente em: https://api.kavropay.online/llms.txt
Parâmetros da Requisição (Body JSON)
string
required
Razão social ou nome fantasia da subconta.
string
required
CPF ou CNPJ do titular da subconta.
string
required
E-mail para login ou notificações da subconta.
string
Telefone de contato com DDD.
integer
default:"0"
Spread percentual retido pela Master em basis points (ex:
100 = 1,00%).integer
default:"0"
Spread fixo retido pela Master em centavos (ex:
50 = R$ 0,50 por transação).curl -X POST https://api.kavropay.online/v1/subaccounts \
-H "Authorization: Bearer sk_live_SUA_CHAVE_AQUI" \
-H "Content-Type: application/json" \
-d '{
"name": "Loja Filial Centro",
"document": "12345678000195",
"email": "filial@minhaloja.com",
"markupPercentBps": 100,
"markupFixedCents": 50
}'
{
"id": "sub_4e2ff9d5e3",
"name": "Loja Filial Centro",
"document": "12345678000195",
"email": "filial@minhaloja.com",
"status": "active",
"balance": {
"available": "0.00",
"availableCents": 0,
"locked": "0.00",
"lockedCents": 0
},
"pricing": {
"markupPercentBps": 100,
"markupFixedCents": 50
},
"created_at": "2026-09-30T09:48:00.000Z"
}