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

## Available endpoints

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

:::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/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/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/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/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-preferences/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-preferences/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="Payment methods" pill="Optional"}

| Operation | Path | Description |
|---|---|---|
| :TagComponent{tag="GET" text="Get payment methods" href="/developers/en/reference/online-payments/checkout-pro-preferences/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="Shipping" pill="Advanced"}

| Operation | Path | Description |
|---|---|---|
| :TagComponent{tag="POST" text="Calculate shipping rates" href="/developers/en/reference/online-payments/checkout-pro-preferences/shipping/calculate-shipping-rates/post" color="green"} | `/shipping/v1/shipments-rates` | Calculates the available shipping rates for a set of items and destination address. |
| :TagComponent{tag="POST" text="Create shipment" href="/developers/en/reference/online-payments/checkout-pro-preferences/shipping/create-shipment/post" color="green"} | `/shipping/v1/shipments` | Creates a shipment associated with a preference; returns the shipment identifier. |
| :TagComponent{tag="GET" text="Get shipment" href="/developers/en/reference/online-payments/checkout-pro-preferences/shipping/get-shipment/get" color="accent"} | `/shipping/v1/shipments` | Returns the detail and status of an existing shipment. |
| :TagComponent{tag="DELETE" text="Cancel shipment" href="/developers/en/reference/online-payments/checkout-pro-preferences/shipping/cancel-shipment/delete" color="red"} | `/shipping/v1/shipments/{id}` | Cancels a shipment before it is dispatched. |
| :TagComponent{tag="GET" text="Get shipment label" href="/developers/en/reference/online-payments/checkout-pro-preferences/shipping/get-shipment-label/get" color="accent"} | `/shipping/v1/shipments/{id}/packages/{packageId}/label` | Returns the shipment label in PDF format to print and attach to the package. |
| :TagComponent{tag="GET" text="Track shipment" href="/developers/en/reference/online-payments/checkout-pro-preferences/shipping/track-shipment/get" color="accent"} | `/shipping/v1/shipments-tracking/{tracking_number}` | Returns the tracking status of a shipment by its tracking number. |

:::

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

| Operation | Path | Description |
|---|---|---|
| :TagComponent{tag="GET" text="Get chargeback" href="/developers/en/reference/online-payments/checkout-pro-preferences/chargebacks/get-chargeback/get" color="accent"} | `/v1/chargebacks/{id}` | Retrieves a chargeback case by its ID returned in the _body_ of the [notification configured for chargebacks](/developers/en/docs/checkout-pro-preferences/chargebacks/notifications). Returns the chargeback details, including the dispute _status_, affected amount, and response deadline. |
| :TagComponent{tag="GET" text="Search chargebacks" href="/developers/en/reference/online-payments/checkout-pro-preferences/chargebacks/search-chargebacks/get" color="accent"} | `/v1/chargebacks/search` | Searches all chargebacks for a payment by its "payment_id" returned in the _body_ of the [notification configured for chargebacks](/developers/en/docs/checkout-pro-preferences/chargebacks/notifications). The search returns paginated results with the detail of each case. |
| :TagComponent{tag="POST" text="Upload supporting documentation" href="/developers/en/reference/online-payments/checkout-pro-preferences/chargebacks/upload-supporting-documentation/post" color="green"} | `/v1/chargebacks/{id}/documentation` | Uploads evidence files to dispute a chargeback while its _status_ ("documentation_status") is "pending". |
| :TagComponent{tag="GET" text="Get supporting documentation file" href="/developers/en/reference/online-payments/checkout-pro-preferences/chargebacks/get-supporting-documentation/get" color="accent"} | `/v1/chargebacks/documentation/{type}/{uuid}` | Downloads or renders inline a documentation file uploaded for a chargeback case. |

:::

<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/preferences/create-preference/post
---