.sw-reveal,.sw-reveal[data-reveal=rise]>*,.sw-scene .sw-bar,.sw-scene .sw-spark-area,.sw-scene .sw-spark-dot{opacity:1!important;transform:none!important;filter:none!important}.sw-scene .sw-spark-line{stroke-dashoffset:0!important}html:has(main>[data-theme=dark]:first-child) .sw-header[data-boot]{background:#0e0f11}

Entrar Criar conta grátis

Receber

Proteger e dividir

Entregar e medir

Por modelo de negócio

Sem site ou em rede

Gerente de conta exclusivo

Toda empresa tem um gerente de conta, para um suporte individual e humanizado.

Conhecer o gerente de conta

Construir

Operar

Para quem vende

Para quem comprou

Ouvidoria

Não resolveu no atendimento? A Ouvidoria revê o caso, com protocolo.

Abrir na Ouvidoria

Consulta uma sub-conta

GET/v1/marketplace/sub-accounts/{companyId}

Autentique com o header SelectKey: a chave sk_test_ opera no sandbox, a sk_live_ em produção. Como autenticar.

Parâmetros do caminho

companyIdstringobrigatório
Identificador público (bus_…)

Respostas

200Sucesso

idstringobrigatório
Identificador público (bus_…)
namestringobrigatório
Nome do vendedor.
planIdstringobrigatóriopode ser nulo
O plano de taxas atribuído; null quando a sub-conta usa platformFee ou nenhum.
statusstringobrigatóriopode ser nulo
Status do cadastro: pending, analyzing, awaiting-documents, active, disabled…
createdAtstringobrigatório
Quando o recurso foi criado (ISO 8601, UTC).
approvedAtstringobrigatóriopode ser nulo
Quando o cadastro foi aprovado; null quando nunca.
platformFeeobjectobrigatóriopode ser nulo
A taxa da plataforma sobre as vendas da sub-conta; null quando não há (ou quando vale um plano de taxas).
+2 campos de platformFee
- typestringobrigatório
  percentage ou flat.
  Valores:percentageflat
- valuenumberobrigatório
  O percentual (0–100) ou o valor em centavos, conforme type.
kycSubmittedAtstringobrigatóriopode ser nulo
Quando a sub-conta concluiu o cadastro e a análise começou; null enquanto ela ainda não enviou.
volume30dCentsintegerobrigatóriopode ser nulo
Vendas aprovadas da sub-conta nos últimos 30 dias, em centavos (só produção); null quando não foi possível ler.

401Não autenticado (credencial ausente ou inválida)

errorobjectobrigatório
+8 campos de error
- codestringobrigatório
- paramsobject[]
- statusstringobrigatório
- detailsstring
- messagestringobrigatório
- categorystringobrigatório
  Valores:validationauthenticationauthorizationpaymentclientserverrate_limitpending
- resourcestringobrigatório
- statusCodeintegerobrigatório

403Sem permissão

errorobjectobrigatório
+8 campos de error
- codestringobrigatório
- paramsobject[]
- statusstringobrigatório
- detailsstring
- messagestringobrigatório
- categorystringobrigatório
  Valores:validationauthenticationauthorizationpaymentclientserverrate_limitpending
- resourcestringobrigatório
- statusCodeintegerobrigatório

404Não encontrado

errorobjectobrigatório
+8 campos de error
- codestringobrigatório
- paramsobject[]
- statusstringobrigatório
- detailsstring
- messagestringobrigatório
- categorystringobrigatório
  Valores:validationauthenticationauthorizationpaymentclientserverrate_limitpending
- resourcestringobrigatório
- statusCodeintegerobrigatório

500Erro interno do servidor

errorobjectobrigatório
+8 campos de error
- codestringobrigatório
- paramsobject[]
- statusstringobrigatório
- detailsstring
- messagestringobrigatório
- categorystringobrigatório
  Valores:validationauthenticationauthorizationpaymentclientserverrate_limitpending
- resourcestringobrigatório
- statusCodeintegerobrigatório

AnteriorCria uma sub-conta sob a sua conta PróximaAtualiza uma sub-conta (taxa da plataforma)

Requisição

curl -X GET "https://api.selectwin.io/v1/marketplace/sub-accounts/{companyId}" \
  -H "SelectKey: $SELECTWIN_API_KEY"

Resposta

{
  "id": "bus_0a1b2c3d4e5f60718293",
  "name": "Acme Ltda",
  "planId": "rate_0a1b2c3d4e5f60718293",
  "status": "string",
  "createdAt": "string",
  "approvedAt": "string",
  "platformFee": {
    "type": "percentage",
    "value": 5000
  },
  "kycSubmittedAt": "string",
  "volume30dCents": 5000
}