> ## Documentation Index
> Fetch the complete documentation index at: https://docs.malga.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 3DS2 Agnóstico no Link de Pagamento

## Como funciona o 3DS2?

3DS2 é um protocolo de autenticação de cartões que permite a autenticação de cartões de crédito e débito.

O Link de Pagamento, caso configurado, irá solicitar a autenticação do cartão ao banco emissor através do 3DS2. Com ou sem o desafio, a responsabilidade de chargebacks é transferida para o banco emissor.

<Info>
  A transferência de responsabilidade para o banco emissor **não** é feita em casos de desacordo comercial.
</Info>

Saiba mais sobre o 3DS2 [**aqui**](/documentations/3ds2-malga/intro).

## Configurando o 3DS2 no Link de Pagamento

<Steps>
  <Step title="Configure seu merchant">
    Garanta que seu merchant tenha suporte a 3DS2 Malga. Saiba mais [**aqui**](/documentations/3ds2-malga/3ds-malga/pre-requisitos-configuracao).
  </Step>

  <Step title="Fluxo Inteligente">
    Adicione um novo fluxo inteligente dentro do seu merchant para processar as transações com 3DS2.
  </Step>

  <Step title="Crie seu Link">
    Com as configurações corretas, tanto via API quanto no Dashboard, você poderá criar seu Link de Pagamento com 3DS2.
  </Step>
</Steps>

## Criando via API

Dentro das configurações do método de pagamento `credit`, você poderá configurar o 3DS2.

<ParamField path="enabled" type="boolean">
  Indica se o 3DS2 está habilitado para o método de pagamento
</ParamField>

<ParamField path="liabilityShiftRequired" type="boolean" default="true">
  Indica se é necessário o liability shift para o método de pagamento. Se `true`, quando não houver transferência de responsabilidade para o emissor, a transação será rejeitada.
</ParamField>

<CodeGroup>
  ```bash Request theme={null}
  {
     "amount": 1000,
     "name": "Loja 1",
     "merchantId": "<YOUR_MERCHANT_ID>",
     "dueDate": "2030-10-25T09:28:45.000Z",
     "statementDescriptor": "<YOUR_STATEMENT_DESCRIPTOR>",
     "paymentMethods": [
        {
           "paymentType": "credit",
           "installments": 10,
           "threeDS": {
              "enabled": true,
              "liabilityShiftRequired": false
           }
        },
        {
           "paymentType": "pix",
           "expiresIn": 10000
        },
        {
           "paymentType": "boleto",
           "expiresDate": "2026-01-01"
        }
     ],
     "items":[
        {
           "name": "Fone de Ouvido Bluetooth TWS-X1",
           "description": "Fone sem fio com cancelamento de ruído ativo, case de carregamento e 8h de bateria. Cor: Preto Fosco.",
           "unitPrice": 35000,
           "quantity": 1,
           "tangible": false
        },
        {
           "name": "Caneca \"Code & Coffee\"",
           "description": "Fone sem fio com cancelamento de ruído ativo, case de carregamento e 8h de bateria. Cor: Preto Fosco.",
           "unitPrice": 4500,
           "quantity": 1,
           "tangible": false
        },
        {
           "name": "Kit de Anotações \"Inspire\"",
           "description": "1 caderno A5 pautado (capa dura), 1 bloco de notas adesivas e 2 canetas esferográficas.",
           "unitPrice": 8990,
           "quantity": 1,
           "tangible": false
        }
     ]
  }
  ```

  ```bash Response theme={null}
  {
      "id": "b1d0b4b4-c4c6-41df-ac24-07a21228187d",
      "name": "Loja 1",
      "status": "created",
      "isActive": true,
      "clientId": "YOUR_CLIENT_ID",
      "orderId": null,
      "amount": 1000,
      "currency": "BRL",
      "capture": false,
      "merchantId": "YOUR_MERCHANT_ID",
      "dueDate": "2030-10-25T09:28:45.000Z",
      "description": null,
      "statementDescriptor": "<YOUR_STATEMENT_DESCRIPTOR>",
      "paymentLink": "https://link.malga.io/b1d0b4b4-c4c6-41df-ac24-07a21228187d",
      "createdAt": "2025-11-24T09:41:10.129Z",
      "updatedAt": "2025-11-24T09:41:10.129Z",
      "publicKey": "a09605bb-8e2c-4474-a653-7c3c9dca0ce1",
      "items": [
          {
              "name": "Fone de Ouvido Bluetooth TWS-X1",
              "description": "Fone sem fio com cancelamento de ruído ativo, case de carregamento e 8h de bateria. Cor: Preto Fosco.",
              "unitPrice": 35000,
              "quantity": 1,
              "tangible": false,
              "categoryId": null
          },
          {
              "name": "Caneca \"Code & Coffee\"",
              "description": "Fone sem fio com cancelamento de ruído ativo, case de carregamento e 8h de bateria. Cor: Preto Fosco.",
              "unitPrice": 4500,
              "quantity": 1,
              "tangible": false,
              "categoryId": null
          },
          {
              "name": "Kit de Anotações \"Inspire\"",
              "description": "1 caderno A5 pautado (capa dura), 1 bloco de notas adesivas e 2 canetas esferográficas.",
              "unitPrice": 8990,
              "quantity": 1,
              "tangible": false,
              "categoryId": null
          }
      ],
      "paymentMethods": [
          {
              "paymentType": "pix",
              "expiresIn": 10000
          },
          {
              "paymentType": "credit",
              "installments": 10,
              "recurrence": null,
              "threeDS": {
                  "enabled": true,
                  "liabilityShiftRequired": false
              }
          },
          {
              "paymentType": "boleto",
              "instructions": null,
              "expiresDate": "2026-01-01"
          }
      ]
  }
  ```
</CodeGroup>