Criar agreement - Fluxo de vinculação de contas - Mercado Pago Developers
Qual documentação você quer buscar?

Não sabe como começar a integrar? 

Acesse os primeiros passos

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.

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

Importante
Um usuário pode ter apenas um agreement ativo por integração. Para criar um novo agreement, é preciso cancelar o anterior. Para isso, envie um DELETE ao endpoint /v2/wallet_connect/agreements/{agreement_id} e execute a requisição. Após o cancelamento, uma notificação webhook será enviada contendo todos os detalhes da operação. Para entender o processo com mais detalhes, acesse a seção Cancelamento de agreement entre integrador e Mercado Pago .

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_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"
  }
}'

        

Resposta

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