AI resources
Checkout Pro
Checkout Pro redirects the buyer to a Mercado Pago environment to complete the payment. The flow centers on creating preferences from your backend. 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.
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. |
Merchant orders group all transactions associated with a preference. Useful for reconciliation and multi-payment tracking.
| Operation | Path | Description |
| Search merchant ordersGET | /merchant_orders/search | Searches merchant orders by filters such as preference_id or external_reference; returns paginated results. |
| Get merchant orderGET | /merchant_orders/{id} | Returns the detail of a merchant order: associated payments, total amount received, and status of each transaction. |
| Update merchant orderPUT | /merchant_orders/{id} | Updates the data of an existing merchant order. |
| 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 |
| Create cancellationPUT | /v1/payments/{id} | Cancels a pending payment before it is processed. |
| Operation | Path | Description |
| Create refundPOST | /v1/payments/{id}/refunds | Creates a full or partial refund; for a partial refund, include amount in the body. |
| Get refund listGET | /v1/payments/{id}/refunds | Lists the refunds for a payment; returns the amount, date, and status of each one. |
| Get specific refundGET | /v1/payments/{id}/refunds/{refund_id} | Returns the detail of a refund: processed amount, date, and status. |
| Operation | Path | Description |
| Get chargebackGET | /v1/chargebacks/{id} | Returns the detail of a chargeback: dispute status, affected amount, and deadline to respond. |
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.