AI resources
Checkout Transparente
Checkout Transparente 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, Pix and boleto. This reference describes the available endpoints and how to interact with them.
Looking for integration steps? Go to the Checkout Transparente documentation.
Which integration path should you use?
Choose based on your use case.
- Automatic and manual processing
- Deferred fund capture
- New features and simplified notifications
- Automatic processing
- Deferred fund capture
Via Orders API (Recommended)
Via Payments API (Legacy)
Available endpoints
All endpoints that make up the Checkout Transparente integration via Orders.
| Operation | Path | Description |
| Create orderPOST | /v1/orders | Creates a new order in automatic mode (one-step payment) or manual mode (authorize and capture separately); returns the order_id. |
| Capture order completelyPOST | /v1/orders/{id}/capture | Captures the full amount of an order in manual mode; only valid for credit cards. |
| Add transactions to orderPOST | /v1/orders/{id}/transactions | Adds a transaction to an order in manual mode with card_token, installments, and payment_method_id. |
| Delete a transaction from the orderDELETE | /v1/orders/{id}/transactions/{transaction_id} | Deletes a transaction before calling /process, to correct the payment method or amount in manual mode. |
| Update a transaction of the orderPUT | /v1/orders/{id}/transactions/{transaction_id} | Updates the data of an existing transaction in an order in manual mode. |
| Process order by IDPOST | /v1/orders/{id}/process | Triggers payment authorization; the order transitions to approved, pending, rejected, or failed. |
| Search orderGET | /v1/orders/search | Searches orders by filters such as date, status, or external_reference; returns paginated results. |
| Get order by IDGET | /v1/orders/{id} | Returns the status and full detail of the order, including its transactions and the active processing_mode. |
| Cancel order by IDPOST | /v1/orders/{id}/cancel | Cancels an order before processing it or when the payment resulted in a rejected or pending status. |
| Refund an orderPOST | /v1/orders/{id}/refund | Refunds an order totally or partially. |
| Operation | Path | Description |
| Get payment methodsGET | /v1/payment_methods | Lists the payment methods available for the site (cards, tickets, wallets, etc.) to display the options in the checkout. |
| Operation | Path | Description |
| Get identification typesGET | /v1/identification_types | Lists the identification types available by country to complete the payer's form. |
Endpoints for saving and managing customer cards. Useful for reducing friction in recurring purchases.
| Operation | Path | Description |
| Save cardPOST | /v1/customers/{customer_id}/cards | Associates a tokenized card to a customer from a card_token generated with MercadoPago.js. |
| Get customer cardsGET | /v1/customers/{customer_id}/cards | Lists the tokenized cards saved for a customer. |
| Get cardGET | /v1/customers/{customer_id}/cards/{card_id} | Returns the data of a saved card: last 4 digits, brand, and expiration date. |
| Update cardPUT | /v1/customers/{customer_id}/cards/{card_id} | Updates the data of a saved tokenized card. |
| Delete cardDELETE | /v1/customers/{customer_id}/cards/{card_id} | Deletes a saved card from the customer. |
Endpoints for creating and managing customer profiles and saving their payment methods.
| Operation | Path | Description |
| Create customerPOST | /v1/customers | Creates a customer record whose customer_id is required to manage their cards and addresses. |
| Search in customersGET | /v1/customers/search | Searches customers by email or other filters; returns paginated results. |
| Get customerGET | /v1/customers/{id} | Returns the customer's data, including saved payment methods and metadata. |
| Update customerPUT | /v1/customers/{id} | Updates a customer's data. |
Endpoints for managing the addresses associated with customers.
| Operation | Path | Description |
| Create addressPOST | /v1/customers/{customer_id}/addresses | Registers a shipping address for the customer. |
| List addressesGET | /v1/customers/{customer_id}/addresses | Lists the shipping addresses saved for a customer. |
| Get addressGET | /v1/customers/{customer_id}/addresses/{address_id} | Returns the detail of a saved shipping address. |
| Update addressPUT | /v1/customers/{customer_id}/addresses/{address_id} | Updates the data of a saved shipping address. |
| Delete an addressDELETE | /v1/customers/{customer_id}/addresses/{address_id} | Deletes a shipping address from the customer. |
| Operation | Path | Description |
| Get chargebackGET | /v1/chargebacks/{id} | Returns the detail of a chargeback: dispute status, affected amount, and deadline to respond. |
All set to get started?
Go to the first endpoint and start building your payment flow with the Orders API.