API Reference - Mercado Pago Developers

AI resources

Checkout Pro Checkout Pro redirects the buyer to a Mercado Pago environment to complete the payment. You integrate it using the Preferences API. This reference describes the available endpoints and how to interact with them. Looking for integration steps? Go to Checkout Pro documentation.

Available endpoints

All endpoints that make up the Checkout Pro integration via Preferences API.

Preferences

The preference is the central object of Checkout Pro. It defines the items, amounts, enabled payment methods, and the buyer's return URLs.

Operation	Path	Description
Create preferencePOST	`/checkout/preferences`	Creates a preference with items, prices, and `back_urls`; returns the `init_point` to redirect the buyer.
Search preferencesGET	`/checkout/preferences/search`	Searches preferences by filters such as `external_reference` or date; returns paginated results.
Get preferenceGET	`/checkout/preferences/{id}`	Returns the detail of a preference: `init_point`, items, and configured `back_urls`.
Update preferencePUT	`/checkout/preferences/{id}`	Updates an existing preference before the buyer completes the payment.

Payments

Read-only endpoints to verify the status of a payment after receiving the webhook notification or the return redirect.

Operation	Path	Description
Search paymentsGET	`/v1/payments/search`	Searches payments by filters such as `external_reference`, status, or date; returns paginated results.
Get paymentGET	`/v1/payments/{id}`	Returns the status and detail of the payment, including `status_detail`, to confirm the result after the notification.

Payment methods

Operation	Path	Description
Get payment methodsGET	`/v1/payment_methods`	Lists the payment methods available for the site, to include or exclude them in the preference.

Chargebacks

Operation	Path	Description
Get chargebackGET	`/v1/chargebacks/{id}`	Retrieves a chargeback case by its ID returned in the body of the notification configured for chargebacks. Returns the chargeback details, including the dispute status, affected amount, and response deadline.
Search chargebacksGET	`/v1/chargebacks/search`	Searches all chargebacks for a payment by its "payment_id" returned in the body of the notification configured for chargebacks. The search returns paginated results with the detail of each case.
Upload supporting documentationPOST	`/v1/chargebacks/{id}/documentation`	Uploads evidence files to dispute a chargeback while its status ("documentation_status") is "pending".
Get supporting documentation fileGET	`/v1/chargebacks/documentation/{type}/{uuid}`	Downloads or renders inline a documentation file uploaded for a chargeback case.