Quando a subconta não possui acesso à interface do Asaas, como nas operações BaaS, o envio de documentos é feito pela integração. A consulta de documentos pendentes indica, para cada grupo de documentos, se o envio deve ser feito pelo link de onboarding (onboardingUrl) ou diretamente pela API. Se o grupo não tiver onboardingUrl, inclusive após uma rejeição, o documento deve ser enviado ou reenviado pela API.
Passo a passo para identificar e reenviar um documento rejeitado:
1. Utilize a Chave de API da própria subconta para fazer as requisições. Os endpoints de documentos são da conta autenticada, por isso a Chave de API da conta-pai não deve ser usada nesse fluxo.
2. Consulte os documentos em GET /v3/myAccount/documents.
3. Localize o grupo com status REJECTED (ou NOT_SENT) e verifique se o campo onboardingUrl está preenchido. Confira também a description do grupo, que indica o que deve ser enviado, e o campo rejectReasons, que informa o motivo da rejeição da conta.
4. Se o grupo não tiver onboardingUrl, envie o novo arquivo em POST /v3/myAccount/documents/{id}, usando o ID do grupo de documentos e informando os campos documentFile e type. O novo envio substitui o arquivo anterior, que deixa de ser considerado na análise.
5. Se preferir substituir um arquivo específico que já foi enviado, utilize POST /v3/myAccount/documents/files/{id}, usando o ID do arquivo (e não o ID do grupo).
6. Acompanhe a análise pelos Webhooks de situação cadastral da conta ou consulte GET /v3/myAccount/status. A conta está aprovada quando o campo general retornar APPROVED.
Se o grupo tiver onboardingUrl: então o documento deve ser enviado pelo link, e não pela API. Quando um documento enviado pelo link é reprovado, um novo link é gerado; basta consultar os documentos novamente e direcionar o titular para o link atualizado, observando a data de expiração em onboardingUrlExpirationDate.
Informações complementares:
Status dos documentos: os grupos podem retornar
NOT_SENT,PENDING,APPROVED,REJECTEDouIGNORED. Os arquivos enviados retornamNOT_SENT,PENDING,APPROVEDouREJECTED.Documentos adicionais: se o Asaas solicitar outros documentos durante a análise, eles aparecem como grupos do tipo
CUSTOM, com a orientação no campodescription.Envio recebido não significa aprovação: o retorno de sucesso confirma apenas o recebimento do arquivo. A análise cadastral pode levar até 48 horas.
Subconta recém-criada: aguarde pelo menos 15 segundos após a criação antes de consultar os documentos pendentes, para que as validações cadastrais sejam concluídas.
Chave de API da subconta perdida: o valor de uma chave não pode ser recuperado. Em operações BaaS, a conta-pai pode gerar uma nova chave para a subconta pelo Gerenciamento de Chaves de API de Subcontas, em Integrações > Chaves de API.
Subcontas com acesso à interface (não-BaaS): o próprio titular pode enviar ou reenviar os documentos ao acessar a conta Asaas.
Para acessar a documentação completa, consulte os links a seguir:
Onboarding e envio de documentos via link: https://docs.asaas.com/docs/onboarding-e-envio-de-documentos-via-link
Detalhamento do fluxo de aprovação de subcontas: https://docs.asaas.com/docs/detalhamento-do-fluxo-de-aprovação-de-subcontas
Verificar documentos pendentes: https://docs.asaas.com/reference/verificar-documentos-pendentes
Enviar documentos: https://docs.asaas.com/reference/enviar-documentos
Atualizar documento enviado: https://docs.asaas.com/reference/atualizar-documento-enviado
Gerenciamento das chaves de API de subcontas: https://docs.asaas.com/docs/gerenciamento-de-chaves-de-api-de-subcontas