Integration model
Checkout Transparente now processes payments with Orders. This API is designed to simplify your development with Mercado Pago: with a single integration, you can access various payment solutions.
Additionally, the API makes the integration code more intuitive and provides more detailed error messages, streamlining the development process.
Differences in processing
Previously, payments via Checkout Transparente were processed exclusively through the Payments API. Now, it is also possible to process them through Orders, which offers an efficient and straightforward integration alternative.
Below are the main differences between the two options.
| Feature | Payments API | Orders API |
| Payment processing | Automatic (create and process your transaction). | Automatic and manual (choosing when to process your transaction). |
| Transactions | One transaction per request. | Multiple transactions per request. |
| Operations | Online payments. | Online payments and In-person payments (Mercado Pago Point). |
| Notifications | Advanced setup via notification_url. | Simpler setup available in the Notifications section under Your integrations. |
| Error validation | Returns one error at a time. | Returns a list of all errors in the request. |
Processing modes for Orders
An online payment order can be created to be processed in two modes: Automatic mode and Manual mode.
The definition of the processing mode will be done at the time of creating the order, using the parameter processing_mode. Its value should be automatic for automatic processing or manual for manually processing the order.
The automatic mode is the default mode of the application. Through this mode, the transaction is completed in a single step, and modifications are limited. To create the order in automatic mode, the processing_mode field, which is responsible for defining the creation and processing format of the transaction, will be set to automatic, and all information is sent in a single request.
The allowed operations are:
- Create and process order: responsible for creating the order and simultaneously processing the transaction.
- Get order: allows you to obtain information about an order, including its status in real time.
- Capture order: enables the capture of the authorized amount of an order. This option is only valid for credit cards.
- Cancel order: responsible for canceling an existing order that has not yet been processed/finalized.
- Refund order: in automatic mode, total or partial refunds can be created for a payment. The order will be fully refunded if all transactions are refunded completely.
- Total refund: the value to be refunded should not be indicated in the request’s
body, that must be empty. - Partial refund: the amount to be refunded must be specified in the request’s
bodyalong with de transaction ID. All other transactions will remain as they are, and only the modified transaction will be refunded.
- Total refund: the value to be refunded should not be indicated in the request’s