Iniciar vinculación - Flujo de vinculación de cuentas - Mercado Pago Developers
¿Qué documentación quieres buscar?

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

Accede a los primeros pasos

Iniciar vinculación

El primer paso para integrar Wallet Connect es la creación de una vinculación, 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.

La vinculación 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 Webhooks, que proporciona detalles de la actualización. Para más información, consulte la sección Actualización del medio de pago de una vinculación.

Importante
Un usuario puede tener solo una vinculación activo por integración. Para crear una nueva vinculación, 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 vinculación entre integrador y Mercado Pago .

Consulte el siguiente diagrama que ilustra cómo funciona el flujo de creación de una vinculación.

Iniciar vinculación

Para crear una vinculación, 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"
}