Skip to main content
O Link de Pagamento da Malga pode expor automaticamente a experiência Mastercard Click to Pay (C2P) quando o dpaId está configurado em settings e o método click_to_pay está incluído na lista de paymentMethods da sessão. Link de Pagamento com Click to Pay

​
Pré-requisitos

  • Configuração do dpaId em Settings:
    • É necessário configurar o dpaId (Digital Payment Application ID) nas configurações de settings através do endpoint /v1/settings.
    • O campo mastercardClickToPayDpaid é opcional e pode ser configurado no POST ou atualizado via PATCH.
    • O dpaId é fornecido pela equipe Malga em conjunto com o seu provedor/adquirente.
  • Credenciais de API Malga válidas (x-api-key, x-client-id).
  • Liability shift (opcional):
    • Para ter 100% de liability shift quando houver autenticação, recomendamos configurar um merchant Malga onde todos os provedores/adquirentes suportem autenticação externa (MPI externo). Em cenário com provedores mistos, fallbacks podem direcionar a transação para um adquirente sem esse suporte e a transação poderá ficar sem liability.
    • Para esse cenário de liability shift, é requirido que MIDs estejam cadastrados nas configurações dos provedores/adquirentes dentro do merchant na Malga.
    • Saiba mais em Liability shift.

​
Configurando o dpaId em Settings

Para habilitar o Click to Pay no Link de Pagamento, é necessário configurar o dpaId nas configurações de settings. O campo mastercardClickToPayDpaid pode ser configurado no momento da criação (POST) ou atualizado posteriormente (PATCH).

​
Exemplo de criação de settings com dpaId

curl --location 'https://api.malga.io/v1/settings' \
  --header 'x-client-id: <YOUR_CLIENT_ID>' \
  --header 'x-api-key: <YOUR_API_KEY>' \
  --header 'Content-Type: multipart/form-data' \
  --form 'mainColor="#000000"' \
  --form 'secondaryColor="#FFFFFF"' \
  --form 'mastercardClickToPayDpaid="223efa95-a0bc-43d6-aea9-715281b6b062"'

​
Exemplo de atualização de settings com dpaId

Via multipart (com ou sem outros campos): 
curl --location --request PATCH 'https://api.malga.io/v1/settings' \
  --header 'x-client-id: <YOUR_CLIENT_ID>' \
  --header 'x-api-key: <YOUR_API_KEY>' \
  --header 'Content-Type: multipart/form-data' \
  --form 'mastercardClickToPayDpaid="223efa95-a0bc-43d6-aea9-715281b6b062"'
Via JSON (somente campos textuais, sem logo): 
curl --location --request PATCH 'https://api.malga.io/v1/settings' \
  --header 'x-client-id: <YOUR_CLIENT_ID>' \
  --header 'x-api-key: <YOUR_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
    "mastercardClickToPayDpaid": "223efa95-a0bc-43d6-aea9-715281b6b062"
  }'
Importante: O dpaId é fornecido pela equipe Malga. Entre em contato com o suporte Malga para obter o dpaId do seu ambiente.
  • Onboarding rápido: você não precisa implementar o SDK de front-end da Mastercard imediatamente; basta configurar o dpaId em settings e usar o Link.
  • Menos atrito no checkout: principalmente em canais onde o cliente está em dispositivos móveis, o Click to Pay reduz o tempo para concluir a compra.
  • Experiência refinada: o Link de Pagamento passou pela homologação da Mastercard para oferecer a melhor experiência possível para o cliente.
Se você deseja ter controle total da experiência de checkout e integrar diretamente o SDK da Mastercard no seu front-end, consulte a página de Integração via API de Charges com Click to Pay. Depois de ter o dpaId configurado em settings, você pode criar uma sessão de pagamento que será usada como Link através do endpoint /v1/sessions. Se o dpaId estiver configurado e o método click_to_pay estiver incluído nos paymentMethods, o front do Link irá identificar a disponibilidade de C2P automaticamente.
Caso o SDK do Click to Pay não esteja funcionando corretamente no momento, por indisponibilidade das bandeiras, o Link de Pagamento irá exibir o fluxo de cartão de crédito comum. Além disso, sempre que Click to Pay for um método de pagamento, ele não será obrigatório para o cliente, ele poderá optar por seguir com o fluxo de cartão de crédito comum.Para ter cobertura completa de risco, é possível combinar o Click to Pay com o 3ds agnóstico Malga, assim quando o cliente optar por não usar Click to Pay, usará cartão de crédito comum e cairá no fluxo de 3ds agnóstico.
Exemplo de criação de sessão: 
curl --location 'https://api.malga.io/v1/sessions' \
--header 'x-client-id: <YOUR_CLIENT_ID>' \
--header 'x-api-key: <YOUR_API_KEY>' \
--header 'Content-Type: application/json' \
--data '{
    "name": "test",
    "merchantId": "<YOUR_MERCHANT_ID>",
    "amount": 150,
    "currency": "BRL",
    "statementDescriptor": "Pedido #231 loja joão",
    "capture": true,
    "paymentMethods": [
        {
            "paymentType": "click_to_pay",
            "installments": 1
        },
        {
            "paymentType": "credit",
            "installments": 1,
            "threeDS": {
                "enabled": true,
                "liabilityShiftRequired": false
            }
        },
        {
            "paymentType": "pix",
            "expiresIn": 232
        }
    ],
    "dueDate": "2025-12-11T09:28:45.000Z",
    "items": [
        {
            "name": "Item",
            "description": "Item do carrinho",
            "unitPrice": 1000,
            "quantity": 1,
            "tangible": false
        }
    ]
}'

​
Campos importantes

  • paymentMethods:
    • Obrigatório enviar o método credit junto com o click_to_pay para caso necessite de fallback ou o cliente não possua Click to Pay disponível;
    • As parcelas (installments) podem ser ajustadas conforme sua regra de negócio.
O front do Link de Pagamento da Malga verifica:
  1. Se o dpaId está configurado em settings através do campo mastercardClickToPayDpaid.
  2. Se o método de pagamento click_to_pay está incluído na lista de paymentMethods da sessão.
  3. Se o usuário possui cartões de crédito compatíveis salvos ou o inserido é compatível.
O Click to Pay dentro da Malga funciona com cartões de crédito Visa e Mastercard.
Quando essas condições são atendidas, o Link passa a levar o usuário para a jornada Click to Pay, permitindo que o cliente selecione cartões já cadastrados na carteira C2P ou faça seu cadastro na carteira das bandeiras.