> ## 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. # Link de Pagamento com Click to Pay 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](/documentations/payment-methods/click-to-pay/intro#liability-shift-troca-de-responsabilidade). ## 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 ```bash theme={null} curl --location 'https://api.malga.io/v1/settings' \ --header 'x-client-id: ' \ --header 'x-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 ```bash theme={null} curl --location --request PATCH 'https://api.malga.io/v1/settings' \ --header 'x-client-id: ' \ --header 'x-api-key: ' \ --header 'Content-Type: multipart/form-data' \ --form '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. ## Benefícios de usar C2P via Link de Pagamento * **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**](/documentations/payment-methods/click-to-pay/integracao-api-charges). ## Criando uma sessão (Link de Pagamento) com suporte a 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: ```bash theme={null} curl --location 'https://api.malga.io/v1/sessions' \ --header 'x-client-id: ' \ --header 'x-api-key: ' \ --header 'Content-Type: application/json' \ --data '{ "name": "test", "merchantId": "", "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. ## Como o Link identifica que deve exibir Click to Pay? 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.