Inicio
Documentación
Recursos
Certificaciones
Comunidad

Recursos

Revisa las actualizaciones de nuestras soluciones y operatividad del sistema o pide soporte técnico.

Comunidad

Recibe las últimas novedades, pide ayuda a otros integradores y comparte tus conocimientos.

Iniciar vinculación - Vinculaciones - Mercado Pago Developers

Búsqueda inteligente powered by OpenAI 

Iniciar vinculación

POST

https://api.mercadopago.com/v2/wallet_connect/agreements
Una vinculación es un link de autorización recibido por el comprador para permitir al vendedor acceder a su billetera de Mercado Pago con el fin de debitar el pago.
Parámetros para la solicitud
QUERY
client.id
number
ID único que identifica un cliente específico.
HEADER
x-platform-id
string
Campo destinado a plataformas o módulos que ofrecen Mercado Pago en sus soluciones.
BODY
return_uri
string
Es el URL que redirige al usuario de regreso al sitio del vendedor.
external_flow_id
string
Identifica el estado del flujo por el lado del vendedor.
external_user
object
El external_user contiene los datos que el vendedor necesitará para identificar un usuario a fin de que este pueda continuar con su propio flujo.
agreement_data
object
Contiene información sobre las acciones que el usuario debe realizar y el monto a pagar.
Parámetros de respuesta
agreement_id
string
ID único que identifica una vinculación.
agreement_uri
string
This is the uri to redirect the user to the wallet linking in the frontend.
Errores

400Error

400

Bad-Request

Solicitud
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-3322*********190-03031*********46528954c*********0339910-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"
  }
}'
Respuesta de ejemplo
{
  "agreement_id": "22abcd1235ed497f945f755fcaba3c6c",
  "agreement_uri": "https://wwww.mercadopago.com.ar/v1/wallet_agreement/22abcd1235ed497f945f755fcaba3c6c"
}