Confirmação do desafio

stable

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:

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:

ScopeDescrição
card.network.transactions.3ds.writeConcede acesso para a simulação de criação do desafio.

Cabeçalhos (Headers)

NomeDescrição
api-versionObrigatório. Versão da API. Atualmente estamos na versão 1.0.
authorizationObrigatório. Token de autorização do tipo Bearer.

Parâmetros da rota (Path)

No path desta requisição envie o seguinte campos

NomeTipoDescrição
challengeIdpathObrigató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:

NomeTipoDescrição
allowTransactionbooleanInforme TRUE para confirmar a transação e FALSE para negá-la.
documentNumberstringNú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 codeCódigoDescrição
409CONFLICTA solicitação conflitou com o estado atual do recurso existente no servidor.
409CHALLENGE_EXPIREDNão é permitido confirmar desafio expirado.
409CHALLENGE_ALREADY_COMPLETEDNão é permitido confirmar desafio já concluído.
409CHALLENGE_STILL_IN_PROCESSNã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.