Pedidos
Um pedido de pagamentos online pode ser criado para ser processado de dois modos: Modo automĂĄtico e Modo manual.
Modo automĂĄtico
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 o pedido no modo automĂĄtico, o campo processing_mode
, que é responsåvel por definir o formato de criação e processamento da transação, estarå como automatic
e todas as informaçÔes serĂŁo enviadas em uma Ășnica solicitaçã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
body
da requisição, que deve ser enviado vazio. - Reembolso parcial: deverå ser especificada a quantia a ser reembolsada no
body
da 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
Modo manual
O Modo manual é onde podemos dividir o processamento da transação em etapas que podem ser configuradas e executadas de maneira incremental. Permite a personalização de cada etapa do processo de pagamento, adaptando-se a diferentes necessidades e cenårios. Para criar a order no modo manual, é necessårio certificar-se que o campo processing_mode
, responsåvel por definir o formato de criação e processamento da transação, esteja como manual
.
As operaçÔes permitidas são:
- Criar order (sem transaçÔes ou com transaçÔes): responsåvel pela criação e autorização da order, mas sem o processamento simultùneo.
- Adicionar transação: essa operação de adição de transaçÔes só pode ser feita no modo manual e é responsåvel por adicionar mais de uma transação em um mesmo payload.
- Alterar e/ou remover transação: a alteração e remoção de transaçÔes só pode ser feita no modo manual e permitem mudar informaçÔes de pagamento que jå tinham sido adicionadas anteriormente à order. São operaçÔes que modificam um item dentro de qualquer campo do parùmetro
transactions
. - Capturar order: responsåvel por capturar o valor autorizado de um order. Essa opção só é vålida para cartÔes de crédito.
- Processar transação: possibilitada a execução das transaçÔes criadas e/ou alteradas no modo manual.
- Obter order: permite obter informaçÔes sobre uma order, incluindo o seu status em tempo real.
- Cancelar order: responsĂĄvel pelo cancelamento de um order jĂĄ existente, mas nĂŁo que ainda nĂŁo foi processada.
- Reembolsar order ou transação: no modo manual 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
body
da requisição, que deve ser enviado vazio. - Reembolso parcial: deverå ser especificada a quantia a ser reembolsada no
body
da 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