> ## 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.

# Integração via API de Cobranças com Click to Pay

Se você deseja controlar totalmente a experiência de checkout no seu site ou app, pode integrar o **Mastercard Click to Pay (C2P)** diretamente na API transacional da Malga usando o endpoint `/v1/charges`.

Neste modelo:

* O **front-end** integra os **SDKs de Click to Pay da Mastercard**, responsáveis por:
  * Apresentar a UI de seleção/cadastro de cartão C2P para o comprador;
  * Realizar a autenticação com o emissor, quando aplicável;
  * Retornar identificadores como `correlationId`, `flowId` e `merchantTransactionId`;
* o **back-end** chama a **API da Malga** com `paymentType: "click_to_pay"` e o objeto `walletClickToPay` preenchido.

Para detalhes da jornada de usuário, componentes de UI e fluxos de autenticação, consulte a documentação oficial da Mastercard:

* Guia de experiência do cliente: [`https://developer.mastercard.com/click-to-pay-customer-experience-guide/documentation`](https://developer.mastercard.com/click-to-pay-customer-experience-guide/documentation)
* Visão geral do produto Click to Pay: [`https://developer.mastercard.com/product/click-to-pay/`](https://developer.mastercard.com/product/click-to-pay/)

## Pré-requisitos

* **SDKs da Mastercard integrados no seu front-end**:
  * Eles são responsáveis por obter `dpaId`, `correlationId`, `flowId` e `merchantTransactionId` da jornada de Click to Pay.
  * Em caso de dúvidas ou se desejar suporte para a integração ponta a ponta, entre em contato com o time Malga.
* **Credenciais de API Malga** válidas (`x-api-key`, `x-client-id`);
* **Validação da jornada**: em caso de implementação ponta a ponta, a Mastercard precisará homologar a jornada do cliente para atender os padrões da bandeira.
* **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, é requerido 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).

### Exemplo completo de requisição cURL

```bash theme={null}
curl --request POST 'https://api.malga.io/v1/charges' \
  --header 'x-api-key: <SEU_API_KEY>' \
  --header 'x-client-id: <SEU_CLIENT_ID>' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "merchantId": "<MERCHANT_ID>",
    "amount": 10000,
    "currency": "BRL",
    "capture": true,
    "statementDescriptor": "Pedido 1234 - C2P",
    "paymentMethod": {
      "paymentType": "click_to_pay",
      "installments": 1
    },
    "paymentSource": {
      "sourceType": "wallet",
      "walletPayment": "credit",
      "walletClickToPay": {
        "dpaId": "223efa95-a0bc-43d6-aea9-715281b6b062",
        "correlationId": "34f4a04b.a54a46e6-dc2d-4ec3-8b2f-babc2280720b",
        "flowId": "34f4a04b.a54a46e6-dc2d-4ec3-8b2f-babc2280720b.1754052884",
        "merchantTransactionId": "0a4e0d3.34f4a04b.96dc7ec48081fda8c31f541fdcaca8325080d575"
      }
    }
  }'
```

> **Importante:** os valores de `correlationId`, `flowId` e `merchantTransactionId` do exemplo são ilustrativos. Na integração real, esses dados virão diretamente dos SDKs de Click to Pay da Mastercard durante a jornada do comprador. Já o `dpaId` é fornecido pelo time Malga.

## Quando usar Link de Pagamento x Integração direta

* **Link de Pagamento com C2P**:
  * Ideal para começar rápido, sem precisar integrar o SDK da Mastercard;
  * Ótimo para vendas em canais sem checkout próprio (WhatsApp, redes sociais, atendimento humano).
* **Integração via API de Cobranças com C2P (esta página)**:
  * Ideal para checkouts proprietários (web/app) que exigem controle total de UI/UX;
  * Permite personalizar completamente a jornada de Click to Pay, integrando diretamente os SDKs Mastercard e orquestrando a autenticação conforme suas regras de negócio.

Caso você queira realizar uma integração ponta a ponta com os SDKs da Mastercard e tenha dúvidas sobre o desenho da solução, entre em contato com o time Malga para apoio técnico.