Recursos para IA
Obtener vinculación

Este endpoint permite retornar información de una vinculación existente a partir de su ID. En caso de éxito, la solicitud devolverá una respuesta con el estado 200.

GET

https://api.mercadopago.com/v2/wallet_connect/agreements/{agreement_id}
Request parameters
Header
Authorization
string

REQUERIDO

Access Token obtenido a través del panel de desarrollador. Obligatorio ser enviado en todas las solicitudes.
Path
agreement_id
string

REQUERIDO

Identificador único de la vinculación, devuelto en la respuesta del endpoint /v2/wallet_connect/agreements.
Response parameters
id
string
Identificador único de la vinculación.
date_created
string
Fecha y hora en que se creó la vinculación, en formato ISO 8601.
date_cancelled
string
Fecha y hora en que se canceló la vinculación, en formato ISO 8601.
date_expire
string
Fecha y hora en que expira la vinculación, en formato ISO 8601.
Errores

400Error de solicitud.

invalid_path_param

El agreement_id proporcionado en el path no es válido. Compruébalo y proporciona un agreement_id válido para volver a intentarlo.

403Prohibido.

forbidden

No tienes permiso para acceder al recurso solicitado. Verifica si el Access Token utilizado tiene los permisos y alcances necesarios para esta operación.

404Recurso no encontrado.

AgreementNotFound

No se encontró ninguna vinculación con el ID proporcionado. Esta misma respuesta se devuelve cuando la vinculación pertenece a otra aplicación (ClientNotOwner), a fin de evitar exponer la existencia de vinculaciones de otros clientes.

ClientNotOwner

La vinculación existe, pero no fue creada por la aplicación actual. Se devolverá la misma respuesta AgreementNotFound para evitar exponer la existencia de vinculaciones de otros clientes.

500Error genérico.

internal_error

Ocurrió un error interno en el servidor. Intenta nuevamente más tarde. Si el problema persiste, contacta al soporte y proporciona el x-request-id y detalles sobre la operación realizada.

Request
curl -X GET \
    'https://api.mercadopago.com/v2/wallet_connect/agreements/{agreement_id}'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer APP_USR-1*********685765-12*********1b4332e5c*********e077d7679*********664' \
    
Response
{
  "id": "b1234e5678b91c23a456e78912345b67",
  "date_created": "2023-02-16T00:02:52Z",
  "date_cancelled": "2023-02-16T00:02:52Z",
  "date_expire": "2023-02-16T00:02:52Z",
  "validation_code": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4",
  "agreement_code": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4",
  "approval_uri": "https://www.mercadopago.com.ar/wallet-connect/vinculation/onboarding?b1234e5678b91c23a456e78912345b67",
  "redirect_uri": "https://www.mercadopago.com/",
  "status": "CONFIRMED_BY_USER",
  "external_flow_id": "external_flow_id",
  "external_user": {
    "id": "usertest",
    "description": "Test account"
  },
  "agreement_data": {
    "validation_amount": "24.50",
    "description": "Test agreement"
  },
  "site_id": "MLA",
  "application_id": 123456789,
  "collector_id": 987654,
  "model_version": 2
}