Recursos para IA
Obter vinculação

Este endpoint permite retornar informações de uma vinculação existente a partir de seu ID. Em caso de sucesso, a requisição retornará uma resposta com o status 200.

GET

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

OBRIGATÓRIO

Access Token obtido através do painel de desenvolvedores. Obrigatório ser enviado em todas as requisições.
Path
agreement_id
string

OBRIGATÓRIO

Identificador único da vinculação, retornado na resposta do endpoint /v2/wallet_connect/agreements.
Response parameters
id
string
Identificador único da vinculação.
date_created
string
Data e hora em que a vinculação foi criada, no formato ISO 8601.
date_cancelled
string
Data e hora em que a vinculação foi cancelada, no formato ISO 8601.
date_expire
string
Data e hora em que a vinculação expira, no formato ISO 8601.
Erros

400Erro de requisição.

invalid_path_param

O agreement_id fornecido no path não é válido. Verifique e forneça um agreement_id válido para tentar novamente.

403Proibido.

forbidden

Você não tem permissão para acessar o recurso solicitado. Verifique se o Access Token utilizado tem as permissões e escopos necessários para esta operação.

404Recurso não encontrado.

AgreementNotFound

Nenhuma vinculação foi encontrada com o ID informado. Essa mesma resposta é retornada quando a vinculação pertence a outra aplicação (ClientNotOwner), a fim de evitar expor a existência de vinculações de outros clientes.

ClientNotOwner

A vinculação existe, mas não foi criada pela aplicação atual. A mesma resposta de AgreementNotFound será retornada para evitar expor a existência de vinculações de outros clientes.

500Erro genérico.

internal_error

Ocorreu um erro interno no servidor. Tente novamente mais tarde. Se o problema persistir, entre em contato com o suporte e forneça o x-request-id e detalhes sobre a operação 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*********550113-12*********b4773884a*********e8df16347*********786' \
    
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.pe/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": "MPE",
  "application_id": 123456789,
  "collector_id": 987654,
  "model_version": 2
}