Criar agreement
A primeira etapa para integrar o Wallet Connect é a criação de um agreement, 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.
O agreement 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.
Confira o diagrama abaixo que ilustra como funciona o fluxo de criação do agreement.
Para criar um agreement, 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 obrigatórios para obter a aprovação do pagador: agreement_uri
e return_uri
.
curl -X POST \
'https://api.mercadopago.com/v2/wallet_connect/agreements?client.id=<CLIENT.ID>' \
-H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
-H 'Content-Type: application/json' \
-H 'x-platform-id: YOUR_ACCESS_TOKEN' \
-d '{
"return_url": "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"
}
}'