Crear Agreement
El primer paso para integrar Wallet Connect es la creación de un agreement, un enlace de autorización que el comprador utiliza para conceder al vendedor acceso a su billetera de Mercado Pago en el momento en que se realiza un pago.
El agreement almacena los métodos de pago seleccionados por el pagador y permite la modificación de estas configuraciones sin la intervención del vendedor, lo que hace que esta etapa sea transparente durante el flujo de pago.
Cualquier cambio en los medios de pago se comunica a través de una notificación webhook, que proporciona detalles de la actualización. Para más información, consulte la sección Actualización del medio de pago de un agreement.
Consulte el siguiente diagrama que ilustra cómo funciona el flujo de creación de un agreement.
Para crear un agreement, envía un POST con los atributos necesarios al endpoint /v2/wallet_connect/agreements y ejecuta el requestr o, si lo prefiere, use el curl
a continuación y preste atención a la respuesta del request que devolverá dos parámetros obligatorios para obtener la aprobación del pagador: agreement_uri
y return_uri
.
curl -X POST \
'https://api.mercadopago.com/v2/wallet_connect/agreements?client.id=<CLIENT.ID>' \
-H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
-H 'Content-Type: application/json' \
-H 'x-platform-id: YOUR_ACCESS_TOKEN' \
-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
{
"agreement_id": "22abcd1235ed497f945f755fcaba3c6c",
"agreement_uri": "https://wwww.mercadopago.com.ar/v1/wallet_agreement/22abcd1235ed497f945f755fcaba3c6c"
}