Criar agreement

A primeira etapa para integrar o Wallet Connect é a criação de um agreement, um link de autorização que o comprador acessa para conceder ao vendedor o acesso à sua carteira do Mercado Pago no momento em que um pagamento for realizado.

O agreement armazena os meios de pagamento selecionados pelo pagador e permite a alteração dessas configurações sem a intervenção do vendedor, tornando esta etapa transparente durante o fluxo de pagamento.

Confira o diagrama abaixo que ilustra como funciona o fluxo de criação do agreement.

Criar agreement

Para criar um agreement, envie um POST com os atributos necessários ao endpoint /v2/wallet_connect/agreements e execute a requisição ou, se preferir, utilize o curl abaixo e atente-se à resposta da requisição que retornará dois parâmetros obrigatórios para obter a aprovação do pagador: agreement_uri e return_uri.

          
curl -X POST \
      'https://api.mercadopago.com/v2/wallet_connect/agreements?client.id=<CLIENT.ID>' \
      -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
      -H 'Content-Type: application/json' \ 
      -H 'x-platform-id: YOUR_ACCESS_TOKEN' \
      -d '{
  "return_url": "https://www.mercadopago.com/",
  "external_flow_id": "EXTERNAL_FLOW_ID",
  "external_user": {
    "id": "usertest",
    "description": "Test account"
  },
  "agreement_data": {
    "validation_amount": 3.14,
    "description": "Test agreement"
  }
}'

Importante

Um usuário pode ter apenas um agreement ativo por integração. Caso queira criar um novo agreement, é preciso cancelar o anterior. Para cancelar um agreement, envie um DELETE ao endpoint /v2/wallet_connect/agreements/{agreement_id} e execute a requisição.

Pré-requisitos

Conheça os pré-requisitos necessários para integrar o Wallet Connect.

Obter aprovação

Saiba como obter a aprovação do comprador para utilizar os dados de pagamento salvos na carteira Mercado Pago.