Iniciar vinculação
POST
Produtos relacionados:
Parâmetros de requisição
QUERY
client.id
ID único que identifica um cliente específico.number
HEADER
x-platform-id
Campo destinado para as plataformas ou módulos que oferecem Mercado Pago em suas soluções.string
BODY
return_uri
URL que redireciona o usuário de volta ao site do vendedor.string
external_flow_id
Identifica o estado do fluxo pelo lado do vendedor.string
external_user
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.object
agreement_data
Contém informação sobre as ações que o usuário deve fazer e o valor a ser pago.object
Parâmetros de resposta
agreement_id
ID único que identifica uma vincualção.string
agreement_uri
Este é o uri para redirecionar o usuário para a carteira vinculada no frontend.string
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-8971*********918-01191*********5874530a4*********4799fdf-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"
}