---
product_landing_hero:
 - title: Checkout API
 - message: Checkout API allows you to process payments directly on your site or app, without redirecting the buyer to an external page. It supports credit and debit cards, cash, and other local payment methods. This reference describes the available endpoints and how to interact with them.
 - info: Looking for integration steps? [Go to the Checkout API documentation](/developers/en/docs/checkout-api-orders/overview).
---

---
product_landing_what_it_offers:
 - title: Which integration path should you use?
 - message: Choose based on your use case.
 - benefit_title: Via Orders API (Recommended)
 - benefit_bullet: Automatic and manual processing
 - benefit_bullet: Deferred fund capture
 - benefit_bullet: New features and simplified notifications
 - benefit_title: Via Payments API (Legacy)
 - benefit_bullet: Automatic processing
 - benefit_bullet: Deferred fund capture
---

:::::TabsComponent

::::TabComponent{title="Via Orders API (Recommended)"}

## Available endpoints

All endpoints that make up the Checkout API integration via Orders.

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

| Operation | Path | Description |
|---|---|---|
| :TagComponent{tag="POST" text="Create order" href="/developers/en/reference/online-payments/checkout-api/create-order/post" color="green"} | `/v1/orders` | Creates a new order in `automatic` mode (one-step payment) or `manual` mode (authorize and capture separately); returns the `order_id`. |
| :TagComponent{tag="POST" text="Capture order completely" href="/developers/en/reference/online-payments/checkout-api/capture-order/post" color="green"} | `/v1/orders/{id}/capture` | Captures the full amount of an order in `manual` mode; only valid for credit cards. |
| :TagComponent{tag="POST" text="Add transactions to order" href="/developers/en/reference/online-payments/checkout-api/add-transaction-order/post" color="green"} | `/v1/orders/{id}/transactions` | Adds a transaction to an order in manual mode with `card_token`, `installments`, and `payment_method_id`. |
| :TagComponent{tag="DELETE" text="Delete a transaction from the order" href="/developers/en/reference/online-payments/checkout-api/delete-transaction-order/delete" color="red"} | `/v1/orders/{id}/transactions/{transaction_id}` | Deletes a transaction before calling `/process`, to correct the payment method or amount in manual mode. |
| :TagComponent{tag="PUT" text="Update a transaction of the order" href="/developers/en/reference/online-payments/checkout-api/update-transaction-order/put" color="orange"} | `/v1/orders/{id}/transactions/{transaction_id}` | Updates the data of an existing transaction in an order in manual mode. |
| :TagComponent{tag="POST" text="Process order by ID" href="/developers/en/reference/online-payments/checkout-api/process-order/post" color="green"} | `/v1/orders/{id}/process` | Triggers payment authorization; the order transitions to `approved`, `pending`, `rejected`, or `failed`. |
| :TagComponent{tag="GET" text="Search order" href="/developers/en/reference/online-payments/checkout-api/search-order/get" color="accent"} | `/v1/orders/search` | Searches orders by filters such as date, status, or `external_reference`; returns paginated results. |
| :TagComponent{tag="GET" text="Get order by ID" href="/developers/en/reference/online-payments/checkout-api/get-order/get" color="accent"} | `/v1/orders/{id}` | Returns the status and full detail of the order, including its transactions and the active `processing_mode`. |
| :TagComponent{tag="POST" text="Cancel order by ID" href="/developers/en/reference/online-payments/checkout-api/cancel-order/post" color="green"} | `/v1/orders/{id}/cancel` | Cancels an order before processing it or when the payment resulted in a rejected or pending status. |
| :TagComponent{tag="POST" text="Refund an order" href="/developers/en/reference/online-payments/checkout-api/refund-order/post" color="green"} | `/v1/orders/{id}/refund` | Refunds an order totally or partially. |

:::

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

| Operation | Path | Description |
|---|---|---|
| :TagComponent{tag="GET" text="Get payment methods" href="/developers/en/reference/online-payments/checkout-api/payment-methods/get" color="accent"} | `/v1/payment_methods` | Lists the payment methods available for the site (cards, tickets, wallets, etc.) to display the options in the checkout. |

:::

:::AccordionComponent{title="Identification types" pill="Optional"}

| Operation | Path | Description |
|---|---|---|
| :TagComponent{tag="GET" text="Get identification types" href="/developers/en/reference/online-payments/checkout-api/identification-types/get" color="accent"} | `/v1/identification_types` | Lists the identification types available by country to complete the payer's form. |

:::

:::AccordionComponent{title="Cards" pill="Advanced"}

Endpoints for saving and managing customer cards. Useful for reducing friction in recurring purchases.

| Operation | Path | Description |
|---|---|---|
| :TagComponent{tag="POST" text="Save card" href="/developers/en/reference/online-payments/checkout-api/cards/save-card/post" color="green"} | `/v1/customers/{customer_id}/cards` | Associates a tokenized card to a customer from a `card_token` generated with MercadoPago.js. |
| :TagComponent{tag="GET" text="Get customer cards" href="/developers/en/reference/online-payments/checkout-api/cards/get-customer-cards/get" color="accent"} | `/v1/customers/{customer_id}/cards` | Lists the tokenized cards saved for a customer. |
| :TagComponent{tag="GET" text="Get card" href="/developers/en/reference/online-payments/checkout-api/cards/get-card/get" color="accent"} | `/v1/customers/{customer_id}/cards/{card_id}` | Returns the data of a saved card: last 4 digits, brand, and expiration date. |
| :TagComponent{tag="PUT" text="Update card" href="/developers/en/reference/online-payments/checkout-api/cards/update-card/put" color="orange"} | `/v1/customers/{customer_id}/cards/{card_id}` | Updates the data of a saved tokenized card. |
| :TagComponent{tag="DELETE" text="Delete card" href="/developers/en/reference/online-payments/checkout-api/cards/delete-card/delete" color="red"} | `/v1/customers/{customer_id}/cards/{card_id}` | Deletes a saved card from the customer. |

:::

:::AccordionComponent{title="Customers" pill="Advanced"}

Endpoints for creating and managing customer profiles and saving their payment methods.

| Operation | Path | Description |
|---|---|---|
| :TagComponent{tag="POST" text="Create customer" href="/developers/en/reference/online-payments/checkout-api/customers/create-customer/post" color="green"} | `/v1/customers` | Creates a customer record whose `customer_id` is required to manage their cards and addresses. |
| :TagComponent{tag="GET" text="Search in customers" href="/developers/en/reference/online-payments/checkout-api/customers/search-customer/get" color="accent"} | `/v1/customers/search` | Searches customers by email or other filters; returns paginated results. |
| :TagComponent{tag="GET" text="Get customer" href="/developers/en/reference/online-payments/checkout-api/customers/get-customer/get" color="accent"} | `/v1/customers/{id}` | Returns the customer's data, including saved payment methods and metadata. |
| :TagComponent{tag="PUT" text="Update customer" href="/developers/en/reference/online-payments/checkout-api/customers/update-customer/put" color="orange"} | `/v1/customers/{id}` | Updates a customer's data. |

:::

:::AccordionComponent{title="Addresses" pill="Advanced"}

Endpoints for managing the addresses associated with customers.

| Operation | Path | Description |
|---|---|---|
| :TagComponent{tag="POST" text="Create address" href="/developers/en/reference/online-payments/checkout-api/addresses/create-address/post" color="green"} | `/v1/customers/{customer_id}/addresses` | Registers a shipping address for the customer. |
| :TagComponent{tag="GET" text="List addresses" href="/developers/en/reference/online-payments/checkout-api/addresses/list-addresses/get" color="accent"} | `/v1/customers/{customer_id}/addresses` | Lists the shipping addresses saved for a customer. |
| :TagComponent{tag="GET" text="Get address" href="/developers/en/reference/online-payments/checkout-api/addresses/get-address/get" color="accent"} | `/v1/customers/{customer_id}/addresses/{address_id}` | Returns the detail of a saved shipping address. |
| :TagComponent{tag="PUT" text="Update address" href="/developers/en/reference/online-payments/checkout-api/addresses/update-address/put" color="orange"} | `/v1/customers/{customer_id}/addresses/{address_id}` | Updates the data of a saved shipping address. |
| :TagComponent{tag="DELETE" text="Delete an address" href="/developers/en/reference/online-payments/checkout-api/addresses/delete-address/delete" color="red"} | `/v1/customers/{customer_id}/addresses/{address_id}` | Deletes a shipping address from the customer. |

:::

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

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

:::

---
product_landing_how_integrate:
 - title: All set to get started?
 - sub_title: Go to the first endpoint and start building your payment flow with the Orders API.
 - button_description: Create order
 - button_link: /developers/en/reference/online-payments/checkout-api/create-order/post
---

::::

::::TabComponent{title="Via Payments API (Legacy)"}

> WARNING
>
> **This integration path is not recommended.** The Payments API will continue to be supported, but new features will be available only in the Orders API. If you are starting a new integration, [use the Orders API](/developers/en/reference/online-payments/checkout-api/create-order/post). If you already have a Payments integration, see the [Orders integration model](/developers/en/docs/checkout-api-orders/integration-model) to plan your migration.

## Available endpoints

All endpoints that make up the Checkout API integration via Payments.

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

| Operation | Path | Description |
|---|---|---|
| :TagComponent{tag="POST" text="Create payment" href="/developers/en/reference/online-payments/checkout-api-payments/create-payment/post" color="green"} | `/v1/payments` | Creates a payment with a tokenized card, specifying the amount, installments, payment method, and payer information. |
| :TagComponent{tag="GET" text="Search in payments" href="/developers/en/reference/online-payments/checkout-api-payments/search-payments/get" color="accent"} | `/v1/payments/search` | Searches payments by filters such as date, status, or `external_reference`; returns paginated results. |
| :TagComponent{tag="GET" text="Get payment" href="/developers/en/reference/online-payments/checkout-api-payments/get-payment/get" color="accent"} | `/v1/payments/{id}` | Returns the status and detail of a payment, including `status_detail` to diagnose rejections. |
| :TagComponent{tag="PUT" text="Update payment" href="/developers/en/reference/online-payments/checkout-api-payments/update-payment/put" color="orange"} | `/v1/payments/{id}` | Updates a payment; to capture an authorized amount, include `captured: true` in the body. |
| :TagComponent{tag="PUT" text="Create cancellation" href="/developers/en/reference/online-payments/checkout-api-payments/create-cancellation/put" color="orange"} | `/v1/payments/{id}` | Cancels a pending payment before it is processed. |
| :TagComponent{tag="POST" text="Create refund" href="/developers/en/reference/online-payments/checkout-api-payments/create-refund/post" color="green"} | `/v1/payments/{id}/refunds` | Creates a total or partial refund; for a partial refund, include `amount` in the body. |
| :TagComponent{tag="GET" text="Get specific refund" href="/developers/en/reference/online-payments/checkout-api-payments/get-refund/get" color="accent"} | `/v1/payments/{id}/refunds/{refund_id}` | Returns the detail of a refund: processed amount, date, and status. |
| :TagComponent{tag="GET" text="Get list of refunds" href="/developers/en/reference/online-payments/checkout-api-payments/get-refunds/get" color="accent"} | `/v1/payments/{id}/refunds` | Lists the refunds for a payment; returns the amount, date, and status of each one. |

:::

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

| Operation | Path | Description |
|---|---|---|
| :TagComponent{tag="GET" text="Get payment methods" href="/developers/en/reference/online-payments/checkout-api-payments/payment-methods/get" color="accent"} | `/v1/payment_methods` | Lists the payment methods available for the site (cards, tickets, wallets, etc.) to display the options in the checkout. |

:::

:::AccordionComponent{title="Identification types" pill="Optional"}

| Operation | Path | Description |
|---|---|---|
| :TagComponent{tag="GET" text="Get identification types" href="/developers/en/reference/online-payments/checkout-api-payments/identification-types/get" color="accent"} | `/v1/identification_types` | Lists the identification types available by country (CPF, RG, DNI, etc.) to complete the payer's form. |

:::

:::AccordionComponent{title="Cards" pill="Advanced"}

Endpoints for saving and managing customer cards. Useful for reducing friction in recurring purchases.

| Operation | Path | Description |
|---|---|---|
| :TagComponent{tag="POST" text="Save card" href="/developers/en/reference/online-payments/checkout-api-payments/cards/save-card/post" color="green"} | `/v1/customers/{customer_id}/cards` | Associates a tokenized card to a customer from a `card_token` generated with MercadoPago.js. |
| :TagComponent{tag="GET" text="Get customer cards" href="/developers/en/reference/online-payments/checkout-api-payments/cards/get-customer-cards/get" color="accent"} | `/v1/customers/{customer_id}/cards` | Lists the tokenized cards saved for a customer. |
| :TagComponent{tag="GET" text="Get card" href="/developers/en/reference/online-payments/checkout-api-payments/cards/get-card/get" color="accent"} | `/v1/customers/{customer_id}/cards/{card_id}` | Returns the data of a saved card: last 4 digits, brand, and expiration date. |
| :TagComponent{tag="PUT" text="Update card" href="/developers/en/reference/online-payments/checkout-api-payments/cards/update-card/put" color="orange"} | `/v1/customers/{customer_id}/cards/{card_id}` | Updates the data of a saved tokenized card. |
| :TagComponent{tag="DELETE" text="Delete card" href="/developers/en/reference/online-payments/checkout-api-payments/cards/delete-card/delete" color="red"} | `/v1/customers/{customer_id}/cards/{card_id}` | Deletes a saved card from the customer. |

:::

:::AccordionComponent{title="Customers" pill="Advanced"}

Endpoints for creating and managing customer profiles and saving their payment methods.

| Operation | Path | Description |
|---|---|---|
| :TagComponent{tag="POST" text="Create customer" href="/developers/en/reference/online-payments/checkout-api-payments/customers/create-customer/post" color="green"} | `/v1/customers` | Creates a customer record whose `customer_id` is required to manage their cards and addresses. |
| :TagComponent{tag="GET" text="Search in customers" href="/developers/en/reference/online-payments/checkout-api-payments/customers/search-customer/get" color="accent"} | `/v1/customers/search` | Searches customers by email or other filters; returns paginated results. |
| :TagComponent{tag="GET" text="Get customer" href="/developers/en/reference/online-payments/checkout-api-payments/customers/get-customer/get" color="accent"} | `/v1/customers/{id}` | Returns the customer's data, including saved payment methods and metadata. |
| :TagComponent{tag="PUT" text="Update customer" href="/developers/en/reference/online-payments/checkout-api-payments/customers/update-customer/put" color="orange"} | `/v1/customers/{id}` | Updates a customer's data. |

:::

:::AccordionComponent{title="Addresses" pill="Advanced"}

Endpoints for managing the addresses associated with customers.

| Operation | Path | Description |
|---|---|---|
| :TagComponent{tag="POST" text="Create address" href="/developers/en/reference/online-payments/checkout-api-payments/addresses/create-address/post" color="green"} | `/v1/customers/{customer_id}/addresses` | Registers a shipping address for the customer. |
| :TagComponent{tag="GET" text="List addresses" href="/developers/en/reference/online-payments/checkout-api-payments/addresses/list-addresses/get" color="accent"} | `/v1/customers/{customer_id}/addresses` | Lists the shipping addresses saved for a customer. |
| :TagComponent{tag="GET" text="Get address" href="/developers/en/reference/online-payments/checkout-api-payments/addresses/get-address/get" color="accent"} | `/v1/customers/{customer_id}/addresses/{address_id}` | Returns the detail of a saved shipping address. |
| :TagComponent{tag="PUT" text="Update address" href="/developers/en/reference/online-payments/checkout-api-payments/addresses/update-address/put" color="orange"} | `/v1/customers/{customer_id}/addresses/{address_id}` | Updates the data of a saved shipping address. |
| :TagComponent{tag="DELETE" text="Delete an address" href="/developers/en/reference/online-payments/checkout-api-payments/addresses/delete-address/delete" color="red"} | `/v1/customers/{customer_id}/addresses/{address_id}` | Deletes a shipping address from the customer. |

:::

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

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

:::

<br>
<br>

## SDKs

Use our official SDKs to integrate Payments 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 building your payment flow with the Payments API.
 - button_description: Create payment
 - button_link: /developers/en/reference/online-payments/checkout-api-payments/create-payment/post
---

::::

:::::