.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 o status do link de credenciamento (KYC) de uma sub-conta

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

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óriopode ser nulo
O link ativo; null quando não há.
activebooleanobrigatório
Se há um link ativo.
expiresAtstringobrigatóriopode ser nulo
Quando expira; null quando não há.

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

AnteriorEnvia o passo 6 do cadastro (conclusão) pelo link de credenciamento PróximaGera (ou regenera) o link de credenciamento (KYC) de uma sub-conta

Requisição

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

Resposta

{
  "id": "kycl_0a1b2c3d4e5f60718293",
  "active": true,
  "expiresAt": "string"
}