Confirmação

Após a realização da transação com o PayGo Integrado, é necessário verificar se a operação realizada requer confirmação. Em caso afirmativo, basta chamar a função da interface automação responsável pela realização da confirmação dessa transação.

Para verificar a necessidade de confirmar uma transação, basta olhar o retorno da função saidaTransacao.obtemInformacaoConfirmacao(), se true, é necessário confirmar.

Importante ficar atento a lista de status de confirmação, para informar se seu desejo é confirmar ou desfazer essa transação. Além disso, temos a opção de confirmação automática - caso seja realizada sem iteração do usuário (é o mais comum) - e manual - caso o usuário decida ativamente por confirmar ou desfazer a transação. Para mais informações sobre o assunto, consulte o Javadoc da classe StatusTransacao.

Segue abaixo um exemplo de como é realizada a confirmação.

//Se a transação foi aprovada saidaTransacao.obtemResultadoTransacao() == 0, chamar a confirmação
//Verificar se a transação requer confirmação: saidaTransacao.obtemInformacaoConfirmacao()
if(saidaTransacao.obtemInformacaoConfirmacao()){
  transactionConfirm(
    StatusTransacao.CONFIRMADO_AUTOMATICO,
    saidaTransacao.obtemIdentificadorConfirmacaoTransacao()
  )
}

suspend fun transactionConfirm(status: StatusTransacao, id: String?) {
  val confirmacao = Confirmacoes().apply {
    informaStatusTransacao(status)
    informaIdentificadorConfirmacaoTransacao(id)
  }
  transacao.confirmaTransacao(confirmacao)
}

Segue abaixo a lista de possíveis status para uma transação realizada.

StatusTransacao	Descrição
STATUS_TRANSACAO_NAO_DEFINIDO	Status ainda não definido.
CONFIRMADO_AUTOMATICO	Transação confirmada sem intervenção do usuário.
CONFIRMADO_MANUAL	Transação confirmada, porém foi necessária uma confirmação do operador.
DESFEITO_ERRO_IMPRESSAO_AUTOMATICO	Transação desfeita devido a uma falha na impressão do comprovante.
DESFEITO_MANUAL	Transação desfeita a pedido do operador.
DESFEITO_LIBERACAO_MERCADORIA	Transação desfeita devido a uma falha no processo de liberação da mercadoria.

Diferença entre desfazimento e cancelamento

O desfazimento é realizado logo após a realização da transação, enquanto o cancelamento ocorre em momento posterior. A transação só é considerada finalizada após a aprovação, impressão do comprovante e confirmação (ou desfazimento). Caso a transação já tenha sido confirmada, porém haja a necessidade de cancelá-la, a operação a ser realizada é o cancelamento.