Sub-contas - Consultar
Visão Geral
Consulta uma sub-conta da sua plataforma pelo id: o status do credenciamento, a taxa (ou o plano) e o volume aprovado dos últimos 30 dias.
Requisição
HTTP
GET /v1/marketplace/sub-accounts/{companyId}| Parâmetro | Onde | Descrição |
|---|---|---|
companyId | caminho | O id da sub-conta (bus_…) |
Resposta
Sucesso (200 OK)
JSON
{
"id": "bus_01hqzvsub1",
"name": "Loja da Maria",
"status": "active",
"platformFee": null,
"planId": "rate_01hqzvplan1",
"createdAt": "2026-10-17T12:00:00.000Z",
"kycSubmittedAt": "2026-10-17T15:20:11.000Z",
"approvedAt": "2026-10-18T10:02:45.000Z",
"volume30dCents": 1250000
}Os campos estão descritos em Visão Geral.
Use status, kycSubmittedAt e approvedAt para saber em que ponto o credenciamento está:
status | kycSubmittedAt | O que significa |
|---|---|---|
pending | null | O vendedor ainda não enviou o cadastro |
pending | preenchido | O vendedor terminou, mas faltou um dado essencial e ele não entrou na análise — peça que complete pelo mesmo link |
analyzing | preenchido | Em análise |
awaiting-documents | preenchido | A análise pediu documentos de novo; a sub-conta não cobra nem saca até reenviar |
active | preenchido | Aprovada: cobra e saca. approvedAt diz desde quando |
Erros
| HTTP | error.code | Quando |
|---|---|---|
| 404 | subAccountNotFound | O id não é uma sub-conta da sua plataforma |
Exemplo
Shell
curl "https://api.selectwin.io/v1/marketplace/sub-accounts/bus_01hqzvsub1" \
-H "SelectKey: sk_live_aBcDeFgHiJkLmNoPqRsTuVwXyZ"Atualizado em 21 de outubro de 2026