Recursos para IA
Criar vinculaçãohttps://api.mercadopago.com/v2/wallet_connect/agreements
Este endpoint permite criar uma vinculação entre compador e vendedor, gerando um link de autorização a ser enviado ao comprador para que o vendedor possa acessar sua carteira do Mercado Pago e processar pagamentos. Em caso de sucesso, a requisição retornará uma resposta com o status 200.
POST
Request parameters
Header
Authorization
Access Token obtido através do painel de desenvolvedores. Obrigatório ser enviado em todas as requisições.string
OBRIGATÓRIO
x-platform-id
Identificador de plataformas ou módulos que oferecem o Mercado Pago em suas soluções.string
Query
client.id
Identificador único da aplicação cliente.number
Body
return_uri
URI para redirecionar o comprador após a conclusão do fluxo de vinculação.string
external_flow_id
Identificador interno do vendedor para o estado atual do fluxo.string
external_user
Dados usados pelo vendedor para identificar o comprador em seu próprio sistema.object
agreement_data
Dados adicionais da vinculação, incluindo valor e descrição opcionais.object
Response parameters
agreement_id
Identificador único da vinculação.string
agreement_uri
URI para redirecionar o comprador e concluir a vinculação da carteira no frontend.string
Erros
400Erro de requisição.
400
Bad Request.
Request
curl -X POST \
'https://api.mercadopago.com/v2/wallet_connect/agreements?client.id=<CLIENT_ID>'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer APP_USR-4*********994754-12*********c73b4e1ac*********cef36b27c*********840' \
-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": 24.5,
"description": "Test agreement"
}
}'Response
{
"agreement_id": "22abcd1235ed497f945f755fcaba3c6c",
"agreement_uri": "https://www.mercadopago.com.ar/v1/wallet_agreement/22abcd1235ed497f945f755fcaba3c6c"
}