Create agreement
POST
Products that use it:
Request's parameters
QUERY
client.id
Unique ID that identifies a specific client.number
HEADER
x-platform-id
Field intended for platforms or modules that offer Mercado Pago in their solutions.string
BODY
return_uri
URL that redirects the user back to the sellers site.string
external_flow_id
Identifies the Seller side flow current state.string
external_user
The external_user contains the data that the seller will need to use to indentify a User, so then it can continue with their own flow.object
agreement_data
Contains information about actions the user must do and the amount to be paid.object
Response parameters
agreement_id
Unique ID that identifies an agreement.string
agreement_uri
Esto es el uri para redirigir al usuario al enlace de la billetera en el frontend. .string
Errors
400Error
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 'x-platform-id: YOUR_PLATFORM_ID' \
-H 'Authorization: Bearer TEST-2151*********762-03031*********750b665b7*********4dac477-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"
}
}'Sample answer
{
"agreement_id": "22abcd1235ed497f945f755fcaba3c6c",
"agreement_uri": "https://wwww.mercadopago.com.ar/v1/wallet_agreement/22abcd1235ed497f945f755fcaba3c6c"
}