Skip to main content
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:

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

​
Exemplo completo de requisição cURL

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