Crear agreement - Agreements - Mercado Pago Developers
¿Qué documentación quieres buscar?

¿No sabes cómo empezar la integración? 

Accede a los primeros pasos
Crear Agreement

POST

https://api.mercadopago.com/v2/wallet_connect/agreements
Un Agreement 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
agreement_data
object
Contiene información sobre las acciones que el usuario debe realizar y el monto a pagar
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.
return_url
string
Es el URL que redirige al usuario de regreso al sitio del vendedor
Parámetros de respuesta
agreement_id
string
ID único que identifica un Agreement
agreement_uri
string
This is the uri to redirect the user to the wallet linking in the frontend
Errores

400Error

400

Bad-Request

400

Bad-Request

400

Bad-Request

400

Bad-Request

400

Bad-Request

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_ACCESS_TOKEN' \,
       -H 'Authorization: Bearer TEST-3322*********190-03031*********46528954c*********0339910-1*********' \
       -d '{
  "agreement_data": {
    "validation_amount": 3.14,
    "description": "Test agreement"
  },
  "external_flow_id": "EXTERNAL_FLOW_ID",
  "external_user": {
    "id": "usertest",
    "description": "Test account"
  },
  "return_url": "https://www.mercadopago.com/"
}'
Respuesta de ejemplo
{
  "agreement_id": "b1234e5678b91c23a456e78912345b67",
  "agreement_uri": "https://beta.mercadopago.com.ar/v1/wallet_agreement/b1234e5678b91c23a456e78912345b67"
}