PPC_CMD_FINISHCHIP
Este comando finaliza o processamento de cartão com chip e deve sempre ser chamado caso PPC_CMD_PROCCHIP tenha requerido aprovação online (PPC_OUT_RESULT = “2”), independentemente do que tenha ocorrido no processo de autorização.
Em caso de erro de comunicação com a Cielo, o comando PPC_CMD_FINISHCHIP também deve ser chamado, porém sem parâmetros de entrada.
Em situações muito específicas, este comando pode solicitar a reapresentação do cartão contactless, sendo então blocante. Desta forma, ele deve ser usado com as funções PPC_StartExecCmd e PPC_FinishExecCmd.
Caso o Host Cielo aprove a transação a execução deste comando resulte em erro (retorno diferente de PPC_OK), deve-se enviar um “Desfazimento”, dado que a transação não pôde ser completada.
Parâmetros de entrada
| Constante | Presença | Observação |
|---|---|---|
| PPC_INP_RETCODE | O | Código de resposta do Host Cielo (se houve comunicação com o host). JSONPayment.ReturnCode |
| PPC_INP_EMVDATA | O | Somente se recebido do Host Cielo. JSONPayment.EmvResponseData |
| PPC_INP_TAGLIST | O | Lista de tags dos objetos EMV requeridos na resposta. JSONEmv.TagsSecond |
Dados de resposta
| Constante | Observação |
|---|---|
| PPC_OUT_FINALRES | Resultado final do processamento: “0” = Transação aprovada offline pelo cartão; “1” = Transação negada. “2” = Transação aprovada online; ou “3” = Transação aprovada online foi negada pelo cartão (desfazer). |
| PPC_OUT_EMVDATA | Lista dos objetos TLV requeridos por PPC_INP_TAGLIST. JSONEmvData |
| PPC_OUT_SCRIPTRES | Resultado do processamento de Issuer Scripts. JSONIssuerScriptResults |
Retornos
| Retorno | Descrição |
|---|---|
| PPC_OK | Sucesso. |
| PPC_NOTOPEN | Comando PPC_CMD_OPEN não foi previamente chamado. |
| PPC_INVCALL | Comando PPC_CMD_PROCCHIP não foi executado previamente com sucesso e com resultado de “ir online”. |
| PPC_ERRMANDAT | Parâmetro mandatório não foi fornecido. |
| PPC_INVPARAM | Parâmetro fornecido possui valor inválido. |
| PPC_NOCARD | O cartão com chip de contato foi removido. |
Outros retornos: Ver Códigos de retorno.
Exemplo
Ver PPC_CMD_PROCCHIP.
Updated about 1 month ago