Este endpoint permite criar uma vinculação entre comprador e vendedor, gerando um link de autorização a ser enviado ao comprador para que o vendedor possa acessar sua carteira do Mercado Pago e processar pagamentos. Em caso de sucesso, a requisição retornará uma resposta com o status 201.
POST
OBRIGATÓRIO
OBRIGATÓRIO
OBRIGATÓRIO
400Erro de requisição.
RedirectUriMismatch
O URI de redirecionamento não corresponde ao registrado para esta aplicação. Verifique o valor enviado em return_uri e confirme que ele está registrado nas configurações da sua aplicação.
ReturnUriNull
O campo return_uri é obrigatório e não foi informado. Faça a requisição novamente incluindo-o.
ExternalFlowIdTooLong
O valor de external_flow_id excede o comprimento máximo permitido de 64 caracteres. Reduza o tamanho do identificador enviado.
ReturnUriTooLong
O valor de return_uri excede o comprimento máximo permitido de 2048 caracteres. Reduza o tamanho da URI enviada.
ExternalUserNull
O campo external_user é obrigatório e não foi informado. Faça a requisição novamente incluindo o identificador do comprador em seu sistema.
AgreementDataDescriptionInvalid
O valor de agreement_data.description é inválido. Verifique o conteúdo enviado e respeite o limite de 256 caracteres.
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.
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.
curl -X POST \
'https://api.mercadopago.com/v2/wallet_connect/agreements?client.id=<CLIENT_ID>'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer APP_USR-4*********782856-12*********f202ca494*********f0baa4bb3*********648' \
-d '{
"return_uri": "https://www.mercadopago.com/",
"external_flow_id": "EXTERNAL_FLOW_ID",
"external_user": {
"id": "usertest",
"description": "Test account"
},
"agreement_data": {
"validation_amount": 24.5,
"description": "Test agreement"
}
}'{
"agreement_id": "22abcd1235ed497f945f755fcaba3c6c",
"agreement_uri": "https://www.mercadopago.com.co/wallet-connect/vinculation/onboarding?22abcd1235ed497f945f755fcaba3c6c"
}