Inicio
Documentação
Recursos
Parcerias
Comunidade

Recursos

Confira as atualizaçÔes das nossas soluçÔes e do funcionamento do sistema ou peça suporte técnico.

Parcerias

Conheça nosso programa para agĂȘncias ou desenvolvedores que oferecem serviços de integração e vendedores que desejam contratĂĄ-los.

Comunidade

Fique por dentro das Ășltimas novidades, peça ajuda a outros integradores e compartilhe seu conhecimento.

Iniciar vinculação - VinculaçÔes - Mercado Pago Developers

Busca inteligente powered by OpenAI 

Iniciar vinculação

POST

https://api.mercadopago.com/v2/wallet_connect/agreements
Uma vinculação é 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
QUERY
client.id
number
ID Ășnico que identifica um cliente especĂ­fico.
HEADER
x-platform-id
string
Campo destinado para as plataformas ou módulos que oferecem Mercado Pago em suas soluçÔes.
BODY
return_uri
string
URL que redireciona o usuĂĄrio de volta ao site do vendedor.
external_flow_id
string
Identifica o estado do fluxo pelo lado do vendedor.
external_user
object
O external_user contém os dados que o vendedor precisarå para identificar um usuårio, de modo que este possa prosseguir com o seu próprio fluxo.
agreement_data
object
Contém informação sobre as açÔes que o usuårio deve fazer e o valor a ser pago.
ParĂąmetros de resposta
agreement_id
string
ID Ășnico que identifica uma vincualção.
agreement_uri
string
Este Ă© o uri para redirecionar o usuĂĄrio para a carteira vinculada no frontend.
Erros

400Erro

400

Bad-Request

Requisição
curl -X POST \
    'https://api.mercadopago.com/v2/wallet_connect/agreements?client.id=<CLIENT.ID>'\
    -H 'Content-Type: application/json' \
       -H 'x-platform-id: YOUR_PLATFORM_ID' \
       -H 'Authorization: Bearer TEST-7434*********159-03141*********cee51edf8*********f94f589-1*********' \
    -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 de exemplo
{
  "agreement_id": "22abcd1235ed497f945f755fcaba3c6c",
  "agreement_uri": "https://wwww.mercadopago.com.ar/v1/wallet_agreement/22abcd1235ed497f945f755fcaba3c6c"
}