Detalhe da subconta
GET
/api/subaccounts/{{subaccount_id}}
Autenticação
subaccounts:read. Sem a flag → 404.Detalhe da subconta
subaccounts:readbalance, pixKeys, a última submissão de KYC (kycSubmission), as taxas efetivas da subconta (fees) e o piso de taxa herdado do master (feeBase).Path param
| Param | Descrição |
|---|---|
id | ID da subconta ({{subaccount_id}}). |
Resposta
200 OK com { subaccount: {...} }. Campos:balance — available, reserved, pending em CENTAVOS.pixKeys — lista com id, type, key, status, rejectionReason, createdAt.kycSubmission — null ou { id, status, rejectionReason, createdAt, reviewedAt }.fees — taxas efetivas da subconta (pixIn, withdrawal), cada uma com type, value (% ), fixed (em REAIS).feeBase — piso de taxa herdado do master, mesmo formato de fees.deletedAt — null enquanto ativa.Sigilo (CRÍTICO): feesé a taxa cheia cobrada da subconta efeeBaseé o piso operacional. Em NENHUM lugar deste retorno aparece a comissão do master nem a decomposição da taxa — isso é assunto exclusivo do extrato do master.
Erros
| HTTP | Quando |
|---|---|
| 401 | API key ausente/inválida. |
| 403 | Escopo subaccounts:read ausente. |
| 404 | Sem a flag, subconta inexistente, de outro master, ou soft-deletada (anti-IDOR — nunca revela existência). |
Exemplo cURL
Requisição
Parâmetros Header
Respostas
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --globoff '/api/subaccounts/{{subaccount_id}}' \
--header 'Authorization: Bearer <token>'Response Response Example
200 - Sucesso (200)
{
"subaccount": {
"id": "{{subaccount_id}}",
"correlationId": "seller-001",
"name": "Loja do João LTDA",
"email": "financeiro@lojadojoao.com.br",
"taxId": "12345678000199",
"taxIdType": "CNPJ",
"phone": "11999998888",
"kycStatus": "PRE_APPROVED",
"kycSubmission": null,
"fees": {
"pixIn": {
"type": "PERCENT",
"value": 1.99,
"fixed": null
},
"withdrawal": {
"type": "FIXED",
"value": null,
"fixed": 3.5
}
},
"feeBase": {
"pixIn": {
"type": "PERCENT",
"value": 1.99,
"fixed": null
},
"withdrawal": {
"type": "FIXED",
"value": null,
"fixed": 3.5
}
},
"balance": {
"available": 125000,
"reserved": 0,
"pending": 0
},
"pixKeys": [
{
"id": "{{pix_key_id}}",
"type": "CNPJ",
"key": "12345678000199",
"status": "APPROVED",
"rejectionReason": null,
"createdAt": "2026-06-12T14:35:00.000Z"
}
],
"deletedAt": null,
"createdAt": "2026-06-12T14:30:00.000Z"
}
}Modificado em 2026-07-02 06:57:27