Obter vinculação

Endpoint para obter uma vinculação por ID. Uma vinculação é um link de autorização que o comprador recebe para permitir ao vendedor acessar a sua carteira do Mercado Pago a fim de debitar o pagamento.

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.
x-platform-id
string
Campo destinado às plataformas ou módulos que oferecem Mercado Pago em suas soluções.
Path
agreement_id
string

OBRIGATÓRIO

ID único que identifica uma vinculação.
Query
client.id
number
ID único que identifica um cliente.
Response parameters
id
string
ID único que identifica uma vinculação..
date_created
string
Data de criação da vinculação.
date_canceled
string
Data de cancelamento da vinculação.
date_expire
string
Data de vencimento da vinculação.
Erros

400Erro

400

Bad-Request

404Erro

404

Not-Found

500Erro

500

Error

Request
curl -X GET \
    'https://api.mercadopago.com/v2/wallet_connect/agreements/{agreement_id}?client.id=1451895580758649'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer APP_USR-1*********685765-12*********1b4332e5c*********e077d7679*********664' \
       -H 'x-platform-id: YOUR_PLATFORM_ID' \
    
Response
{
  "id": "b1234e5678b91c23a456e78912345b67",
  "date_created": "2023-02-16T00:02:52Z",
  "date_canceled": "2023-02-16T00:02:52Z",
  "date_expire": "2023-02-16T00:02:52Z",
  "validation_code": "790eb6591ff68df74c57930551ed980239f4538a7e530",
  "approval_uri": "https://www.mercadopago.com.ar/v1/wallet_agreement/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": 3.14,
    "description": "Test agreement"
  },
  "site_id": "MLA",
  "application_id": 123456789,
  "collector_id": 987654,
  "model_version": 2
}