Funções da Biblioteca

Este capítulo define as funções exportadas pela biblioteca do PayGo, separadas em duas categorias:

➝ Funções de controle do fluxo transacional;
➝ Funções para interação com o pinpad.

Funções de controle do fluxo transacional

Estas funções são utilizadas para iniciar uma operação, alimentar o sistema com os dados necessários, executar a transação, obter os dados resultantes desejados e enfim confirmar a transação, conforme fluxo apresentado em “5.1 - Fluxo principal”.

PW_iInit

Esta função é utilizada para inicializar a biblioteca, e retorna imediatamente. Deve ser garantido que uma chamada dela retorne **PWRET_OK **antes de chamar qualquer outra função.

👍

Int16 PW_iInit

(const char *pszWorkingDir)

➜ Entradas:

**pszWorkingDir **
Diretório de trabalho (caminho completo, com final nulo) para uso exclusivo do PayGo

Obs.: Não deve-se utilizar diretórios com privilégios altos ou que não são destinadas a isso como os diretórios que ficam em "C:\Program Files (x86)". Recomendamos o seguinte diretório: "C:\ProgramData\PayGo\PGWebLib"

➜ Saídas:

Nenhuma.

➜ Retorno:

PWRET_OK......................Operação bem-sucedida.
PWRET_WRITERR..........Falha de gravação no diretório informado. PWRET_INVCALL..........Já foi efetuada uma chamada à função PW_iInit após o carregamento da biblioteca. Outro.................................Outro erro de execução (ver “11. Códigos de retorno”). Uma mensagem de erro pode ser obtida através da função **PW_iGetResult (PWINFO_RESULTMSG). **

➜ Observações:

• Os operadores do Ponto de Captura (que venham a realizar transações através do PayGo) devem ter privilégios de leitura e gravação neste diretório.
• O diretório deve ser o mesmo para todos os usuários do sistema, e não deve ser alterado de uma execução para outra.

PW_End

Esta função é utilizada para finalizar a biblioteca, e retorna imediatamente. Ela também remove a proteção do Warsaw da automação para que a automação consiga atualizar.

Essa função deve ser usada APENAS para quando a automação for atualizar, ela não deve ser utilizada sempre. Pois isso pode afetar os tempos das transações.

❗️

Importante:

A aplicação em produção não roda sem a proteção ativa. Ao chamar a função PW_iInit a proteção é retomada.
Caso alguma outra função da lib seja chamada sem ter a proteção ativa, o erro -2415 (PWRET_PROTECTOFF) irá retornar.

👍

Int16 PW_End

(void)

➜ Entradas:

Nenhuma

➜ Saídas:

Nenhuma

➜ Retorno:

Nenhuma

PW_iNewTransac

Esta função deve ser chamada para iniciar uma nova transação através do PayGo, e retorna imediatamente.

❗️

Importante:

Independentemente das funcionalidades suportadas pela Automação e pelo Ponto de Captura, é requerido que a Automação disponibilize ao operador uma função para realizar uma transação administrativa (PWOPER_ADMIN), para permitir o acesso às funções de manutenção do PayGo. Caso desejado, o acesso a este recurso pode ser restrito a operadores específicos.

👍

Int16 PW_iNewTransac

(Byte bOper)

➜ Entradas:

**bOper **
Tipo de transação a ser realizada (PWOPER_xxx, conforme tabela abaixo).

➜ Saídas:

Nenhuma.

➜ Retorno:
PWRET_OK............................Transação inicializada. PWRET_DLLNOTINIT..........Não foi executado PW_iInit. PWRET_NOTINST................É necessário efetuar uma transação de Instalação. Outro.......................................Outro erro de execução (ver “11. Códigos de retorno”). Uma mensagem de erro pode ser obtida através da função PW_iGetResult (PWINFO_RESULTMSG).

Lista de transações suportadas:

PW_iAddParam

Esta função é utilizada para alimentar a biblioteca com as informações da transação a ser realizada, e retorna imediatamente. Estas informações podem ser:

➝ Pré-fixadas na Automação;

➝ Capturadas do operador pela Automação antes do acionamento do PayGo;

➝ Capturadas do operador após solicitação pelo PayGo (retorno PW_MOREDATA por PW_iExecTransac).

❗️

Importante:

Todas as informações adicionadas nessa função através do parâmetro pszValue devem, obrigatoriamente, estar na faixa ASCII entre o valor 20h (32 decimal) e o valor 7Eh (126 decimal) e possuir o terminador nulo. Este parâmetro **não aceita **‘ç’ e nem caracteres acentuados.

👍

Int16 PW_iAddParam

(Word wParam, const char *pszValue)

➜ Entradas:

**wParam **
Identificador do parâmetro (PWINFO_xxx, ver lista completa em “10.Dicionário de dados”, página 79).

**pszValue **
Valor do parâmetro (string ASCII com final nulo).

➜ Saídas:

Nenhuma.

➜ Retorno:

PWRET_OK..............................Parâmetro acrescentado com sucesso.
PWRET_INVPARAM...............O valor do parâmetro é inválido. PWRET_DLLNOTINIT............Não foi executado PW_iInit. PWRET_TRNNOTINIT...........Não foi executado PW_iNewTransac PWRET_NOTINST.................É necessário efetuar uma transação de Instalação. Outro.............................................Outro erro de execução (ver “11. Códigos de retorno”). Uma mensagem de erro pode ser obtida através da função PW_iGetResult (PWINFO_RESULTMSG).

⇨ Observações adicionais:

• Os parâmetros abaixo devem obrigatoriamente ser informados pela Automação a cada transação, qualquer que seja.

• Os parâmetros abaixo devem obrigatoriamente ser informados pela Automação para transações dos seguintes tipos: PWOPER_SALE, PWOPER_SALEVOID, PWOPER_PREAUTH, PWOPER_CASHWDRWL e PWOPER_SALEPRE.

• Os parâmetros abaixo devem obrigatoriamente ser informados pela Automação para transações dos seguintes tipos: PWOPER_SALEVOID, PWOPER_PREAUTVOID e PWOPER_SALEPRE.

PW_iExecTransac

Esta função tenta realizar uma transação através do PayGo, utilizando os parâmetros previamente definidos através de PW_iAddParam. Caso algum dado adicional precise ser informado, o retorno será PWRET_MOREDATA e o parâmetro pvstParam retornará informações dos dados que ainda devem ser capturados.

Esta função, por se comunicar com a infraestrutura PayGo, pode demorar alguns segundos para retornar.

👍

Int16 PW_iExecTransac

(PW_GetData *pvstParam, Int16 *piNumParam)

➜ ** Entradas:**

piNumParam

Quantidade máxima de dados que podem ser capturados de uma vez, caso o retorno seja PW_MOREDATA. (Deve refletir o tamanho da área de memória apontada por pvstParam.) Valor sugerido: 9.

➜ Saídas:

**pvstParam **

Lista e características dos dados que precisam ser informados para executar a transação. Consultar “9.Captura de dados” para a descrição da estrutura e instruções para a captura de dados adicionais.

piNumParam

Quantidade de dados adicionais que precisam ser capturados (quantidade de ocorrências preenchidas em pvstParam).

➜ Retorno:

PWRET_OK.......................................Transação realizada com sucesso. Os resultados da transação devem ser obtidos através da função PW_iGetResult.
PWRET_NOTHING..........................Nada a fazer, fazer as validações locais necessárias e chamar a função PW_iExecTransac novamente. PWRET_MOREDATA.......................Mais dados são requeridos para executar a transação. PWRET_DLLNOTINIT......................Não foi executado PW_iInit. PWRET_TRNNOTINIT......................Não foi executado PW_iNewTransac. PWRET_NOTINST............................É necessário efetuar uma transação de Instalação. PWRET_NOMANDATORY..............Algum dos parâmetros obrigatórios não foi adicionado. Outro...................................................Outro erro de execução (ver “11. Códigos de retorno”). Uma mensagem de erro pode ser obtida através da função PW_iGetResult (**PWINFO_RESULTMSG**).

PW_iGetResult

Esta função pode ser chamada para obter informações que resultaram da transação efetuada, independentemente de ter sido bem ou malsucedida, e retorna imediatamente.

👍

Int16 PW_iGetResult

(Int16** iInfo**, char *pszData, Uint32** ulDataSize**)

➜ Entradas:

iInfo

Código da informação solicitada sendo requisitada (PWINFO_xxx, ver lista completa em “10.Dicionário de dados”).

ulDataSize

Tamanho (em bytes) da área de memória apontada por pszData. Prever um tamanho maior que o máximo previsto para o dado solicitado.

➜ Saídas:

pszData

Valor da informação solicitada (string ASCII com terminador nulo).

➜ Retorno:

PWRET_OK..........................Sucesso. **pszData **contém o valor solicitado.
PWRET_NODATA...............A informação solicitada não está disponível. PWRET_BUFOVFLW..........O valor da informação solicitada não cabe em pszData. PWRET_DLLNOTINIT..........Não foi executado PW_iInit. PWRET_TRNNOTINIT.........Não foi executado PW_iNewTransac (ver página 18). PWRET_NOTINST................É necessário efetuar uma transação de Instalação. Outro.......................................Outro erro de execução (ver “11. Códigos de retorno”)

PW_iConfirmation

Esta função informa ao PayGo o status final da transação em curso (confirmada ou desfeita). Consultar “8. Confirmação de transação” para informações adicionais

👍

Int16 PW_iConfirmation

Uint32 ulResult, const char *pszReqNum
const char *pszLocRef, const char** *pszExtRef*_ const char _pszVirtMerch, const char *pszAuthSyst);**

➜ Entradas:

ulStatus
Resultado da transação (PWCNF_xxx, ver lista abaixo).

pszReqNum
Referência local da transação, obtida através de PW_iGetResult (PWINFO_REQNUM).

pszLocRef
Referência da transação para a infraestrutura PayGo, obtida através de **PW_iGetResult (PWINFO_AUTLOCREF). **

pszExtRef
Referência da transação para o Provedor, obtida através de PW_iGetResult (PWINFO_AUTEXTREF).

pszVirtMerch
Identificador do Estabelecimento, obtido através de PW_iGetResult (PWINFO_VIRTMERCH).

pszAuthSyst
Nome do Provedor, obtido através de PW_iGetResult (PWINFO_AUTHSYST).

➜ Saídas:

Nenhuma.

➜ Retorno:

PWRET_OK..............................O status da transação foi atualizado com sucesso.
PWRET_DLLNOTINIT.............Não foi executado PW_iInit. PWRET_NOTINST...................É necessário efetuar uma transação de Instalação. PWRET_INVALIDTRN............A transação informada para confirmação não existe ou já foi confirmada anteriormente. Outro.........................................Outro erro de execução (ver “11. Códigos de retorno”)

➜** Observações:**

• Caso a chamada a PW_iGetResult para um ou mais dos parâmetros acima retorne erro, a Automação deve informar o(s) parâmetro(s) correspondente(s) como NULL ou string vazia (“”).

Lista de status de confirmação possíveis:

PW_iWaitConfirmation

Caso deseje-se sincronizar a execução da biblioteca com o processo de confirmação, após chamar PW_iConfirmation, a chamada de PW_iWaitConfirmation apenas retornará quando o processo de confirmação for efetivamente terminado.

👍

Int16 PW_iWaitConfirmation

(void)

➜ Entradas:

Nenhuma.

➜ Saídas:

Nenhuma.

➜ Retorno:

PWRET_OK............................Operação realizada com êxito.
PWRET_DLLNOTINIT...........Não foi executado PW_iInit. PWRET_NOTINST.................É necessário efetuar uma transação de Instalação. Outro........................................Outro erro de execução (ver “11. Códigos de retorno”, página 93).

PW_iIdleProc

Para o correto funcionamento do sistema, a biblioteca do PayGo precisa de tempos em tempos executar tarefas automáticas enquanto não está realizando nenhuma transação a pedido da Automação.

Após uma chamada de qualquer uma das funções PW_iInit, PW_iExecTransac, PW_iConfirmation ou PW_iIdleProc, a Automação deve obter, através da função PW_iGetResult, o valor do parâmetro PWINFO_IDLEPROCTIME, que indica o próximo horário no qual a Automação deve chamar PW_iIdleProc.

👍

Int16 PW_iIdleProc

(void)

➜ Entradas:

Nenhuma.

➜ Saídas:

Nenhuma.

➜** Retorno:**

PWRET_OK.......................Operação realizada com êxito.
PWRET_DLLNOTINIT...........Não foi executado PW_iInit. PWRET_NOTINST.................É necessário efetuar uma transação de Instalação. Outro.......................................Outro erro de execução (ver “11. Códigos de retorno”, página 93)

PW_iGetOperations

Esta função pode ser chamada para obter quais operações o PayGo disponibiliza no momento, sejam elas *_administrativas, de venda ou ambas. _

👍

Int16 PW_iGetOperations

(Byte bOperType, PW_Operations vstOperations[], Int16 *piNumOperations)

➜** Entradas:**

bOperType
Soma dos tipos de operação a serem incluídos na estrutura de retorno (PWOPTYPE_xxx, conforme tabela abaixo).

piNumOperations
Número máximo de operações que pode ser retornado. (Deve refletir o tamanho da área de memória apontada por pvstOperations).

➜ Saídas:

piNumOperations
Número de operações disponíveis no PayGo.

vstOperations
Lista das operações disponíveis e suas características, descrição dos membros da estrutura na tabela abaixo:

➜ Retorno:

PWRET_OK...............................Operação realizada com êxito.
PWRET_DLLNOTINIT.............Não foi executado PW_iInit. PWRET_NOTINST...................É necessário efetuar uma transação de Instalação. Outro..........................................Outro erro de execução (ver “11. Códigos de retorno”, página 93)

Tipos de operação:

PW_iGetOperationsEx

Esta função pode ser chamada para obter quais operações o PayGo disponibiliza no momento, sejam elas **administrativas, de venda ou ambas. **Retorna além da operação, o nome do sistema autorizador que oferece a opção.

👍

Int16 PW_iGetOperations

(Byte bOperType, PW_OperationsEx vstOperations[], Int16 *piNumOperations, Int16 iStructSize);

➜ Entradas:

bOperType
Soma dos tipos de operação a serem incluídos na estrutura de retorno (PWOPTYPE_xxx, conforme tabela abaixo).

piNumOperations
Número máximo de operações que pode ser retornado. (Deve refletir o tamanho da área de memória apontada por pvstOperations).

iStructSize
Tamanho da estrutura PW_OperationsEx.

➜ Saídas:

**piNumOperations **
Número de operações disponíveis no PayGo.

vstOperations
Lista das operações disponíveis e suas características, descrição dos membros da estrutura na tabela abaixo:

➜ Retorno:

PWRET_OK.............................Operação realizada com êxito.
PWRET_DLLNOTINIT...........Não foi executado PW_iInit. PWRET_NOTINST.................É necessário efetuar uma transação de Instalação. Outro........................................Outro erro de execução (ver “11. Códigos de retorno”, página 93)

Tipos de operação:

Funções para acesso ao pinpad

Essas funções são utilizadas para obtenção de dados do pinpad, exclusivamente quando solicitado pelo retorno PWRET_MOREDATA da função** PW_iExecTransac**.

O uso das funções apresentadas nesta seção deve respeitar o fluxo apresentado em “5.2.2. Interface com o pinpad”

Funções de controle do fluxo

PW_iPPEventLoop

Esta função deve ser chamada repetidamente até que devolva em código de retorno diferente de PWRET_NOTHING e PWRET_DISPLAY, e retorna imediatamente.

👍

Int16 PW_iPPEventLoop

(char *pszDisplay, Uint32 ulDisplaySize)

➜ Entradas:

ulDisplaySize
Tamanho (em bytes) da área de memória apontada por pszDisplay. Tamanho mínimo recomendado: 100 bytes.

➜ Saídas:

pszDisplay
Caso o retorno da função seja** PWRET_DISPLAY**, contém uma mensagem de texto (string ASCII com terminal nulo) a ser apresentada pela Automação na interface com o usuário principal. Para o formato desta mensagem, consultar “1. Interface com o usuário”.

➜ Retorno:

PWRET_NOTHING..................Nada a fazer, continuar aguardando o processamento do pinpad.
PWRET_DISPLAY....................Apresentar a mensagem recebida em pszDisplay e continuar aguardando o processamento do pinpad. PWRET_OK..............................Captura de dados realizada com êxito, prosseguir com a transação. PWRET_CANCEL...................A operação foi cancelada pelo Cliente no pinpad (tecla [CANCEL]). PWRET_TIMEOUT..................O Cliente não realizou a captura no tempo limite. PWRET_FALLBACK...............Ocorreu um erro na leitura do cartão, passar a aceitar a digitação do número do cartão, caso já não esteja aceitando. PWRET_PPCOMERR.............Falha na comunicação com o pinpad. PWRET_DLLNOTINIT............Não foi executado PW_iInit. PWRET_INVCALL..................Não há captura de dados no pinpad em curso. Outro.........................................Outro erro de execução (ver “11. Códigos de retorno”). Uma mensagem de erro pode ser obtida através da função PW_iGetResult (PWINFO_RESULTMSG).

PW_iPPAbort

Esta função pode ser utilizada pela Automação para interromper uma captura de dados no pinpad em curso, e retorna imediatamente.

👍

Int16 PW_iPPAbort

(void)

➜ Entradas:

Nenhuma.

➜** Saídas:**
Nenhuma.

➜ Retorno:

PWRET_OK.................................Operação interrompida com sucesso.
PWRET_PPCOMERR................Falha na comunicação com o pinpad. PWRET_DLLNOTINIT...............Não foi executado PW_iInit. Outro............................................Outro erro de execução (ver “11. Códigos de retorno”)

Funções para obtenção de dados

Cada função desta seção inicia um processamento no pinpad, e retorna imediatamente.

Todas as funções dessa seção só podem ser utilizadas caso a biblioteca solicite a respectiva captura através do retorno** PWRET_MOREDATA** com o tipo de captura PWDAT_PPREMCRD, como descrito na seção “8.2.6 Outras capturas no pinpad”. Qualquer outra chamada dessas funções fora desse fluxo irá retornar** PWRET_INVPARAM**.

Para determinar qual função deve ser chamada pela Automação, referir-se à seção “9.Captura de dados”.

PW_iPPGetCard

Esta função é utilizada para realizar a leitura de um cartão (magnético, com chip com contato, ou sem contato) no pinpad.

👍

Int16 PW_iPPGetCard

(Uint16 uiIndex)

➜ Entradas:

uiIndex **
Índice (iniciado em 0) do dado solicitado na última execução de PW_iExecTransac** (índice do dado no vetor pvstParam).

➜** Saídas:**

Nenhuma.

➜ Retorno:

PWRET_OK.........................Captura iniciada com sucesso, chamar **PW_iPPEventLoop **para obter o resultado.
PWRET_INVPARAM..........O valor de uiIndex informado não corresponde a uma captura de dados deste tipo ou a essa captura de dado não foi solicitada pela biblioteca. PWRET_DLLNOTINIT........Não foi executado PW_iInit. Outro.....................................Outro erro de execução (ver “11. Códigos de retorno). Uma mensagem de erro pode ser obtida através da função PW_iGetResult (PWINFO_RESULTMSG).

PW_iPPGetPIN

Esta função é utilizada para realizar a captura no pinpad da senha (ou outro dado criptografado) do Cliente.

👍

Int16 PW_iPPGetPIN

** Uint16 uiIndex**

➜ Entradas:

uiIndex
Índice (iniciado em 0) do dado solicitado na última execução de PW_iExecTransac (índice do dado no vetor pvstParam).

➜** Saídas:**

Nenhuma.

➜** Retorno:**

PWRET_OK.........................Captura iniciada com sucesso, chamar PW_iPPEventLoop para obter o resultado.
PWRET_INVPARAM..........O valor de uiIndex informado não corresponde a uma captura de dados deste tipo ou a essa captura de dado não foi solicitada pela biblioteca. PWRET_DLLNOTINIT........Não foi executado PW_iInit. Outro.....................................Outro erro de execução (ver “11. Códigos de retorno”, página 93). Uma mensagem de erro pode ser obtida através da função PW_iGetResult (PWINFO_RESULTMSG).

PW_iPPGetData

Esta função é utilizada para fazer a captura no pinpad de um dado não sensível do Cliente.

👍

Int16 PW_iPPGetData

Uint16 uiIndex

➜ Entradas:

**uiIndex **
Índice (iniciado em 0) do dado solicitado na última execução de PW_iExecTransac (índice do dado no vetor pvstParam).

➜** Saídas:**

Nenhuma.

➜ Retorno:

PWRET_OK.............................Captura iniciada com sucesso, chamar PW_iPPEventLoop para obter o resultado.
PWRET_INVPARAM...............O valor de** uiIndex **informado não corresponde a uma captura de dados deste tipo ou a essa captura de dado não foi solicitada pela biblioteca. PWRET_DLLNOTINIT...............Não foi executado PW_iInit. Outro............................................Outro erro de execução (ver “11. Códigos de retorno”). Uma mensagem de erro pode ser obtida através da função PW_iGetResult (PWINFO_RESULTMSG).

PW_iPPGoOnChip

Esta função é utilizada para realizar o processamento off-line (antes da comunicação com o Provedor) de um cartão com chip no pinpad.

👍

Int16 PW_iPPGoOnChip

(Uint16 uiIndex)

➜ ** Entradas:**

uiIndex
Índice (iniciado em 0) do dado solicitado na última execução de PW_iExecTransac (índice do dado no vetor pvstParam).

➜ ** Saídas:**

Nenhuma.

➜ Retorno:

PWRET_OK = Captura iniciada com sucesso, chamar PW_iPPEventLoop para obter o resultado.
PWRET_INVPARAM = O valor de uiIndex informado não corresponde a uma captura de dados deste tipo ou a essa captura de dado não foi solicitada pela biblioteca. PWRET_DLLNOTINIT = Não foi executado PW_iInit. Outro = Outro erro de execução (ver “11. Códigos de retorno”). Uma mensagem de erro pode ser obtida através da função PW_iGetResult (PWINFO_RESULTMSG).

PW_iPPFinishChip

Esta função é utilizada para finalizar o processamento on-line (após comunicação com o Provedor) de um cartão com chip no pinpad.

👍

Int16 PW_iPPFinishChip

(Uint16 uiIndex)

➜ Entradas:

uiIndex
Índice (iniciado em 0) do dado solicitado na última execução de PW_iExecTransac (índice do dado no vetor pvstParam).

➜** Saídas:**

Nenhuma.

➜ Retorno:

PWRET_OK.......................Captura iniciada com sucesso, chamar PW_iPPEventLoop para obter o resultado.
PWRET_INVPARAM.......................O valor de **uiIndex **informado não corresponde a uma captura de dados deste tipo ou a essa captura de dado não foi solicitada pela biblioteca. PWRET_DLLNOTINIT.......................Não foi executado PW_iInit. Outro.......................Outro erro de execução (ver “11. Códigos de retorno”). Uma mensagem de erro pode ser obtida através da função PW_iGetResult (PWINFO_RESULTMSG).

PW_iPPConfirmData

Esta função é utilizada para obter do Cliente a confirmação de uma informação no pinpad.

👍

Int16 PW_iPPConfirmData

(Uint16 uiIndex)

➜ Entradas:

**uiIndex **
Índice (iniciado em 0) do dado solicitado na última execução de PW_iExecTransac (índice do dado no vetor pvstParam).

➜** Saídas:**

Nenhuma.

➜** Retorno:**

PWRET_OK..........................Captura iniciada com sucesso, chamar PW_iPPEventLoop para obter o resultado.
PWRET_INVPARAM............O valor de uiIndex informado não corresponde a uma captura de dados deste tipo ou a essa captura de dado não foi solicitada pela biblioteca. PWRET_DLLNOTINIT..........Não foi executado PW_iInit. Outro.......................................Outro erro de execução (ver “11. Códigos de retorno”). Uma mensagem de erro pode ser obtida através da função **PW_iGetResult (PWINFO_RESULTMSG). **

PW_iPPGenericCMD

Esta função é utilizada para realizar um comando genérico no pinpad.

👍

Int16 PW_iPPGenericCMD

(Uint16 uiIndex)

➜** Entradas:**

uiIndex
Índice (iniciado em 0) do dado solicitado na última execução de PW_iExecTransac (índice do dado no vetor pvstParam).

➜** Saídas:**

Nenhuma.

➜** Retorno:**

PWRET_OK..............................Captura iniciada com sucesso, chamar PW_iPPEventLoop para obter o resultado.
PWRET_INVPARAM................O valor de uiIndex informado não corresponde a uma captura de dados deste tipo ou a essa captura de dado não foi solicitada pela biblioteca. PWRET_DLLNOTINIT..............Não foi executado PW_iInit. Outro..........................................Outro erro de execução (ver “11. Códigos de retorno”, página 93). Uma mensagem de erro pode ser obtida através da função PW_iGetResult (PWINFO_RESULTMSG).

PW_iPPPositiveConfirmation

Esta função é utilizada para realizar a confirmação positiva de um dado, ou um bloco de dados, no pinpad.

👍

Int16 PW_iPPPositiveConfirmation

(Uint16 uiIndex)

➜** Entradas:**

uiIndex
Índice (iniciado em 0) do dado solicitado na última execução de PW_iExecTransac (índice do dado no vetor pvstParam).

➜** Saídas:**

Nenhuma.

➜** Retorno:**

PWRET_OK...................................Captura iniciada com sucesso, chamar PW_iPPEventLoop para obter o resultado.
PWRET_INVPARAM.....................O valor de uiIndex informado não corresponde a uma captura de dados deste tipo ou a essa captura de dado não foi solicitada pela biblioteca. PWRET_DLLNOTINIT...................Não foi executado PW_iInit. Outro................................................Outro erro de execução (ver “11. Códigos de retorno”). Uma mensagem de erro pode ser obtida através da função PW_iGetResult (PWINFO_RESULTMSG).

PW_iPPRemoveCard

Esta função é utilizada para aguardar a remoção de um cartão com chip.

👍

Int16 PW_iPPRemoveCard

(void)

➜** Entradas:**

Nenhuma.

➜ Saídas:

Nenhuma.

➜** Retorno:**

PWRET_OK........................Captura iniciada com sucesso, chamar PW_iPPEventLoop para obter o resultado.
PWRET_INVPARAM..........Essa captura de dado não foi solicitada pela biblioteca. PWRET_DLLNOTINIT........Não foi executado PW_iInit. Outro.....................................Outro erro de execução (ver “11. Códigos de retorno”).

Outras funções

As funções descritas nesta seção permitem interagir com o pinpad fora do fluxo de uma transação.
Cada função desta seção inicia um processamento no pinpad, e retorna assim que possível.

PW_iPPDisplay

Esta função é utilizada para apresentar uma mensagem no pinpad.

👍

Int16 PW_iPPDisplay

(const char *pszMsg)

➜** Entradas:**

pszMsg
Mensagem a ser apresentada no pinpad. O caractere ‘\r’ (0Dh) indica uma quebra de linha.

➜** Saídas:**

Nenhuma.

➜ Retorno:

PWRET_OK..............................iniciada com sucesso, chamar PW_iPPEventLoop para obter o resultado.
PWRET_DLLNOTINIT.............Não foi executado PW_iInit. Outro..........................................Outro erro de execução (ver “11. Códigos de retorno”).

PW_iPPDisplayImage

Esta função é utilizada para apresentar uma imagem no pinpad.

👍

Int16 PW_iPPDisplayImage

(char *pszImagePath, int *iTimOut, Bool *fWaitKey, int *piKey)

➜** Entradas:**

pszImagePath
Caminho da imagem a ser enviada com o nome e extensão (.jpg; .png; .gif) - Tamanho max do caminho em 100 caracteres.

iTimOut
Tempo de exibição da imagem

fWaitKey
Flag para a função aguardar uma tecla ou não. TRUE (1) - retorna com o acionamento de tecla do PinPad; FALSE (0) - não retorna com acionamento de tecla do PinPad.

➜** Saídas:**

piKey
Tecla acionado mediante retorno de teclado ativo. (Campo anterior TRUE)

➜ Retorno:

PWRET_OK............................O dado foi capturado com sucesso.
PWRET_DLLNOTINIT...........Não foi executado PW_iInit. PWRET_NOTINST.................É necessário efetuar uma transação de Instalação. PWRET_CANCEL..................A operação foi cancelada pelo Cliente no pinpad (tecla [CANCEL]). PWRET_TIMEOUT................O Cliente não realizou a captura no tempo limite. PWRET_PPCOMERR............Falha na comunicação com o pinpad. PWRET_INVCALL..................Não é possível capturar dados em um pinpad não ABECS. Outro........................................Outro erro de execução (ver “11. Códigos de retorno”).

PW_iPPGetUserData

Esta função é utilizada para obter um dado digitado pelo portador do cartão no pinpad.

👍

Int16 PW_iPPGetUserData

( Uint16 uiMessageId, Byte bMinLen, Byte bMaxLen, Int16 iToutSec, char *pszData)

➜** Entradas:**

uiMessageId
Identificador da mensagem a ser exibida como prompt para a captura, seguindo a tabela abaixo:

**bMinLen ** = Tamanho mínimo do dado a ser digitado.
bMaxLen = Tamanho máximo do dado a ser digitado. iToutSec = Tempo limite para a digitação do dado em segundos.

➜ Saídas:

**pszData **
Dado digitado pelo portador do cartão no pinpad.

➜ Retorno:

PWRET_OK............................O dado foi capturado com sucesso.
PWRET_DLLNOTINIT...........Não foi executado PW_iInit. PWRET_NOTINST.................É necessário efetuar uma transação de Instalação. PWRET_CANCEL..................A operação foi cancelada pelo Cliente no pinpad (tecla [CANCEL]). PWRET_TIMEOUT................O Cliente não realizou a captura no tempo limite. PWRET_PPCOMERR............Falha na comunicação com o pinpad. PWRET_INVCALL..................Não é possível capturar dados em um pinpad não ABECS. Outro........................................Outro erro de execução (ver “11. Códigos de retorno”).

PW_iPPWaitEvent

Esta função é utilizada para aguardar a ocorrência de um evento no pinpad.

👍

PW_iPPWaitEvent

(Uint32 *pulEvent);

➜** Entradas:**

**pulEvent **
Soma dos valores referentes aos eventos a serem monitorados no pinpad (não é possível monitorar simultaneamente os eventos PWPPEVTIN_ICC e PWPPEVTIN_ICCOUT):

➜** Saídas:**

pulEvent
Evento ocorrido, conforme tabela abaixo.

Atenção: este dado somente é preenchido após retorno PWRET_OK de PW_iPPEventLoop.

➜** Retorno:**

PWRET_OK............................Captura iniciada com sucesso, chamar** PW_iPPEventLoop** para obter o resultado.
PWRET_INVPARAM.............Não é possível monitorar simultaneamente os eventos passados em pulEvent. PWRET_DLLNOTINIT...........Não foi executado PW_iInit. Outro........................................Outro erro de execução (ver “11. Códigos de retorno”).

PW_iPPGetPINBlock

Esta função é utilizada para obter o PIN block gerado a partir de um dado digitado pelo usuário no pinpad.

👍

Int16 PW_iPPGetPINBlock

(Byte bKeyID, const char_ pszWorkingKey, Byte bMinLen, Byte bMaxLen, Int16 iToutSec, const char_ pszPrompt, char* pszData);

➜ Entradas:

bKeyID
Índice da Master Key (para chave PayGo, utilizar o índice “12”).

pszWorkingKey
Sequência de 32 caracteres utilizados para a geração do PIN block (dois valores iguais digitados pelo usuário com duas pszWorkingKey diferentes irão gerar dois PIN blocks diferentes.

bMinLen
Tamanho mínimo do dado a ser digitado (a partir de 4).

bMaxLen
Tamanho máximo do dado a ser digitado (até 12).

iToutSec
Tempo limite para a digitação do dado em segundos.

pszPrompt
Mensagem de 32 caracteres (2 linhas com 16 colunas) para apresentação no momento do pedido do dado do usuário (‘\r’ para quebra de linha).

➜ Saídas:

pszData
PIN block gerado com base nos dados fornecidos na função combinados com o dado digitado pelo usuário no pinpad.

➜ Retorno:

PWRET_OK............................O dado foi capturado com sucesso.
PWRET_DLLNOTINIT...........Não foi executado PW_iInit. PWRET_NOTINST.................É necessário efetuar uma transação de Instalação. PWRET_CANCEL..................A operação foi cancelada pelo Cliente no pinpad (tecla [CANCEL]). PWRET_TIMEOUT.................O Cliente não realizou a captura no tempo limite. PWRET_PPCOMERR.............Falha na comunicação com o pinpad. PWRET_PPS_ERRPIN...........Chave com índice bKeyID não presente no pinpad. Outro.........................................Outro erro de execução (ver “11. Códigos de retorno”).

PW_iPPTestKey

Esta função é utilizada para realização de teste de chaves de PIN no pinpad.

👍

Int16 PW_iPPTestKey

(Uint16 uiIndex)

➜** Entradas:**

uiIndex
Índice (iniciado em 0) do dado solicitado na última execução de PW_iExecTransac (índice do dado no vetor pvstParam).

➜ Saídas:

Nenhuma.

➜ Retorno:

PWRET_OK............................Captura iniciada com sucesso, chamar PW_iPPEventLoop para obter o resultado.
PWRET_INVPARAM.............O valor de uiIndex informado não corresponde a uma captura de dados deste tipo ou a essa captura de dado não foi solicitada pela biblioteca. PWRET_DLLNOTINIT...........Não foi executado PW_iInit. Outro........................................Outro erro de execução (ver “11. Códigos de retorno”). Uma mensagem de erro pode ser obtida através da função **PW_iGetResult (PWINFO_RESULTMSG). **

Outras funções

Estas funções permitem executar algumas funções fora do fluxo de uma transação. Geralmente, funções de cunho administrativo.

------------------------ Função PW_iTransactionInquiry removida da DOC ---------------------------------------------

PW_iTransactionInquiry

Esta função é utilizada para realizar uma consulta de transações efetuadas por um ponto de captura junto ao PayGo.

👍

Int16 PW_iTransactionInquiry

(const char *pszXmlRequest, char* pszXmlResponse, Uint32 ulXmlResponseLen);

➜** Entradas:**

ulXmlResponseLen
Tamanho da string pszXmlResponse.

pszXmlRequest
Arquivo de entrada no formato XML, contendo as informações necessárias para fazer a consulta pretendida, seguindo o padrão abaixo:

➜** Saídas:**

pszXmlResponse
Arquivo de saída no formato XML, contendo o resultado da consulta efetuada, o arquivo de saída tem todos os elementos do arquivo de entrada, com os dados abaixo adicionados:

➜** Retorno:**

PWRET_OK...............................A consulta foi efetuada com sucesso.
PWRET_DLLNOTINIT.............Não foi executado PW_iInit. Outro..........................................Outro erro de execução (ver “11. Códigos de retorno”). Uma mensagem de erro pode ser obtida através da função PW_iGetResult (PWINFO_RESULTMSG).

Exemplos:

**pszXmlRequest **
Arquivo XML de solicitação para as transações de venda (tipo de transação 33) aprovadas e confirmadas (status 289), efetuadas com o autorizador ELAVON, do dia 15/09/2016 até o dia 16/09/2016:

<RequestTransactionHistory xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" version="1.0.0.0">
<authentication>
<login>user</login>
<password>123456</password>
</authentication>
<QueryFilter>
<TransactionAuthorizer>ELAVON</TransactionAuthorizer>
<TransactionStartDate>15/09/2016 00:00:00</TransactionStartDate>
<TransactionEndDate>16/09/2016 23:59:59</TransactionEndDate>
<ArrayOfTransactionType>
<TransactionType>33</TransactionType>
</ArrayOfTransactionType>
<ArrayOfTransactionStatus>
<TransactionStatus>289</TransactionStatus>
</ArrayOfTransactionStatus>
</QueryFilter>
<Error>
<Number />
<Description />
</Error>
</RequestTransactionHistory>

**pszXmlResponse **
Arquivo XML de resposta com as transações efetuadas no período informado (2 transações foram retornadas):

<RequestTransactionHistory version="1.0.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <authentication>
    <login>user</login>
    <password>123456</password>
  </authentication>
  <QueryFilter>
    <TransactionAuthorizer>ELAVON</TransactionAuthorizer>
    <TransactionStartDate>15/09/2016 00:00:00</TransactionStartDate>
    <TransactionEndDate>16/09/2016 23:59:59</TransactionEndDate>
    <ArrayOfTransactionType>
      <TransactionType>33</TransactionType>
    </ArrayOfTransactionType>
    <ArrayOfTransactionStatus>
      <TransactionStatus>289</TransactionStatus>
    </ArrayOfTransactionStatus>
  </QueryFilter>
  <Transactions>
    <Transaction>
      <UniqueId>329904</UniqueId>
      <AuthorizerExternalReference>00000072328</AuthorizerExternalReference>
      <InternalLocalReference>12</InternalLocalReference>
      <Status>289</Status>
      <POSTimestamp>15/09/2016 15:18:23</POSTimestamp>
      <Type>33</Type>
      <Amount>10000</Amount>
      <Discount />
      <CashBack />
      <AuthorizerName>ELAVON</AuthorizerName>
      <AuthorizerCode>ELAVON</AuthorizerCode>
      <AuthorizationCode>024662</AuthorizationCode>
      <ProductName>MASTERCARD</ProductName>
      <ResultMessage>TRANSACAO AUTORIZADA </ResultMessage>
      <ServerTimestamp>15/09/2016 15:18:23</ServerTimestamp>
      <AffiliationNumber>001941400000000004226</AffiliationNumber>
      <AuthorizationTimestamp />
      <CurrencyExponent>2</CurrencyExponent>
      <CurrencyCode>986</CurrencyCode>
      <TransactionDetails>
        <RequestPurpose>1</RequestPurpose>
        <POSData>
          <Identifier>50328</Identifier>
          <Description>Terminal de testes</Description>
        </POSData>
        <PinPadData>
          <SerialNumber>1931410242000008    </SerialNumber>
          <Version>001.29 110310   </Version>
          <Model>PPC910;3MB         </Model>
          <FirmwareVersion>0080_0072_0083_0106 </FirmwareVersion>
          <SpecificationVersion>1.07</SpecificationVersion>
        </PinPadData>
        <CardData>
          <CardBrand />
          <Type>1</Type>
          <CardName>Crédito</CardName>
        </CardData>
                <POSCompanyData>
          <TaxId>03.361.770/0001-58</TaxId>
        </POSCompanyData>
        <FinancingData>
          <Type>4</Type>
          <DueDate />
          <InstallmentsNumber>2</InstallmentsNumber>
        </FinancingData>
        <TopUpData />
        <BankingAgentData />
      </TransactionDetails>
    </Transaction>
    <Transaction>
      <UniqueId>329909</UniqueId>
      <AuthorizerExternalReference>00000072341</AuthorizerExternalReference>
      <InternalLocalReference>21</InternalLocalReference>
      <Status>289</Status>
      <POSTimestamp>16/09/2016 10:28:28</POSTimestamp>
      <Type>33</Type>
      <Amount>3000</Amount>
      <Discount />
      <CashBack />
      <AuthorizerName>ELAVON</AuthorizerName>
      <AuthorizerCode>ELAVON</AuthorizerCode>
      <AuthorizationCode>024664</AuthorizationCode>
      <ProductName>VISA ELECTRON</ProductName>
      <ResultMessage>TRANSACAO AUTORIZADA </ResultMessage>
      <ServerTimestamp>16/05/2016 10:28:28</ServerTimestamp>
      <AffiliationNumber>001941400000000004226</AffiliationNumber>
      <AuthorizationTimestamp />
      <CurrencyExponent>2</CurrencyExponent>
      <CurrencyCode>986</CurrencyCode>
      <TransactionDetails>
        <RequestPurpose>1</RequestPurpose>
        <POSData>
          <Identifier>50328</Identifier>
          <Description>Terminal de testes</Description>
        </POSData>
        <PinPadData>
          <SerialNumber>1931410242000008    </SerialNumber>
          <Version>001.29 110310   </Version>
          <Model>PPC910;3MB         </Model>
          <FirmwareVersion>0080_0072_0083_0106 </FirmwareVersion>
          <SpecificationVersion>1.07</SpecificationVersion>
        </PinPadData>
        <CardData>
          <CardBrand />
          <Type>2</Type>
          <CardName>Débito</CardName>
        </CardData>
        <POSCompanyData>
          <TaxId>03.361.770/0001-58</TaxId>
        </POSCompanyData>
        <FinancingData>
          <Type>1</Type>
          <DueDate />
          <InstallmentsNumber>1</InstallmentsNumber>
        </FinancingData>
        <TopUpData />
        <BankingAgentData />
      </TransactionDetails>
  </Transactions>
  <Error>
    <Number />
    <Description />
  </Error>
</RequestTransactionHistory>

Detalhamento Transactions

<?xml version="1.0" encoding="iso-8859-1"?>
<request version="1.0.0.0" id="">
   <authentication>
      <login></login>
      <password></password>
   </authentication>
   <Transactions>
      <QueryFilter>
         <AuthorizerStatus/>
         <MerchantLegalName/>
         <MerchantTradeName/>
         <MerchantTaxId/>
         <POSIdentifier/>
         <POSType/>
         <POSPinPadSerialNumber/>
         <POSApplication/>
         <POSApplicationVersion/>
         <ReqNum/>
         <UniqueId/>
         <TransactionType/>
         <TransactionAuthorizer/>
         <TransactionProductName/>
         <TransactionStatus/>
         <TransactionStartDate/>
         <TransactionEndDate/>
         <AuthorizerStatus/>
         <LastUniqueIdSearched/>
	 <ArrayOfUniqueId>
	      <UniqueId/>
	      <UniqueId/>
	 </ArrayOfUniqueId>
	 <ArrayOfTransactionType>
	      <TransactionType/>
	      <TransactionType/>
	 </ArrayOfTransactionType>
	 <ArrayOfTransactionStatus>
	      <TransactionStatus/>
	      <TransactionStatus/>
	 </ArrayOfTransactionStatus>
      </QueryFilter>
      <Transaction>
         <UniqueId/>
         <ReqNum/>
         <OriginalTransactionReqNum/>
         <AuthorizerExternalReference/>
         <InternalLocalReference/>
         <Status/>
         <POSTimestamp/>
         <Type/>
         <Amount/>
         <Discount/>
         <CashBack/>
         <AuthorizerName/>
         <AuthorizerCode/>
         <AuthorizerStatus/>
         <AuthorizationCode/>
         <AuthorizationType/>
         <ProductCode/>
         <ProductName/>
         <ResultCode/>
         <ResultMessage/>
         <ServerTimestamp/>
         <AffiliationNumber/>
         <ProcessingCode/>
         <ResponseCode/>
         <ResponseMessage/>
         <FullReceiptCopy/>
         <AuthorizationTimestamp/>
         <CurrencyExponent/>
         <CurrencyCode/>
         <CurrencySymbol/>
         <TaxIdentifier/>
         <CardHolderVerificationFlags/>
         <CardSecCodeEntryMode/>
         <AdditionalDataArray>
            <AdditionalData/>
            <AdditionalData/>
         <AdditionalDataArray>
         <TransactionDetails>
            <SpecificationVersion/>
            <RequestMode/>
            <RequestPurpose/>
            <OperatingSystem/>
            <ComputerName/>
            <ComputerUserName/>
            <Login/>
            <POSData>
               <ExternalId></ExternalId>
               <Identifier></Identifier>
               <Description></Description>
               <Status></Status>
               <POSType></POSType>
               <CardEntryModes>
                  <CardEntryMode></CardEntryMode>
               </CardEntryModes>
               <CardEntryModes>
                  <CardEntryMode></CardEntryMode>
               </CardEntryModes>
               <CommGroup></CommGroup>
               <CardTypes>
                  <CardType></CardType>
               </CardTypes>
               <CardTypes>
                  <CardType></CardType>
               </CardTypes>
               <InstallmentPlans>
                  <InstallmentPlan></InstallmentPlan>
               </InstallmentPlans>
               <InstallmentPlans>
                  <InstallmentPlan></InstallmentPlan>
               </InstallmentPlans>
               <Unattended></Unattended>
               <FiscalPrinter></FiscalPrinter>
               <Printer></Printer>
               <Automation></Automation>
               <PINPad></PINPad>
               <PINPadIdleMsgLine1></PINPadIdleMsgLine1>
               <PINPadIdleMsgLine2></PINPadIdleMsgLine2>
               <ConnectedAffiliations>
                  <Authorizer></Authorizer>
                  <Number></Number>
               </ConnectedAffiliations>
               <ConnectedAffiliations>
                  <Authorizer></Authorizer>
                  <Number></Number>
               </ConnectedAffiliations>
            </POSData>
            <PinPadData>
               <SerialNumber/>
               <Version/>
               <Model/>
               <FirmwareVersion/>
               <SpecificationVersion/>
            </PinPadData>
            <CardData>
               <CardBrand/>
               <CardBIN/>
               <EntryMode/>
               <Type/>
               <MaskedCardNumber/>
               <CardName/>
               <CardHolderName/>
               <ExpirationDate/>
            </CardData>
            <POSCompanyData>
               <LegalName></LegalName>
               <TradeName></TradeName>
               <Notes></Notes>
               <Individual></Individual>
               <PerformsTransactions></PerformsTransactions>
               <DisplayName></DisplayName>
               <TaxId></TaxId>
               <City></City>
               <State></State>
               <Country></Country>
               <PostalCode></PostalCode>
               <MerchantGroup>
                  <Name></Name>
                  <Option>
                     <Name></Name>
                  </Option>
                  <Option>
                     <Name></Name>
                  </Option>
               </MerchantGroup>
            </POSCompanyData>
            <AffiliationCompanyData>
               <LegalName></LegalName>
               <TradeName></TradeName>
               <Notes></Notes>
               <Individual></Individual>
               <PerformsTransactions></PerformsTransactions>
               <DisplayName></DisplayName>
               <TaxId></TaxId>
               <City></City>
               <State></State>
               <Country></Country>
               <PostalCode></PostalCode>
               <MerchantGroup>
                  <Name></Name>
                  <Option>
		    <Option>
	                <Name></Name>	
		    </Option>
		    <Option>
	                <Name></Name>	
		    </Option>
                  </Option>
               </MerchantGroup>
            </AffiliationCompanyData>            
            <FinancingData>
               <Type/>
               <DueDate/>
               <InstallmentsNumber/>
            </FinancingData>
            <RetailAutomationDetails>
               <Capabilities/>
               <Company/>
               <Name/>
               <Version/>
            </RetailAutomationDetails>
            <TopUpData>
               <AreaCode/>
               <MaskedPhoneNumber/>
            </TopUpData>
            <BankingAgentData>
               <BarCode/>
               <DueDate/>
               <EntryMode/>
               <Discount/>
               <Reduction/>
               <Fee/>
               <Amount/>
               <TotalAmount/>
            </BankingAgentData>
         </TransactionDetails>
      </Transaction>
   </Transactions>
   <Error>
      <Number/>
      <Description/>
   </Error>
</request>

Considerações Iniciais

Tipos de Dados

                                                                   ** QueryFilter Node** 

                                                             ** Transaction Node** 

                                  **                             TransactionDetailsNode** 

                                                                          ** POSData Node**
                                  Mesma estrutura que consta do cadastro de Ponto de Captura.

                                                                    **    POSCompanyData (M)**
                                 Mesma estrutura que consta do cadastro de Agrupamentos e Opções

                                                                    **    AffiliationCompanyData (O)**
                             Mesma estrutura que consta do cadastro de Entidade. Esta entidade é atrelada a afiliação que foi efetuado o pagamento, neste caso, utilizando multiestabelecimento.

                                                            **Transaction Specifics Details Nodes**
                                                                            TopUpData Node

Serviços de Pesquisa

Tabela de Valores de Códigos e Descrições para Domínio

Ponto de Captura

Dados Comuns

TransactionStatus

TransactionType

Agrupamentos e Opções

<?xml version="1.0" encoding="ISO-8859-1"?>
<RequestTransactionMerchantGroupRegistration version="">
  <authentication>
    <login></login>
    <password></password>
    <externalLoginName></externalLoginName>
  </authentication>
  <MerchantGroups>
    <MerchantGroup>
      <Identifier xmlns="http://tempuri.org/"></Identifier>
      <Name xmlns="http://tempuri.org/"></Name>
      <Options xmlns="http://tempuri.org/">
        <Option>
          <Identifier></Identifier>
          <Name></Name>
          <Restrictive>true</Restrictive>
        </Option>
        <Option>
          <Identifier></Identifier>
          <Name></Name>
          <Restrictive>true</Restrictive>
        </Option>
      </Options>
    </MerchantGroup>
  </MerchantGroups>
  <Error>
    <Number></Number>
    <Description></Description>
  </Error>
</RequestTransactionMerchantGroupRegistration>

Tipos de Dados

Entidade

<?xml version="1.0" encoding="ISO-8859-1"?>
<RequestTransactionCompanyRegistration version="1.0.0.0" id="">
   <authentication>
        <login></login>
        <password></password>
	<externalLoginName></externalLoginName>
    </authentication>
    <Company>
         <LegalName></LegalName>
         <TradeName></TradeName>
         <Notes></Notes>
         <Individual></Individual>
         <PerformsTransactions></PerformsTransactions>
         <DisplayName></DisplayName>
         <TaxId></TaxId>
         <City></City>
         <State></State>
         <Country></Country>
         <PostalCode></PostalCode>
         <MerchantGroup>
           <Name></Name>
           <Option>
              <Option>
                  <Name></Name>
              </Option>
              <Option>
                  <Name></Name>
              </Option>
           </Option>
         </MerchantGroup>
    </Company>
   <Error>
      <Number></Number>
      <Description></Description>
   </Error>
</request>

Tipos de Dados

-->