AI resources
Wallet Connect
Wallet Connect allows you to process payments with the buyer's Mercado Pago wallet. The buyer authorizes access only once and then pays without entering data or logging in for each purchase. This reference describes the available endpoints and how to interact with them.
Looking for the step-by-step of this integration? Go to the Wallet Connect documentation.
Which type of integration should you use?
Choose according to your use case.
- Automatic and manual processing
- Two-step capture
- Payment and agreement notifications
- Automatic processing
- Agreement notifications
Via Orders API (Recommended)
Via Advanced Payments API (Legacy)
Available endpoints
All the endpoints that make up the Wallet Connect integration via Orders API.
The agreement is the mandatory stage in which the buyer authorizes the seller to debit payments from their Mercado Pago wallet.
| Operation | Path | Description |
| Create agreementPOST | /v2/wallet_connect/agreements | Creates a link between the integrator and the payer's Mercado Pago account and returns the authorization agreement_uri. |
| Generate payment tokenPOST | /v2/wallet_connect/agreements/{agreement_id}/payer_token | Exchanges the authorization code for the payer_token, the credential used to charge the buyer's wallet. |
| Get agreementGET | /v2/wallet_connect/agreements/{agreement_id} | Returns the information and status of an agreement from its identifier. |
| Cancel agreementDELETE | /v2/wallet_connect/agreements/{agreement_id} | Cancels an active agreement and revokes the associated payer_token. |
Payment processing endpoints.
| Operation | Path | Description |
| Create orderPOST | /v1/orders | Creates the order with the payer_token, debiting the amount from the wallet in automatic mode or only authorizing it in manual mode. |
| Capture order fullyPOST | /v1/orders/{order_id}/capture | Captures the authorized amount of an order created with capture_mode set to manual. |
| Get order by IDGET | /v1/orders/{id} | Returns the status and the complete detail of the order, including the processing attempts. |
| Cancel order by IDPOST | /v1/orders/{order_id}/cancel | Releases the authorization of an order not yet captured, without transferring any amount. |
| Refund an orderPOST | /v1/orders/{order_id}/refund | Refunds an order totally or partially. |
All set to start?
Access the first endpoint and start building your payment flow with the Orders API.