Crear agreement - Flujo de vinculación de cuentas - Mercado Pago Developers

Crear agreement

La primera etapa para integrar Wallet Connect es la creación de un agreement, un link de autorización al que el comprador accede para otorgar al vendedor acceso a su billetera de Mercado Pago en el momento en que se efectúe un pago.

El agreement almacena los medios de pago seleccionados por el pagador y permite modificar estas configuraciones sin la intervención del vendedor, haciendo que esta etapa sea transparente durante el flujo de pago.

Consulte el siguiente diagrama que ilustra cómo funciona el flujo de creación de un agreement.

Crear 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_url": "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"
  }
}'

        
Importante
Un usuario sólo puede tener un agreement activo por integración. Si quieres crear un nuevo agreement, debes cancelar el anterior. Para cancelar un agreement, envía un DELETE al endpoint /v2/wallet_connect/agreements/{agreement_id} y ejecuta el request.