Confirmar a autorização da conta
Fecha o passo de autorização iniciado antes. O corpo é vazio: tudo o que a confirmação precisa já está guardado do lado de cá.
Autenticação
A sessão do painel autentica esta rota, e ela é lida de forma autoritativa: não há parâmetro em que o chamador aponte para outra conta.
Esta rota não exige escopo nomeado — o que não quer dizer que ela seja aberta: sem a credencial acima ela recusa.
Exige sessão de vendedor. A conta lida e escrita é sempre a da sessão: não há campo em que o chamador escolha outra.
Parâmetros
Corpo da requisição
application/json.
{}Respostas
200 · sucesso
{
"status": {
"kind": "active"
}
}403 · proibido
Confirme a segurança da conta antes de confirmar a autorização.
409 · conflito
A autorização não pôde ser fechada: não há uma pendente, ela expirou, ou o passo não está disponível para a sua conta agora. Comece de novo por POST /kyc/bank-account/authorization.
Erros desta rota
| Status | Código | Quando | O que fazer |
|---|---|---|---|
| 409 | KYC_CONNECT_CONFIRM_REFUSED | Havia uma autorização pendente e ela não pôde ser fechada: expirou, ou foi recusada na conferência. A conta não ficou autorizada. | Comece de novo por POST /kyc/bank-account/authorization e conclua a autorização dentro do prazo em segundos que aquela resposta devolve. Repetir a confirmação sem uma autorização nova devolve o mesmo 409. |
| 409 | KYC_CONNECT_UNAVAILABLE | Não há autorização pendente para fechar. Ou nenhuma foi iniciada, ou a que existia já saiu de cena. | Inicie a autorização por POST /kyc/bank-account/authorization antes de confirmar. Repetir a confirmação sozinha devolve sempre o mesmo 409. |
| 409 | KYC_NO_ACQUIRER_MAPPED | Esta conta ainda não tem para onde a confirmação ser encaminhada. É configuração do nosso lado, e nada do que você envia altera isso. | Reporte a ocorrência a quem opera a instalação. Repetir não muda o resultado. |
| 403 | ACCOUNT_SECURITY_KYC_CLEARANCE_REQUIRED | A confirmação de segurança expirou ou foi invalidada; nada foi enviado ao adquirente. | Confirme a segurança novamente e conclua a autorização. |
Os códigos são estáveis e fazem parte do contrato. A lista completa, com todos os vocabulários, está na tabela de erros.