Tipos de comando
Os comandos da PPCONECTA podem ser do tipo blocante ou não blocante.
Comando não blocante
Chamamos de não blocantes os comandos que não prendem o processamento, executando a tarefa e retornando imediatamente (por exemplo, apresentação de uma mensagem no display do pin pad).
O desenvolvedor da Aplicação de Pagamento deve seguir a seguinte lógica para executar um comando “não blocante”:
- Enviar os parâmetros do comando à PPCONECTA através de chamadas sucessivas à função PPC_SetParam (parâmetros identificados como opcionais assumirão um valor “default” caso não sejam enviados);
- Acionar a função PPC_ExecCmdNBlk, indicando o código do comando;
- Se a função PPC_ExecCmdNBlk retornar PPC_OK (sucesso), obter os dados de resposta através de chamadas sucessivas à função PPC_GetResp.

Comando blocante
Chamamos de blocantes os comandos que têm interação com o portador do cartão e, portanto, seguram o processamento enquanto aguardam uma ação no pin pad (por exemplo, a digitação de uma senha ou a seleção de um item de menu).
O desenvolvedor da Aplicação de Pagamento deve seguir a seguinte lógica para executar um comando blocante:
- Enviar os parâmetros do comando à PPCONECTA através de chamadas sucessivas à função PPC_SetParam (parâmetros identificados como opcionais assumirão um valor “default” caso não sejam enviados);
- Acionar a função PPC_StartExecCmd, indicando o código do comando;
- Chamar sucessivamente a função PPC_FinishExecCmd enquanto esta retornar PPC_PROCESSING ou PPC_NOTIFY.
Se a função retornar PPC_NOTIFY, ela devolve também uma mensagem a ser apresentada ao operador. Para interromper o processo, a Aplicação de Pagamento pode chamar a função PPC_AbortCmd.
- Se a função PPC_FinishExecCmd retornar PPC_OK (sucesso), obter os dados de resposta através de chamadas sucessivas à função PPC_GetResp.

Updated about 1 month ago