Como funciona o 3D Secure 2

Quando uma cobrança é enviada com dados de 3DS2, o provedor irá solicitar uma analise ao banco emissor.
O banco emissor pode exigir que o cliente faça uma autenticação. Esse processo é conhecido como desafio.
Uma cobrança pode ser autorizada pelo banco emissor sem exigir desafio.
A cobrança com desafio exigirá uma ação por parte do usuário para autenticar a transação. Nesse caso o usuário será redirecionado ao banco para autenticar a transação.
O resultado final da transação será enviado via webhook

Cobrança com 3D Secure 2

Para iniciar uma cobrança com 3DS2, primeiro certifique-se de que o provedor está na lista de provedores suportados.
Inclua o objeto threeDSecure2 na cobrança.

Principais informações

• redirectURL: A URL que o provedor irá utilizar para retornar ao site de origem após o redirecionamento
• requestorURL: A URL do site do portador do cartão
• browser: Dados do navegador do portador do cartão
• cardHolder: Dados do portador do cartão
• billingAddress: Endereço de cobrança
• shippingAddress: Endereço para envio

Exemplo de cobrança com 3D Secure 2

curl --location --request POST 'https://api.malga.io/v1/charges' \
--header 'X-Client-Id: <YOUR_CLIENT_ID>' \
--header 'X-Api-Key: <YOUR_API_KEY>' \
--header 'Content-Type: application/json' \
--data-raw '{
	"merchantId": "469ed9e8-97d1-433a-a586-2fd282b7d9a4",
    "amount": 100,
    "statementDescriptor": "Pedido #231 loja joão",
    "capture": true,
    "paymentMethod": {
        "paymentType": "credit",
        "installments": 1
    },
    "paymentSource": {
		"sourceType": "card",
		"card": {
            "cardHolderName": "JOSE DAS NEVES",
            "cardNumber": "4929564637987814",
            "cardCvv": "123",
            "cardExpirationDate": "12/2026"
        }
	},
    "threeDSecure2": {
        "redirectURL": "http://your-company/receive",
        "requestorURL": "http://your-company",
        "browser": {
            "acceptHeader": "*/*",
            "colorDepth": 24,
            "javaEnabled": true,
            "javaScriptEnabled": true,
            "language": "pt-BR",
            "screenHeight": 1080,
            "screenWidth": 1920,
            "timeZoneOffset": "180",
            "userAgent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/108.0.0.0 Safari/537.36",
            "ip": "0.0.0.0"
        },
        "cardHolder": {
            "email": "[e-mail]",
            "mobilePhone": "11 99329899"
        },
        "billingAddress": {
            "city": "Rio de Janeiro",
            "country": "Brasil",
            "streetNumber": "45",
            "zipCode": "2547896",
            "state": "RJ",
            "street": "Av. Brasil"
        },
        "shippingAddress": {
            "city": "São Paulo",
            "country": "Brasil",
            "streetNumber": "45",
            "zipCode": "2957896",
            "state": "SP",
            "street": "Rua das Flores"
        }
    }
 }'

Exemplo de resposta com 3D Secure 2

{
  "clientId": "8827fe85-7a47-42c6-b331-769c243a5893",
  "merchantId": "469ed9e8-97d1-433a-a586-2fd282b7d9a4",
  "description": null,
  "orderId": null,
  "createdAt": "2023-02-24T21:46:36.392Z",
  "amount": 100,
  "originalAmount": 100,
  "currency": "BRL",
  "statementDescriptor": "Pedido #231 loja joão",
  "capture": true,
  "isDispute": false,
  "status": "pending",
  "paymentMethod": {
    "installments": 1,
    "paymentType": "credit"
  },
  "paymentSource": {
    "sourceType": "card",
    "cardId": "8747b602-02d5-4246-9e3a-2be879c126f7"
  },
  "transactionRequests": [
    {
      "idempotencyKey": "00f9729c-6cd3-4529-adec-74b3efd96263",
      "providerId": "617fe0b0-f0ff-4e73-b6f1-1c765e59f1f5",
      "providerType": "ADYEN",
      "transactionId": null,
      "amount": 100,
      "authorizationCode": null,
      "authorizationNsu": null,
      "requestStatus": "processing",
      "requestType": "authorization",
      "responseTs": "971ms",
      "providerAuthorization": {
        "networkAuthorizationCode": null,
        "networkResponseCode": "RedirectShopper"
      }
    }
  ],
  "threeDSecure2": {
    "redirectURL": "http://your-company/receive",
    "requestorURL": "http://your-company",
    "browser": {
      "acceptHeader": "*/*",
      "colorDepth": 24,
      "javaEnabled": true,
      "javaScriptEnabled": true,
      "language": "pt-BR",
      "screenHeight": 1080,
      "screenWidth": 1920,
      "timeZoneOffset": "180",
      "userAgent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/108.0.0.0 Safari/537.36",
      "ip": "127.0.0.1"
    },
    "billingAddress": null,
    "shippingAddress": null,
    "cardHolder": null,
    "authData": {
      "action": "REDIRECT",
      "providerType": "ADYEN",
      "responseType": "AUTHENTICATION",
      "response": {
        "md": "M2RzMi5lZTBiZTgzZTdmZDBlZDk...AkHGAAAA",
        "url": "https://checkoutshopper-test.adyen.com/checkoutshopper/threeDS2.shtml?pspReference=8636772643981111",
        "paReq": "BQABAgB-MNl4GsRJSf5EmZE8guLfFQX7Q5Q...L_dRprriZL72QXGCtIPK-Hd",
        "termUrl": "https://checkoutshopper-test.adyen.com/checkoutshopper/threeDS/return/H4sIAAAAAAAA_..."
      }
    }
  }
}

A resposta da transação irá incluir o objeto authData dentro do objeto threeDSecure2, com dados para a ação de autenticação.

Examinando o objeto authData

• O atributo action representa que tipo de ação foi solicitada para autenticação.
• O atributo providerType identifica em qual provedor o 3DS2 foi processado.
• O atributo responseType mostra qual é a etapa do desafio, podendo ser uma etapa de autenticação ou autorização.
• O atributo response é um objeto dinâmico com a resposta do provedor com dados para autenticação.

Os provedores implementam o desafio de formas diferentes, exigindo tratamentos específicos.
Na próxima sessão iremos mostrar como lidar com o fluxo com desafio.