Crear agreement - Flujo de vinculación de cuentas - Mercado Pago Developers
¿Qué estás buscando?

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

Accede a los primeros pasos

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.

Importante
Un usuario puede tener solo un agreement activo por integración. Para crear un nuevo agreement, es necesario cancelar el anterior. Para ello, envíe un DELETE al endpoint /v2/wallet_connect/agreements/{agreement_id} y ejecute la solicitud. Tras la cancelación, se enviará una notificación webhook con todos los detalles de la operación. Para entender el proceso con más detalle, visite la sección Cancelación de agreement entre integrador y Mercado 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_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"
}