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.
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. |
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. |
| 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. |
| Operation | Path | Description |
| Calculate shipping ratesPOST | /shipping/v1/shipments-rates | Calculates the available shipping rates for a set of items and destination address. |
| Create shipmentPOST | /shipping/v1/shipments | Creates a shipment associated with a preference; returns the shipment identifier. |
| Get shipmentGET | /shipping/v1/shipments | Returns the detail and status of an existing shipment. |
| Cancel shipmentDELETE | /shipping/v1/shipments/{id} | Cancels a shipment before it is dispatched. |
| Get shipment labelGET | /shipping/v1/shipments/{id}/packages/{packageId}/label | Returns the shipment label in PDF format to print and attach to the package. |
| Track shipmentGET | /shipping/v1/shipments-tracking/{tracking_number} | Returns the tracking status of a shipment by its tracking number. |
| 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. |
SDKs
Use our official SDKs to integrate Checkout Pro faster. GitHub is the source of truth for each library.
All set to get started?
Go to the first endpoint and start creating your first payment preference.