novidades-documentacao-25

Olá! Confira as atualizações da documentação ocorridas no mês passado! 😉

🆕 O que há de novo

Ciclo de vida do cliente

Agora, o Manual do Dev conta com uma nova página que descreve o ciclo de vida dos clientes do tipo pessoa física. Nessa nova documentação, o parceiro encontrará a descrição de todos os status que um cliente pode apresentar ao longo de seu relacionamento com o Bankly.

Multicontas

Disponibilizamos a documentação das multicontas, uma nova funcionalidade oferecida pelo Bankly que permite aos parceiros a abertura de mais de uma conta de pagamento para cada cliente (pessoa física ou pessoa jurídica), sem a necessidade de realizar um novo processo de Onboarding.

Eventos

Acrescentamos dois novos eventos na página Contas referentes ao bloqueio e desbloqueio de contas. Confira:

🚀Alterações e melhorias

Eventos

Agora, a documentação dos eventos de pagamento de contas possui fluxograma para auxiliar o nosso parceiro a compreender a sequência em que esses eventos ocorrem.

Padronização

As seguintes documentações já se encontram no novo modelo de exibição:

Seção de Reivindicação de chaves Pix;
Toda a seção de Boletos .

Onboarding

Reorganizamos a seção Onboarding do Manual do Dev. Seu objetivo, agora, é descrever os processos de Onboarding de pessoa física e jurídica. Cada etapa do processo (análise de documentos e registro do cliente) apresenta links para seus respectivos endpoints, dispostos em duas novas seções: ID One e Registro do cliente.
Na documentação Motivos de reprovação de registro, adicionamos um novo motivo que pode ocasionar a reprovação do Onboarding do cliente, o PEP_RECUSED.
Alteramos a descrição do campo countryCode, pois, agora, o Bankly permite o registro de DDIs internacionais, desde que eles não façam parte da lista de países bloqueados para Onboarding.

Headers

Devido ao ajuste no formato do token de segurança de nossas APIs, que agora é HASH, e não mais JWT, a descrição de todos os headers dos endpoints documentados passa a ser apenas: "Token de autorização do tipo Bearer."

🚧Problemas resolvidos

Gestão de contas

Nas documentações de abertura de conta do Manual do Dev, referentes à pessoa física e jurídica, assim como na documentação disponível no APIs, acrescentamos um destaque informando que o header de idempotência (Idempotency-Key) é necessário caso o cliente possua multicontas ativas, para evitar a criação de contas duplicadas.

Eventos

Na documentação do evento CUSTOMER_WAS_REVOKED, acrescentamos um destaque informando sobre a necessidade de um novo processo de Onboarding para que o cadastro seja revalidado.

Pagamento de contas

Nas documentações Validação do título e Confirmação do pagamento, foram acrescentados novos erros mapeados.

Pix

Na documentação Cancelamento de um pedido de reivindicação, corrigimos o texto que informava que apenas o doador poderia cancelar um pedido e reivindicação de chave Pix. Tanto doador quanto reivindicador podem solicitar o cancelamento de pedido de reivindicação de posse ou de portabilidade, desde que o status do pedido seja WAITING_RESOLUTION.

Atenciosamente,

Time de Tech Writers