Pede a exclusão de uma sub-conta (a Selectwin analisa e executa)
POST
/v1/marketplace/sub-accounts/{companyId}/closure-requestAutentique com o header SelectKey: a chave sk_test_ opera no sandbox, a sk_live_ em produção. Como autenticar.
Parâmetros do caminho
companyIdstringobrigatórioIdentificador público (bus_…)
Corpo da requisição
reasonstringobrigatórioPor que a empresa está sendo encerrada
Respostas
200Sucesso
idstringobrigatórioIdentificador público (clo_…)
reasonstringobrigatórioPor que o encerramento foi pedido.
statusstringobrigatóriorequested(aguardando a Selectwin),running,completed,blocked,failed,rejectedoucanceled(você desistiu).Valores:requestedrunningcompletedblockedfailedrejectedcanceledblockersobject[]obrigatórioO que precisa ser resolvido antes de o encerramento poder rodar — reavaliado a cada leitura.
+2 campos de
blockersdetailstringobrigatórioDetalhes, em texto.
reasonstringobrigatórioO que bloqueia o encerramento (ex.: um saldo a liquidar, uma cobrança em andamento).
createdAtstringobrigatóriopode ser nuloQuando o recurso foi criado (ISO 8601, UTC).
decidedAtstringobrigatóriopode ser nuloQuando a Selectwin decidiu;
nullaté lá.decisionNotestringobrigatóriopode ser nuloPor que a Selectwin recusou;
nullnos demais casos.
400Requisição inválida (validação)
errorobjectobrigatório+8 campos de
errorcodestringobrigatórioparamsobject[]statusstringobrigatóriodetailsstringmessagestringobrigatóriocategorystringobrigatórioValores:validationauthenticationauthorizationpaymentclientserverrate_limitpendingresourcestringobrigatóriostatusCodeintegerobrigatório
401Não autenticado (credencial ausente ou inválida)
errorobjectobrigatório+8 campos de
errorcodestringobrigatórioparamsobject[]statusstringobrigatóriodetailsstringmessagestringobrigatóriocategorystringobrigatórioValores:validationauthenticationauthorizationpaymentclientserverrate_limitpendingresourcestringobrigatóriostatusCodeintegerobrigatório
403Sem permissão
errorobjectobrigatório+8 campos de
errorcodestringobrigatórioparamsobject[]statusstringobrigatóriodetailsstringmessagestringobrigatóriocategorystringobrigatórioValores:validationauthenticationauthorizationpaymentclientserverrate_limitpendingresourcestringobrigatóriostatusCodeintegerobrigatório
404Não encontrado
errorobjectobrigatório+8 campos de
errorcodestringobrigatórioparamsobject[]statusstringobrigatóriodetailsstringmessagestringobrigatóriocategorystringobrigatórioValores:validationauthenticationauthorizationpaymentclientserverrate_limitpendingresourcestringobrigatóriostatusCodeintegerobrigatório
409Conflito (idempotência ou estado)
errorobjectobrigatório+8 campos de
errorcodestringobrigatórioparamsobject[]statusstringobrigatóriodetailsstringmessagestringobrigatóriocategorystringobrigatórioValores:validationauthenticationauthorizationpaymentclientserverrate_limitpendingresourcestringobrigatóriostatusCodeintegerobrigatório
500Erro interno do servidor
errorobjectobrigatório+8 campos de
errorcodestringobrigatórioparamsobject[]statusstringobrigatóriodetailsstringmessagestringobrigatóriocategorystringobrigatórioValores:validationauthenticationauthorizationpaymentclientserverrate_limitpendingresourcestringobrigatóriostatusCodeintegerobrigatório