Sub-contas - Excluir (pedir o encerramento)

#Visão Geral

Excluir uma sub-conta é pedir o encerramento dela à Selectwin. O pedido abre um registro de encerramento; a Selectwin confere o que ainda prende a conta (saldo a liquidar, vendas em andamento, a janela de contestação das últimas vendas) e executa: chaves de API revogadas, cadastro no provedor de pagamento encerrado, assinaturas canceladas, webhooks desligados, domínios suspensos e a conta desativada. Até a execução, a sub-conta continua como está, e você pode desistir.

É um pedido, e não um botão, pelo mesmo motivo que vale para a sua própria conta: a API vê o que está aberto agora, mas um chargeback pode chegar semanas depois de uma venda, e uma conta já encerrada que o recebe fica com saldo negativo sem ninguém para acertar. Por isso uma pessoa fica entre a intenção e o irreversível.

#Precauções

• Só a plataforma dona da sub-conta pede o encerramento dela. Um segundo pedido com um já aberto devolve o mesmo pedido, sem erro.
• O reason fica no registro e na trilha de auditoria. O vendedor é avisado da desativação quando ela acontecer, não do motivo.
• Enquanto o pedido está requested, a sub-conta opera normalmente. Se quiser que ela pare de cobrar já, suspenda e peça o encerramento.
• Resolva os blockers antes, ou o pedido fica parado: a Selectwin não encerra uma conta com saldo a pagar ao vendedor ou vendas em andamento.
• Recurso de conta: chave sk_live_ (com sk_test_, 409 accountLevelReadOnlyInSandbox). O pedido é idempotente (X-Idempotency-Key).

#Pedir o encerramento

POST /v1/marketplace/sub-accounts/{companyId}/closure-request

#Corpo da Requisição

{ "reason": "Vendedor encerrou o contrato com a plataforma em 15/10." }

#Resposta (200 OK)

{
  "id": "clo_01hqzvclo1",
  "status": "requested",
  "reason": "Vendedor encerrou o contrato com a plataforma em 15/10.",
  "blockers": [
    { "reason": "settleableBalance", "detail": "125000 cents still owed to the seller" }
  ],
  "decisionNote": null,
  "decidedAt": null,
  "createdAt": "2026-10-17T18:00:00.000Z"
}

#Consultar o pedido

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

Devolve o pedido mais recente da sub-conta, com os bloqueadores de agora. Sem pedido nenhum, 404 closureRequestNotFound.

#Desistir

DELETE /v1/marketplace/sub-accounts/{companyId}/closure-request

Só enquanto o pedido está requested. Depois que a execução começa não há o que desistir (chaves já revogadas, assinaturas já canceladas): 409 closureRequestNotCancelable.

#Erros

#Exemplo

curl -X POST "https://api.selectwin.io/v1/marketplace/sub-accounts/bus_01hqzvsub1/closure-request" \
     -H "SelectKey: sk_live_aBcDeFgHiJkLmNoPqRsTuVwXyZ" \
     -H "Content-Type: application/json" \
     -H "X-Idempotency-Key: 8e1c…" \
     -d '{ "reason": "Vendedor encerrou o contrato com a plataforma em 15/10." }'