Autenticação da transação IDPAY

Este endpoint é utilizado para enviar o resultado do SDK da autenticação de antifraude IDPay referente a uma transação já criada, aguardando a confirmação do antifraude

O envio dessa autenticação é obrigatório quando a transação retorna a necessidade de 3DS ou IDPay. Sempre que o processo exigir validação — seja pelo 3DS ou pelo IDPAY — a resposta da API trará o objeto antifraud, conforme o exemplo abaixo:

"antifraud": [
  {
    "analyse_status": "WAITING_AUTH",
    "analyse_required": "IDPAY", //IDPAY
    "session": "...", // token do IDPAY
    "antifraud_id": "..." // identificador da transação no IDPAY
  }

Rota a ser chamada:

🔼
POST /v1/marketplace/transactions/id/antifraud-auth

📌 Headers

Nome	Tipo	Obrigatório	Descrição
`integration-key`	string	Sim	Chave de integração.
`x-token`	string	Sim	Token de autenticação. Pode ser encontrado em nosso portal na guia de integração.
`Authorization`	Auth Type Bearer Token	Sim	Inserir o Bearer Token, gerado na rota Auth
`establishment_id`	string	Sim	Id do estabelecimento que foi gerado a transação

📌 Path Parameters

Nome	Tipo	Obrigatório	Descrição
id	string	SIm	_ID da transação a ser validado

📌 Modelo do Body IDPAY

O corpo da requisição deve ser enviado no formato JSON

{
  "id": antifraud_id, //antifraud_id retornado na criação da transação
  "concluded":concluded, //Retorno do SDK WEB IDPAY
  "capture_concluded":capture_concluded //Retorno do SDK WEB IDPAY
}

Detalhe do body IDPAY

Nome	Tipo	Obrigatório	Descrição
`id`	string	Sim	Valor de antifraud_id retornado na criação da transação
`concluded`	boolean	Sim	Indica se o fluxo de verificação do usuário foi finalizado com sucesso pelo IDPAY.
`capture_concluded`	boolean	Sim	Informa se a captura dos dados biométricos e validações internas do IDPAY foi realizada corretamente.

Modelo Curl

curl --location 'https://api.sandbox.paytime.com.br/v1/marketplace/transactions/:id/antifraud-auth' \
--header 'integration-key: <SEU_INTEGRATION_KEY>' \
--header 'x-token: <SEU_X_TOKEN' \
--header 'establishment_id: <ID_DO_ESTABELECIMENTO' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <BEARER_TOKEN_ROTA_AUTH' \
--data '{
	"id:" <antifraud_id>,//antifraud_id retornado na criação da transação
  "concluded": <concluded>, //Retorno do SDK WEB IDPAY
  "capture_concluded":<capture_concluded> //Retorno do SDK WEB IDPAY
}

Códigos de Resposta

Consulte a página com os status: Status de respostas

Para mais detalhes sobre os parâmetros e funcionamento da API, acesse a documentação oficial da Paytime.

Updated 4 months ago

Did this page help you?