--- product_landing_hero: - title: Wallet Connect - message: 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. - info: Looking for the step-by-step of this integration? [Go to the Wallet Connect documentation](/developers/en/docs/wallet-connect/overview). --- --- product_landing_what_it_offers: - title: Which type of integration should you use? - message: Choose according to your use case. - benefit_title: Via Orders API (Recommended) - benefit_bullet: Automatic and manual processing - benefit_bullet: Two-step capture - benefit_bullet: Payment and agreement notifications - benefit_title: Via Advanced Payments API (Legacy) - benefit_bullet: Automatic processing - benefit_bullet: Agreement notifications --- :::::TabsComponent ::::TabComponent{title="Via Orders API (Recommended)"} ## Available endpoints All the endpoints that make up the Wallet Connect integration via Orders API. :::AccordionComponent{title="Agreements" pill="Core"} The agreement is the mandatory stage in which the buyer authorizes the seller to debit payments from their Mercado Pago wallet. | Operation | Path | Description | |---|---|---| | :TagComponent{tag="POST" text="Create agreement" href="/developers/en/reference/online-payments/wallet-connect/orders/create-agreement/post" color="green"} | `/v2/wallet_connect/agreements` | Creates a link between the integrator and the payer's Mercado Pago account and returns the authorization `agreement_uri`. | | :TagComponent{tag="POST" text="Generate payment token" href="/developers/en/reference/online-payments/wallet-connect/orders/generate-payer-token/post" color="green"} | `/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. | | :TagComponent{tag="GET" text="Get agreement" href="/developers/en/reference/online-payments/wallet-connect/orders/get-agreement/get" color="accent"} | `/v2/wallet_connect/agreements/{agreement_id}` | Returns the information and status of an agreement from its identifier. | | :TagComponent{tag="DELETE" text="Cancel agreement" href="/developers/en/reference/online-payments/wallet-connect/orders/cancel-agreement/delete" color="red"} | `/v2/wallet_connect/agreements/{agreement_id}` | Cancels an active agreement and revokes the associated `payer_token`. | ::: :::AccordionComponent{title="Orders" pill="Core"} Payment processing endpoints. | Operation | Path | Description | |---|---|---| | :TagComponent{tag="POST" text="Create order" href="/developers/en/reference/online-payments/wallet-connect/orders/create-order/post" color="green"} | `/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. | | :TagComponent{tag="POST" text="Capture order fully" href="/developers/en/reference/online-payments/wallet-connect/orders/capture-order/post" color="green"} | `/v1/orders/{order_id}/capture` | Captures the authorized amount of an order created with `capture_mode` set to `manual`. | | :TagComponent{tag="GET" text="Get order by ID" href="/developers/en/reference/online-payments/wallet-connect/orders/get-order/get" color="accent"} | `/v1/orders/{id}` | Returns the status and the complete detail of the order, including the processing attempts. | | :TagComponent{tag="POST" text="Cancel order by ID" href="/developers/en/reference/online-payments/wallet-connect/orders/cancel-order/post" color="green"} | `/v1/orders/{order_id}/cancel` | Releases the authorization of an order not yet captured, without transferring any amount. | | :TagComponent{tag="POST" text="Refund an order" href="/developers/en/reference/online-payments/wallet-connect/orders/refund-order/post" color="green"} | `/v1/orders/{order_id}/refund` | Refunds an order totally or partially. | ::: --- product_landing_how_integrate: - title: All set to start? - sub_title: Access the first endpoint and start building your payment flow with the Orders API. - button_description: Create agreement - button_link: /developers/en/reference/online-payments/wallet-connect/orders/create-agreement/post --- :::: ::::TabComponent{title="Via Advanced Payments API (Legacy)"} > WARNING > > **This type of integration is not recommended.** The Advanced Payments API will continue to be supported, but new features will be available only in the Orders API. If you are starting a new integration, [use the Orders API](/developers/en/reference/online-payments/wallet-connect/orders/create-order/post). ## Available endpoints All the endpoints that make up the Wallet Connect integration via Advanced Payments API. :::AccordionComponent{title="Agreements" pill="Core"} The agreement is the mandatory stage in which the buyer authorizes the seller to debit payments from their Mercado Pago wallet. | Operation | Path | Description | |---|---|---| | :TagComponent{tag="POST" text="Create agreement" href="/developers/en/reference/online-payments/wallet-connect/advanced-payments-legacy/create-agreement/post" color="green"} | `/v2/wallet_connect/agreements` | Creates a link between the integrator and the payer's Mercado Pago account and returns the authorization `agreement_uri`. | | :TagComponent{tag="POST" text="Generate payment token" href="/developers/en/reference/online-payments/wallet-connect/advanced-payments-legacy/generate-payer-token/post" color="green"} | `/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. | | :TagComponent{tag="GET" text="Get agreement" href="/developers/en/reference/online-payments/wallet-connect/advanced-payments-legacy/get-agreement/get" color="accent"} | `/v2/wallet_connect/agreements/{agreement_id}` | Returns the information and status of an agreement from its identifier. | | :TagComponent{tag="DELETE" text="Cancel agreement" href="/developers/en/reference/online-payments/wallet-connect/advanced-payments-legacy/cancel-agreement/delete" color="red"} | `/v2/wallet_connect/agreements/{agreement_id}` | Cancels an active agreement and revokes the associated `payer_token`. | ::: :::AccordionComponent{title="Payments" pill="Core"} Payment processing endpoints. | Operation | Path | Description | |---|---|---| | :TagComponent{tag="POST" text="Create payment" href="/developers/en/reference/online-payments/wallet-connect/advanced-payments-legacy/create-payment/post" color="green"} | `/v1/advanced_payments` | Creates an advanced payment with two-step capture. | | :TagComponent{tag="GET" text="Get payment" href="/developers/en/reference/online-payments/wallet-connect/advanced-payments-legacy/get-payment/get" color="accent"} | `/v1/advanced_payments/{advanced_payment_id}` | Returns the details of an advanced payment from its identifier. | | :TagComponent{tag="POST" text="Refund payment" href="/developers/en/reference/online-payments/wallet-connect/advanced-payments-legacy/refund-payment/post" color="green"} | `/v1/advanced_payments/{advanced_payment_id}/refunds` | Performs the total or partial refund of an advanced payment. | ::: --- product_landing_how_integrate: - title: All set to start? - sub_title: Access the first endpoint and start building your payment flow with the Advanced Payments API. - button_description: Create payment - button_link: /developers/en/reference/online-payments/wallet-connect/advanced-payments-legacy/create-payment/post --- :::: :::::