Recursos para IA
Crear vinculaciónhttps://api.mercadopago.com/v2/wallet_connect/agreements
Este endpoint permite crear una vinculación entre comprador y vendedor, generando un enlace de autorización a ser enviado al comprador para que el vendedor pueda acceder a su billetera de Mercado Pago y procesar pagos. En caso de éxito, la solicitud devolverá una respuesta con el estado 200.
POST
Request parameters
Header
Authorization
Access Token obtenido a través del panel de desarrollador. Obligatorio ser enviado en todas las solicitudes.string
REQUERIDO
x-platform-id
Identificador de plataformas o módulos que ofrecen Mercado Pago en sus soluciones.string
Query
client.id
Identificador único de la aplicación cliente.number
Body
return_uri
URI para redirigir al comprador después de completar el flujo de vinculación.string
external_flow_id
Identificador interno del vendedor para el estado actual del flujo.string
external_user
Datos usados por el vendedor para identificar al comprador en su propio sistema.object
agreement_data
Datos adicionales de la vinculación, incluyendo monto y descripción opcionales.object
Response parameters
agreement_id
Identificador único de la vinculación.string
agreement_uri
URI para redirigir al comprador y completar la vinculación de la billetera en el frontend.string
Errors
400Error de solicitud.
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-5*********956537-12*********ff1a3d36d*********47e7b9985*********770' \
-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"
}