Modelo de integração
Checkout API agora processa pagamentos com Orders. Se trata de uma API projetada para simplificar seu desenvolvimento com o Mercado Pago: com uma única integração, você poderá acessar diversas soluções de pagamento.
Além disso, a API torna o código de integração mais intuitivo e fornece mensagens de erro mais detalhadas, facilitando o processo de desenvolvimento.
Diferenças no processamento
Anteriormente, os pagamentos via Checkout API eram processados exclusivamente pela API de Pagamentos. Agora, também é possível processá-los por meio de Orders, que oferece uma alternativa eficiente e simples para a integração.
Veja abaixo as principais diferenças entre as duas opções.
| Funcionalidade | API de Pagamentos | API de Orders |
| Processamento do pagamento | Automático (crie e processe sua transação). | Automático ou manual (escolhendo quando processar a sua transação). |
| Transações | Uma transação por requisição. | Múltiplas transações por requisição. |
| Operações | Pagamentos online. | Pagamentos online e Pagamentos presenciais (Point do Mercado Pago). |
| Notificações | Configuração avançada por notification_url. | Configuração mais simples a partir da seção de Notificações em Suas integrações. |
| Validação dos erros | Retorna um erro por vez. | Retorna uma lista com todos os erros na requisição. |
Modos de processamento de Orders
Uma order de pagamentos online pode ser criada para ser processada de dois modos: Modo automático e Modo manual.
A definição do modo de processamento será realizada no momento da criação da order, por meio do parâmetro processing_mode. Seu valor deve ser automatic, para processamentos automáticos, ou manual, para processar o pedido manualmente.
O modo automático é o modo padrão da aplicação. Por meio dele, a transação é concluída em uma única etapa e as modificações são limitadas. Para criar a order no modo automático, o campo processing_mode, responsável por definir o formato de criação e processamento da transação, será definido como automatic e todas as informações serão enviadas em uma única requisição.
As operações permitidas são:
- Criar e processar order: responsável pela criação da order já com o processamento da transação simultâneo.
- Obter order: permite obter informações sobre uma order, incluindo o seu status em tempo real.
- Capturar order: possibilita a captura do valor autorizado de uma order. Essa opção só é válida para cartões de crédito.
- Cancelar order: responsável pelo cancelamento de uma order já existente, mas que ainda não foi processada.
- Reembolsar order: no caso do modo automático, podem ser criados estornos totais ou parciais de um pagamento. A order será reembolsada totalmente se todas as transações forem estornadas por completo.
- Reembolso total: não deverá ser indicado o valor a ser reembolsado no
bodyda requisição, que deve ser enviado vazio. - Reembolso parcial: deverá ser especificada a quantia a ser reembolsada no
bodyda requisição junto com o ID da transação. Todas as outras transações permanecerão como estão e somente a transação alterada será reembolsada.
- Reembolso total: não deverá ser indicado o valor a ser reembolsado no