A primeira etapa para integrar o Wallet Connect é a criação de uma vinculação, 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.

A vinculação 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.

Qualquer mudança nos métodos de pagamento é comunicada através de uma notificação Webhooks, que traz detalhes da atualização. Para mais informações, consulte a seção Atualização do meio de pagamento de uma vinculação.

Confira o diagrama abaixo que ilustra como funciona o fluxo de criação da vinculação.

Para criar uma vinculação, 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 necessários para obter a aprovação do pagador: agreement_id e agreement_uri.

curl -X POST \
    'https://api.mercadopago.com/v2/wallet_connect/agreements' \
      -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
      -H 'Content-Type: application/json' \
      -H 'x-platform-id: YOUR_PLATFORM_ID' \
      -d '{
  "return_uri": "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"
  }
}'

{
  "agreement_id": "22abcd1235ed497f945f755fcaba3c6c",
  "agreement_uri": "https://wwww.mercadopago.com.ar/v1/wallet_agreement/22abcd1235ed497f945f755fcaba3c6c"
}