Pré-requisitos e configurações

​

Habilitando o 3DS2 na Conta Malga

• Solicite a ativação do 3DS2: Entre em contato com a equipe Malga para habilitar a funcionalidade 3D Secure 2 em sua conta. A Malga irá configurar o suporte ao 3DS2 para o seu ambiente. Somente após essa habilitação você poderá prosseguir com os próximos passos.
• Provedor de pagamento compatível: Verifique se você possui ou configurou um provedor de pagamento que suporte 3DS2 em sua conta Malga. Você pode consultar a lista de provedores suportados nesse link Introdução - Malga (3DS2_Malga)

​

Criando um Merchant com Suporte a 3DS2

• merchantUrl – URL do site da loja que está usando 3DS2 (geralmente a página inicial ou domínio do e-commerce).
• merchantName – Nome do estabelecimento que aparecerá para o cliente durante o desafio 3DS.
• providers.acquirer.merchantId – O identificador do seu merchant junto ao provedor de pagamento. Muitos provedores usam um único Merchant ID para todas as bandeiras de cartão;
• providers.acquirer.bin – Lista de BINs do adquirente cadastrados para cada bandeira de cartão. Inclui:
  • brand: Nome da bandeira (por exemplo, “Visa”, “Mastercard”, “Elo”).
  • value: BIN (Bank Identification Number) do adquirente associado àquela bandeira.
  • merchantId (opcional por bandeira): Se o seu provedor utilizar um Merchant ID diferente para cada bandeira, você pode especificá-lo aqui. Caso contrário, se for igual para todas as bandeiras, use apenas o campo principal providers.acquirer.merchantId.

curl --request POST 'https://api.malga.io/v1/merchants' \
  --header 'x-api-key: <SEU_API_KEY>' \
  --header 'x-client-id: <SEU_CLIENT_ID>' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "mcc": "4814",
    "merchantUrl": "https://www.sualoja.com.br",
    "merchantName": "Minha Loja Online",
    "name": "Minha Loja Online",
    "providers": [
      {
        "priority": 1,
        "name": "SandboxProvider",
        "credentials": {
          "type": "SANDBOX",
          "apiKey": "SUaChaveDeAPI_Provedor"
        },
        "acquirer": {
          "merchantId": "ABC123MERCHANTID",
          "bin": [
            {
              "brand": "Visa",
              "value": "000001"
            },
            {
              "brand": "Mastercard",
              "value": "000002"
            }
          ]
        }
      }
    ],
    "status": true
  }'

curl --request PATCH 'https://api.malga.io/v1/merchants/<MERCHANT_ID>' \
  --header 'x-api-key: <SEU_API_KEY>' \
  --header 'x-client-id: <SEU_CLIENT_ID>' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "merchantUrl": "https://www.sualoja.com.br",
    "merchantName": "Minha Loja Online",
    "name": "Minha Loja Online",
    "providers": [
      {
        "priority": 1,
        "name": "SandboxProvider",
        "credentials": {
          "type": "SANDBOX",
          "apiKey": "SUaChaveDeAPI_Provedor"
        },
        "acquirer": {
          "merchantId": "ABC123MERCHANTID",
          "bin": [
            {
              "brand": "Visa",
              "value": "000001"
            },
            {
              "brand": "Mastercard",
              "value": "000002"
            }
          ]
        }
      }
    ]
  }'

​

Configurando o Fluxo de Pagamento 3DS2

curl --request POST 'https://api.malga.io/v1/flows' \
  --header 'x-api-key: <SEU_API_KEY>' \
  --header 'x-client-id: <SEU_CLIENT_ID>' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "name": "Fluxo 3DS2",
    "merchantId": "<MERCHANT_ID_CRIADO>",
    "paymentMethod": "3ds2_malga",
    "flow": {
      "root": [
        {
          "rule": "provider",
          "id": "<1__ID_DO_PROVEDOR_COM_SUPORTE_3DS2>"
        },
        {
          "rule": "provider",
          "id": "<2__ID_DO_PROVEDOR_COM_SUPORTE_3DS2>"
        }
      ]
    }
  }'