Sub-contas - Suspender e reabilitar

#Visão Geral

A plataforma pode suspender uma sub-conta ativa (ela para de cobrar e de sacar) e reabilitar o que ela mesma suspendeu. É a ferramenta para um vendedor com disputas em série, um contrato encerrado ou uma investigação em curso.

Uma suspensão pela Selectwin (análise de risco ou compliance) é diferente: aparece em Andamento do cadastro com lastStatusChange.by: "staff" e só a Selectwin a desfaz.

Para encerrar a sub-conta de vez, veja Excluir: é um pedido de encerramento, executado pela Selectwin.

#Precauções

• Suspender muda o status da sub-conta para disabled: toda cobrança nova dela é recusada (inclusive as suas com onBehalfOf), os saques param, e as assinaturas dela não cobram os próximos ciclos. O saldo fica guardado.
• O vendedor é avisado (no painel e por e-mail) de que a conta foi suspensa e desde quando. O reason que você envia não vai para ele: fica no histórico da conta e na trilha de auditoria.
• Os sistemas do vendedor recebem seller.disabled e, na volta, seller.reinstated. A sua plataforma recebe os mesmos eventos, com account apontando a sub-conta.
• Só uma sub-conta active pode ser suspensa; só uma sub-conta que a sua plataforma suspendeu pode ser reabilitada por aqui.
• As duas operações são idempotentes (X-Idempotency-Key). Recurso de conta: chave sk_live_ (com sk_test_, 409 accountLevelReadOnlyInSandbox).

#Suspender

POST /v1/marketplace/sub-accounts/{companyId}/suspend

#Corpo da Requisição

{ "reason": "Três chargebacks em sete dias; contrato em revisão." }

#Resposta (200 OK)

{ "id": "bus_01hqzvsub1", "status": "disabled", "suspended": true }

#Reabilitar

POST /v1/marketplace/sub-accounts/{companyId}/reinstate

Sem corpo. A sub-conta volta a active e opera de novo na hora.

#Resposta (200 OK)

{ "id": "bus_01hqzvsub1", "status": "active", "reinstated": true }

#Erros

#Exemplo

curl -X POST "https://api.selectwin.io/v1/marketplace/sub-accounts/bus_01hqzvsub1/suspend" \
     -H "SelectKey: sk_live_aBcDeFgHiJkLmNoPqRsTuVwXyZ" \
     -H "Content-Type: application/json" \
     -H "X-Idempotency-Key: 5d2b…" \
     -d '{ "reason": "Três chargebacks em sete dias; contrato em revisão." }'