PPC_CMD_OPEN
Este comando aloca os recursos de hardware e software necessários ao funcionamento da PPCONECTA. A chamada bem-sucedida deste comando é pré-requisito para o uso de todos os outros comandos da PPCONECTA.
Este comando disponibiliza, como saída, uma série de informações sobre o pin pad sendo usado.
Parâmetros de entrada
| Constante | Presença | Observação |
|---|---|---|
| PPC_INP_COMM | M | Identificador da porta de comunicação em que está conectado o pin pad. O formato depende da plataforma. |
| PPC_INP_LICENSE | M | Código de licença fornecido pela Cielo, necessário para uso da biblioteca. |
| PPC_INP_COMPANY | M | Nome da empresa à qual foi concedida a licença. Deve ser exatamente igual ao nome utilizado pela Cielo ao conceder a licença. |
| PPC_INP_LOG_FNAME | O | Nome do arquivo de log para depuração da biblioteca, com caminho completo (ex.: C:\logs\debug.log). Este parâmetro deve ser utilizado apenas quando solicitado pela equipe técnica da Cielo para diagnóstico de problemas. |
Dados de resposta
| Constante | Observação |
|---|---|
| PPC_OUT_SERNUM | JSONPinPadInformation.SerialNumber ou JSONTechnicalParameter.SerialNumber |
| PPC_OUT_PHYSCHR | JSONPinPadInformation.PhysicalCharacteristics ou JSONTechnicalParameter.PhysicalCharacteristics |
| PPC_OUT_RETDTINF | JSONPayment.PinPadInformation.ReturnDataInfo ou JSONTechnicalParameter.ReturnDataInfo |
| PPC_OUT_EMVVER | JSONTechnicalParameter.KernelEmvVersion |
| PPC_OUT_CTLSVER (*) | JSONTechnicalParameter.ContactlessModuleVersion |
| PPC_OUT_MCVER (*) | JSONTechnicalParameter.KernelPayPassVersion |
| PPC_OUT_VSVER (*) | JSONTechnicalParameter.KernelContactlessPayWaveVersion |
| PPC_OUT_HWMODEL | JSONTechnicalParameter.HardwareModel |
| PPC_OUT_MANUFCT | JSONTechnicalParameter.ManufacturerName |
| PPC_OUT_FWVER | JSONTechnicalParameter.FirmwareVersion |
| PPC_OUT_BLIBVER | JSONTechnicalParameter.BasicLibVersion |
| PPC_OUT_SPECVER | JSONTechnicalParameter.SpecificationVersion |
| PPC_OUT_ACQVER | JSONTechnicalParameter.AcquirerVersion |
| PPC_OUT_TABVER | Versão das tabelas carregadas no pinpad (ver seção 3.3). |
| PPC_OUT_LICEXPDATE | Data de expiração da licença fornecida pela Cielo, no formato AAMMDD. |
| PPC_OUT_MM_SUP | Tipos de arquivo multimídia suportados pelo pinpad. |
| PPC_OUT_MM_DSPSZ | Dimensões do display para apresentação de arquivos multimídia. |
(*) Caso o pin pad não suporte cartão contactless, este dado de resposta retornará vazio (string de tamanho zero).
Retornos
| Código | Descrição |
|---|---|
| PPC_OK | Sucesso. |
| PPC_ALREADYOPEN | Erro não é mais retornado. Indica que a biblioteca já estava aberta. |
| PPC_PORTERR | Erro de acesso à porta ou ao dispositivo de comunicação. |
| PPC_COMMERR | Erro de comunicação com o pin pad. |
| PPC_ERRMANDAT | Parâmetro PPC_INP_COMM, PPC_INP_LICENSE ou PPC_INP_COMPANY não foi fornecido. |
| PPC_INVLICENSE | Código de licença inválido. |
| PPC_INVCOMPANY | Nome da empresa incompatível com a licença. |
Outros retornos: Ver Códigos de retorno.
Exemplo
const char gszLicense[] = {“9DF419F71076C2A4049CDB14EE456426”};
const char gszCompany[] = {“Supermercados Alegria”};
char gszPPSerNum[21], gszHwModel[21];
int iInit (void)
{
int iSt;
PPC_SetParam (PPC_INP_COMM, “COM4”, -1);
PPC_SetParam (PPC_INP_LICENSE, gszLicense, -1);
PPC_SetParam (PPC_INP_COMPANY, gszCompany, -1);
iSt = PPC_ExecCmdNBlk (PPC_CMD_OPEN);
if (iSt != PPC_OK) return iSt;
PPC_GetResp (PPC_OUT_SERNUM, sizeof (gszPPSerNum), gszPPSerNum);
PPC_GetResp (PPC_OUT_HWMODEL, sizeof (gszHwModel), gszHwModel);
return PPC_OK;
} Updated about 1 month ago
Did this page help you?