Changelog
Back to All

Dezembro 2025 - IDPAY

9 months ago

šŸ” InclusĆ£o do IDPAY como opĆ§Ć£o de antifraude

Agora vocĆŖ pode utilizar o IDPAY como uma camada de antifraude, alĆ©m da jĆ” existente autenticaĆ§Ć£o 3DS.

Durante a criaĆ§Ć£o da transaĆ§Ć£o, Ć© possĆ­vel escolher qual soluĆ§Ć£o de antifraude aplicar.
Caso nenhuma opĆ§Ć£o seja informada, o sistema utilizarĆ” automaticamente o 3DS como padrĆ£o.


1) Escolhendo o antifraude ao criar a transaĆ§Ć£o

No momento de criar a transaĆ§Ć£o, inclua o campo antifraud_type, definindo-o como THREEDS 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", // THREEDS ou IDPAY
    "session": "...", // sessĆ£o do 3DS ou token do IDPAY
    "antifraud_id": "..." // identificador da transaĆ§Ć£o no 3DS ou no IDPAY
  }
],

Para informaƧƵes detalhadas, consulte a documentaĆ§Ć£o do endpoint de criaĆ§Ć£o de transaĆ§Ć£o.


2) Implementando o SDK da experiĆŖncia Web do IDPAY

Se a transaĆ§Ć£o exigir a execuĆ§Ć£o do IDPAY, serĆ” necessĆ”rio incorporar a experiĆŖncia de verificaĆ§Ć£o do usuĆ”rio em sua aplicaĆ§Ć£o.

As instruƧƵes completas para implementaĆ§Ć£o do SDK Web estĆ£o disponĆ­veis em:
https://devcenter.unico.io/unico-idpay/integracao/controlando-a-experiencia/web/sdk

ObservaĆ§Ć£o:

No mƩtodo open do SDK:

  • transactionId deve receber o valor de antifraud_id retornado na criaĆ§Ć£o da transaĆ§Ć£o;
  • token deve ser preenchido com o valor de session.

3) Realizando a autenticaĆ§Ć£o do antifraude

ApĆ³s a conclusĆ£o da experiĆŖncia de validaĆ§Ć£o pelo usuĆ”rio, Ć© necessĆ”rio autenticar o antifraude na API, enviando os dados obtidos durante o processo.

3.1) IDPAY

Envie um objeto contendo os campos:

  • concluded
  • capture_concluded

3.2) 3DS

Envie um objeto contendo os campos:

  • id
  • status
  • authentication_status

Para informaƧƵes detalhadas, consulte a documentaĆ§Ć£o do endpoint de autenticaĆ§Ć£o da transaĆ§Ć£o.


4) IMPORTANTE!

Para que o IDPAY funcione corretamente em ambiente de produĆ§Ć£o, Ć© obrigatĆ³rio informar previamente o domĆ­nio onde sua aplicaĆ§Ć£o serĆ” executada.

Somente domĆ­nios autorizados poderĆ£o carregar e executar o SDK do IDPAY.