Criação Processo Selfie

Este endpoint possibilita o envio da _selfie_do cliente para dar início ao processo de Onboarding.

🚧

Importante

A selfie deve ser enviada antes das outras imagens e é preciso aguardar que ela seja aprovada antes de iniciar a captura das imagens dos documentos.

Tempo de análise das selfies

Uma pequena parcela das imagens das selfies não pode ser analisada de forma automática, devido à identificação de:

• Rostos diferentes para o mesmo CPF;
• Rostos semelhantes para diferentes CPFs;
• Pontos biométricos semelhantes a alguma pessoa já identificada como suspeita de fraude.

Nesses casos, é preciso realizar a análise manual das imagens, que fará com que o tempo de SLA de resposta aumente para até 35 minutos (em 65% dos casos retornam em até 6 minutos e em 85% retornam em até 12).

❗️

Atenção

Para aumentar as chances de aprovação no Onboarding, é preciso seguir todas as recomendações contidas na página Orientações para envio de fotos.

Pré-requisito

Para que seja possível utilizar este endpoint, é necessário que:

• O parceiro siga as orientações da documentação da Unico Webview para a captura das selfies.

📘

Nota

Recordamos que as fotos do documento deverão ser capturadas a partir da máscara do parceiro.

Requisição (Request)

Requisição HTTP

POST https://api-mtls.sandbox.bankly.com.br/documents/create-process

curl --location 'https://api-mtls.sandbox.bankly.com.br/documents/create-process' \
--header 'api-version: 1' \
--header 'Content-Type: application/json' \
--header 'x-correlation-id: correlationvalido' \
--header 'Authorization: Bearer tokenvalido' \
--header 'Cookie: __cf_bm=kmZusaqFw_RWH.vmXAgvdfsuRINXswzuJPaqpCcQLFc-1774896609.0033662-1.0.1.1-B5ASurhSHDG0e9OXcyK.xSYD2y1_Z6lfD7exyezvOavFro7F5rqVveAIsqCGH5fgjCbaBFbBkyJrCrN4LEtJG3eQhHG8dW.OlzdT4MnNlwBXWNCLCiMxZcf5ExeubGiu' \
--data '{
    "documentNumber": "xxxxx",    
    "documentType": "SELFIE",
    "documentSide": ""
}'

🚧

Importante

A selfie deverá ser enviada pela Webview. A URL do Webview é válida dentro do prazo máximo de 7 dias ou até ser utilizada.

Autorização

Para garantir a segurança nas requisições, todos os endpoints do Bankly utilizam scopes como parte do seu fluxo de autorização.
Esta requisição requer o scope descrito a seguir:

Cabeçalhos (Headers)

Corpo da requisição (Body)

No body, envie os seguintes campos em formato de formulário:

--form 'documentType="SELFIE"' \
--form 'documentNumber="01234567890"' \
--form 'documentSide=""'

Resposta (Response)

O status code 202 indicará sucesso no envio das imagens.

Sendo bem-sucedido, o retorno irá trazer o seguinte campo em formato JSON:

{
  "userRedirectUrl": "https://cadastro.dev.unico.app/process/53060f52-f146-4c12-a234-5bb5031f6f5b",
  "expiresAt": "2023-10-09T15:15:25.417105Z"
}

Erros

Este endpoint não retorna erros específicos. Porém, ele poderá retornar alguns erros comuns entre todos os endpoints.

Eventos

Caso o parceiro deseje receber mensagens referentes aos eventos relacionados a esse endpoint, é preciso configurar o webhook. Os eventos são: