Este endpoint permite crear una vinculación entre comprador y vendedor, generando un enlace de autorización que se enviará 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 201.
POST
REQUERIDO
REQUERIDO
REQUERIDO
400Error de solicitud.
RedirectUriMismatch
La URI de redirección no coincide con la registrada para esta aplicación. Verifica el valor enviado en return_uri y confirma que esté registrado en las configuraciones de tu aplicación.
ReturnUriNull
El campo return_uri es requerido y no fue enviado. Vuelve a realizar la solicitud incluyéndolo.
ExternalFlowIdTooLong
El valor de external_flow_id excede la longitud máxima permitida de 64 caracteres. Reduce el tamaño del identificador enviado.
ReturnUriTooLong
El valor de return_uri excede la longitud máxima permitida de 2048 caracteres. Reduce el tamaño de la URI enviada.
ExternalUserNull
El campo external_user es requerido y no fue enviado. Vuelve a realizar la solicitud incluyendo el identificador del comprador en tu sistema.
AgreementDataDescriptionInvalid
El valor de agreement_data.description es inválido. Verifica el contenido enviado y respeta el límite de 256 caracteres.
403Prohibido.
forbidden
No tienes permiso para acceder al recurso solicitado. Verifica si el Access Token utilizado tiene los permisos y alcances necesarios para esta operación.
500Error genérico.
internal_error
Ocurrió un error interno en el servidor. Intenta nuevamente más tarde. Si el problema persiste, contacta al soporte y proporciona el x-request-id y detalles sobre la operación realizada.
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-1*********685765-12*********1b4332e5c*********e077d7679*********664' \
-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"
}
}'{
"agreement_id": "22abcd1235ed497f945f755fcaba3c6c",
"agreement_uri": "https://www.mercadopago.com.ar/wallet-connect/vinculation/onboarding?22abcd1235ed497f945f755fcaba3c6c"
}