---
product_landing_hero:
 - title: Checkout Pro
 - message: 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.
 - info: Looking for integration steps? [Go to Checkout Pro documentation](/developers/en/docs/checkout-pro/overview).
---

## Available endpoints

All endpoints that make up the Checkout Pro integration.

:::AccordionComponent{title="Preferences" pill="Core"}

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 |
|---|---|---|
| :TagComponent{tag="POST" text="Create preference" href="/developers/en/reference/online-payments/checkout-pro/preferences/create-preference/post" color="green"} | `/checkout/preferences` | Creates a preference with items, prices, and `back_urls`; returns the `init_point` to redirect the buyer. |
| :TagComponent{tag="GET" text="Search preferences" href="/developers/en/reference/online-payments/checkout-pro/preferences/search-preferences/get" color="accent"} | `/checkout/preferences/search` | Searches preferences by filters such as `external_reference` or date; returns paginated results. |
| :TagComponent{tag="GET" text="Get preference" href="/developers/en/reference/online-payments/checkout-pro/preferences/get-preference/get" color="accent"} | `/checkout/preferences/{id}` | Returns the detail of a preference: `init_point`, items, and configured `back_urls`. |
| :TagComponent{tag="PUT" text="Update preference" href="/developers/en/reference/online-payments/checkout-pro/preferences/update-preference/put" color="orange"} | `/checkout/preferences/{id}` | Updates an existing preference before the buyer completes the payment. |

:::

:::AccordionComponent{title="Payments" pill="Query"}

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

| Operation | Path | Description |
|---|---|---|
| :TagComponent{tag="GET" text="Search payments" href="/developers/en/reference/online-payments/checkout-pro/search-payments/get" color="accent"} | `/v1/payments/search` | Searches payments by filters such as `external_reference`, status, or date; returns paginated results. |
| :TagComponent{tag="GET" text="Get payment" href="/developers/en/reference/online-payments/checkout-pro/get-payment/get" color="accent"} | `/v1/payments/{id}` | Returns the status and detail of the payment, including `status_detail`, to confirm the result after the notification. |

:::

:::AccordionComponent{title="Merchant orders" pill="Advanced"}

Merchant orders group all transactions associated with a preference. Useful for reconciliation and multi-payment tracking.

| Operation | Path | Description |
|---|---|---|
| :TagComponent{tag="GET" text="Search merchant orders" href="/developers/en/reference/online-payments/checkout-pro/merchant_orders/search-merchant-order/get" color="accent"} | `/merchant_orders/search` | Searches merchant orders by filters such as `preference_id` or `external_reference`; returns paginated results. |
| :TagComponent{tag="GET" text="Get merchant order" href="/developers/en/reference/online-payments/checkout-pro/merchant_orders/get-merchant-order/get" color="accent"} | `/merchant_orders/{id}` | Returns the detail of a merchant order: associated payments, total amount received, and status of each transaction. |
| :TagComponent{tag="PUT" text="Update merchant order" href="/developers/en/reference/online-payments/checkout-pro/merchant_orders/update-merchant-order/put" color="orange"} | `/merchant_orders/{id}` | Updates the data of an existing merchant order. |

:::

:::AccordionComponent{title="Payment methods" pill="Optional"}

| Operation | Path | Description |
|---|---|---|
| :TagComponent{tag="GET" text="Get payment methods" href="/developers/en/reference/online-payments/checkout-pro/payment_methods/get" color="accent"} | `/v1/payment_methods` | Lists the payment methods available for the site, to include or exclude them in the preference. |

:::

:::AccordionComponent{title="Cancellations" pill="Post-payment management"}

| Operation | Path | Description |
|---|---|---|
| :TagComponent{tag="PUT" text="Create cancellation" href="/developers/en/reference/online-payments/checkout-pro/create-cancellation/put" color="orange"} | `/v1/payments/{id}` | Cancels a pending payment before it is processed. |

:::

:::AccordionComponent{title="Refunds" pill="Post-payment management"}

| Operation | Path | Description |
|---|---|---|
| :TagComponent{tag="POST" text="Create refund" href="/developers/en/reference/online-payments/checkout-pro/create-refund/post" color="green"} | `/v1/payments/{id}/refunds` | Creates a full or partial refund; for a partial refund, include `amount` in the body. |
| :TagComponent{tag="GET" text="Get refund list" href="/developers/en/reference/online-payments/checkout-pro/get-refunds/get" color="accent"} | `/v1/payments/{id}/refunds` | Lists the refunds for a payment; returns the amount, date, and status of each one. |
| :TagComponent{tag="GET" text="Get specific refund" href="/developers/en/reference/online-payments/checkout-pro/get-refund/get" color="accent"} | `/v1/payments/{id}/refunds/{refund_id}` | Returns the detail of a refund: processed amount, date, and status. |

:::

:::AccordionComponent{title="Chargebacks" pill="Post-payment management"}

| Operation | Path | Description |
|---|---|---|
| :TagComponent{tag="GET" text="Get chargeback" href="/developers/en/reference/online-payments/checkout-pro/chargebacks/get" color="accent"} | `/v1/chargebacks/{id}` | Returns the detail of a chargeback: dispute status, affected amount, and deadline to respond. |

:::

<br>
<br>

## SDKs

Use our official SDKs to integrate Checkout Pro faster. GitHub is the source of truth for each library.

:::LinksListComponent
- [SDK Java](https://github.com/mercadopago/sdk-java)
- [SDK Python](https://github.com/mercadopago/sdk-python)
- [SDK PHP](https://github.com/mercadopago/sdk-php)
- [SDK Node.js](https://github.com/mercadopago/sdk-nodejs)
- [SDK Ruby](https://github.com/mercadopago/sdk-ruby)
- [SDK .NET](https://github.com/mercadopago/sdk-dotnet)
:::

<br>
<br>

---
product_landing_how_integrate:
 - title: All set to get started?
 - sub_title: Go to the first endpoint and start creating your first payment preference.
 - button_description: Create preference
 - button_link: /developers/en/reference/online-payments/checkout-pro/preferences/create-preference/post
---