Confirmação do desafio

Este endpoint permite que o cliente do parceiro Bankly responda o desafio enviado para ele, confirmando ou não a sua identidade.

Pré-requisitos

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

O challengeId tenha sido obtido por meio do evento PRE_AUTHENTICATION_CHALLENGE_WAS_REQUESTED e vinculado a um desafio criado pelo parceiro;
O desafio tenha sido enviado pelo parceiro a seu cliente.

Requisição

Requisição HTTP

PATCH https://api.sandbox.bankly.com.br/card-network-transactions/authentication/challenge/{challengeId}/confirm

     --request PATCH \
     --url 'https://api.sandbox.bankly.com.br/card-network-transactions/authentication/challenge/{challengeId}/confirm' \
     --header 'accept: application/json' \
     --header 'api-version: 1' \
     --header 'authorization: Bearer {{Token}}' \
     --header 'content-type: application/*+json' \
     --data '
{
     "allowTransaction": "TRUE",
     "documentNumber": "47742663023"
}'

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:

Scope	Descrição
`card.network.transactions.3ds.write`	Concede acesso para a simulação de criação do desafio.

Cabeçalhos (Headers)

Nome	Descrição
`api-version`	Obrigatório. Versão da API. Atualmente estamos na versão 1.0.
`authorization`	Obrigatório. Token de autorização do tipo Bearer.

Parâmetros da rota (Path)

No path desta requisição envie o seguinte campos

Nome	Tipo	Descrição
`challengeId`	`path`	Obrigatório. Id recebido via webhook e que foi associado ao desafio enviado ao cliente do parceiro. No caso de sandbox, trata-se do id retornado na simulação de criação do challengeId.

Corpo da requisição (Body)

No body, envie os seguintes campos em formato JSON:

Nome	Tipo	Descrição
`allowTransaction`	`boolean`	Informe TRUE para confirmar a transação e FALSE para negá-la.
`documentNumber`	`string`	Número do documento. Informe somente números.

{
     "allowTransaction": "TRUE",
     "documentNumber": "47742663023"
}

Resposta (Response)

O status code 204 indicará sucesso no envio da confirmação.

👍
Dica
Para simular uma requisição nesse endpoint, acesse o API Reference.

Erros

Este endpoint pode retornar erros específicos, conforme a tabela a seguir:

Status code	Código	Descrição
409	CONFLICT	A solicitação conflitou com o estado atual do recurso existente no servidor.
409	CHALLENGE_EXPIRED	Não é permitido confirmar desafio expirado.
409	CHALLENGE_ALREADY_COMPLETED	Não é permitido confirmar desafio já concluído.
409	CHALLENGE_STILL_IN_PROCESS	Não é permitido confirmar desafio ainda em processamento.

Válido lembrar que a API também poderá retornar erros comuns entre todos os endpoints.

Eventos

Este endpoint não possui eventos relacionados a ele.