Transação de Venda com múltiplos cartões

🚧

Esta documentação está desatualizada.

Para informações sempre atualizadas, acesse https://paygodev.readme.io/docs.

Devido à necessidade de confirmar cada transação antes de iniciar a próxima, o pagamento de uma mesma Venda através de mais de uma operação de TEF não é suportado de maneira direta. A funcionalidade pode ser implementada, opcionalmente, pela Automação Comercial, porém requer tratamentos adicionais, abaixo descritos.

As regras são as seguintes:

  • Cada operação de TEF que não seja a última deve ser confirmada imediatamente para o PayGo (comando “CNF”), e os comprovantes devem ser armazenados em memória não volátil para futura impressão.

  • Após aprovação da última operação de TEF, o cupom fiscal deve ser fechado e todos os comprovantes impressos, respeitando a ordem na qual foram realizadas as transações. Após impressão com sucesso dos comprovantes da última operação de TEF, deve então ser confirmada a última transação (comando “CNF”).

  • Caso, por qualquer motivo, o pagamento não possa ser completado via TEF, todas as operações de TEF realizadas devem ser canceladas:

    1. A última operação ainda não confirmada é cancelada simplesmente através do comando “NCN”.
    2. As demais operações de TEF já confirmadas devem ser canceladas através de uma transação de
      Cancelamento (comando “CNC”).
  • A transação de cancelamento não é imediata e requer diversas ações do usuário (leitura do cartão, digitação de informações da operação de TEF original, etc.), que dependem da Rede Adquirente utilizada. Além disso, pode não ser bem-sucedida, devido a erros na digitação, falhas de comunicação, etc. A transação de cancelamento somente deve ser considerada como efetuada pela Automação Comercial após aprovação pelo PayGo, impressão dos comprovantes com sucesso e envio da confirmação (comando “CNF”) ao PayGo.

  • Uma vez iniciado o fluxo de pagamento com múltiplos cartões, este não pode ser interrompido até ser finalizado com sucesso (todas as transações confirmadas) ou falha (todas as transações canceladas com sucesso).

  • Quedas de energia durante o fluxo de pagamento devem ser tratadas da mesma forma de uma transação simples, ainda recuperando o estado das transações já realizadas e pendentes de impressão, podendo o usuário optar por prosseguir com o fluxo, ou iniciar a sequência de cancelamentos.

  • Em caso de queda de energia durante o fluxo de cancelamento, ao ser reiniciada, a Automação Comercial deve automaticamente prosseguir com este, sem fornecer opção para o usuário interromper este.

O diagrama abaixo ilustra o fluxo seguido pela Automação Comercial:

Observações:

  • No fluxo acima, para maior clareza, os controles efetuados nos arquivos trocados com o PayGo foram
    omitidos, porém permanecem idênticos ao fluxo de venda simples.

  • A transação de cancelamento (comando “CNC”) deve ser confirmada após a impressão dos comprovantes,
    como qualquer transação administrativa.