Gestão de transação pendente

Operação responsável por definir o status final de uma transação pendente no Cielo Conecta, permitindo sua confirmação ou desfazimento conforme decisão da aplicação integradora.

Esta operação deve ser utilizada quando a aplicação estiver configurada para realizar a confirmação ou o desfazimento de forma manual, por meio do parâmetro ConfirmationStatusSetup, definido durante a operação de inicialização.

Nesse modelo, o sistema de Automação Comercial assume o controle do fluxo de conclusão da transação, sendo responsável por decidir e executar a confirmação ou o desfazimento de cada operação realizada.

Comportamento da operação

Quando a confirmação/desfazimento automática estiver habilitada, esta operação não deve ser utilizada, pois o encerramento da transação é realizado automaticamente pela biblioteca;
Quando a confirmação/desfazimento manual estiver habilitada, e a aplicação de pagamento não enviar explicitamente o comando para definir o status das transações pendentes, o ambiente Cielo Conecta efetuará automaticamente a confirmação de todas as operações pendentes no fechamento diário às 00:00 (meia noite).

⚠️
Atenção
Para evitar confirmações automáticas indesejadas, é responsabilidade da aplicação integrar o fluxo de confirmação ou desfazimento de forma explícita.
Esta operação deve ser utilizada exclusivamente para definição do status final de transações pendentes, quando o controle manual estiver configurado por meio do parâmetro ConfirmationStatusSetup.

Parâmetros de entrada

Campo	Tipo	Formato	Obrigatório	Descrição
`Oper`	string	N..3	M	Código da operação: fixo "7" (`CFL_OPER_CONFIRMATION`)
`MerchantOrderId`	string	N15	M	Chave única de identificação da transação, de controle da Automação Comercial.
`PaymentId`	string	A36	M	Chave única de identificação da transação no Cielo Conecta.
`TransactionConfirmationStatus`	string	N..2	M	Operação de Conclusão: `1` = Confirmar; `2` = Desfazer.

Mensagem de notificação recebida na callback da operação

Não há.

Dados de resposta recebido na callback da operação

Os dados de resposta são retornados via callback no formato JSON.

Campos retornados

Campo	Tipo	Formato	Obrigatório	Descrição
`Oper`	string	N..3	ME	Código da operação: fixo "7" (`CFL_OPER_CONFIRMATION`)
`Code`	string	N..2	M	Código da resposta. Valor "0" indica resposta
`TransactionType`	string	N2	ME	Tipo da transação realizada
`Amount`	string	N..12	ME	Valor da transação
`MerchantOrderId`	string	N15	ME	Chave única de identificação da transação, de controle da Automação Comercial
`Datetime`	string	N14	M	Data e hora da transação no formato “AAAAMMDDhhmmss”
`PaymentId`	string	A36	ME	Chave única de identificação da transação no Cielo Conecta.
`PhysicalTransactionStatus`	string	N..2	M	Status da transação realizada: “0” = não processada; “2” = aprovada, pendente de confirmação; “3” = não aprovada/negada; “10” = cancelada; “13” = abortada e/ou desfeita; “20” = confirmada.
`ReturnCode`	string	A3	M	Código de erro ou resposta da transação no Cielo Conecta.
`ReturnMessage`	string	A..99	M	Mensagem de erro ou resposta da transação no Cielo Conecta.

Retornos

Código	Descrição
`CFL_OK`	Operação realizada com sucesso
`CFL_ERROR_INVCALL`	Operação não permitida no momento
`CFL_ERROR_INVPARAM`	Parâmetros inválidos
`CFL_ERROR_NETWORK`	Erro na comunicação com Cielo Conecta