Criar agreement - Agreements - Mercado Pago Developers
Criar Agreement

POST

/v2/wallet_connect/agreements
Um Agreement é um link de autorização recebido pelo comprador para permitir ao vendedor acessar a sua carteira do Mercado Pago, a fim de debitar o pagamento.
Parâmetros de requisição
client.id
number
Localização: queryID único que identifica um cliente específico
x-platform-id
string
Localização: headerCampo destinado para as plataformas ou módulos que oferecem Mercado Pago em suas soluções
agreement_data
object
Localização: bodyContém informação sobre as ações que o usuário deve fazer e o valor a ser pago
external_flow_id
string
Localização: bodyIdentifica o estado do fluxo pelo lado do vendedor
Parâmetros de resposta
agreement_id
string
Localização: bodyID único que identifica um Agreement
agreement_uri
string
Localização: bodyThis is the uri to redirect the user to the wallet linking in the frontend
Solicitação
curl
curl -X POST \
      'https://api.mercadopago.com/v2/wallet_connect/agreements?client.id=2451675580092619' \
      -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
      -H 'Content-Type: application/json' \ 
      -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"
  }
}'
Resposta
json
{
  "agreement_id": "b1234e5678b91c23a456e78912345b67",
  "agreement_uri": "https://beta.mercadopago.com.ar/v1/wallet_agreement/b1234e5678b91c23a456e78912345b67"
}
Erros
400bad_request
400Field return_uri is required
400Field external_flow_id is required
400Field return_uri must not be grater than 300 characters
400Field external_flow_id must not be grater than 300 characters
400Field external_user must not be blank
400Field id must not be blank