Iniciar vinculação
A primeira etapa para integrar o Wallet Connect é a criação de uma vinculação, um link de autorização que o comprador acessa para conceder ao vendedor o acesso à sua carteira do Mercado Pago no momento em que um pagamento for realizado.
A vinculação armazena os meios de pagamento selecionados pelo pagador e permite a alteração dessas configuraçÔes sem a intervenção do vendedor, tornando esta etapa transparente durante o fluxo de pagamento.
Qualquer mudança nos métodos de pagamento é comunicada através de uma notificação Webhooks, que traz detalhes da atualização. Para mais informaçÔes, consulte a seção Atualização do meio de pagamento de uma vinculação.
Confira o diagrama abaixo que ilustra como funciona o fluxo de criação da vinculação.
Para criar uma vinculação, envie um POST com os atributos necessårios ao endpoint /v2/wallet_connect/agreements e execute a requisição ou, se preferir, utilize o curl
abaixo e atente-se à resposta da requisição que retornarå dois parùmetros necessårios para obter a aprovação do pagador: agreement_id
e agreement_uri
.
curl
curl -X POST \ 'https://api.mercadopago.com/v2/wallet_connect/agreements' \ -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \ -H 'Content-Type: application/json' \ -H 'x-platform-id: YOUR_PLATFORM_ID' \ -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" } }'
Resposta
json
{ "agreement_id": "22abcd1235ed497f945f755fcaba3c6c", "agreement_uri": "https://wwww.mercadopago.com.ar/v1/wallet_agreement/22abcd1235ed497f945f755fcaba3c6c" }