Estrutura da aplicação

A estrutura de aplicação da integração PlugPag, ou seja, a comunicação entre sua aplicação comercial, os terminais PagBank e os servidores PagBank, seguem o mesmo padrão independente do sistema operacional. A comunicação entre a automação comercial e os terminais é realizada via bluetooth, e a comunicação com os servidores é realizada via GSM/WIFI.

Apesar da estrutura operacional ser a mesma independente do sistema operacional, diferenças podem existir dependendo das versões dos terminais PagBank. Os terminais Moderninha PRO e WIFI possuem um chip para conexão GSM e podem se conectar a redes WIFI. O mesmo não ocorre com terminal Minizinha que necessita que sua atomação comercial tenha coneção GSM/WIFI para possibilitar a integração.

Terminais Moderninhas PRO e WIFI

Na sequência você encontra exemplos do fluxo de informações entre sua automação comercial, os terminais Moderninhas PRO e WIFI e os servidores PagBank.

Fluxo de Integração

O fluxo de integração PlugPag para os terminais Moderninhas PRO e WIFI, a automação comercial se conecta via Bluetooth ao terminal e este se conecta via GSM/WIFI aos servidores PagBank.

Fluxo normal para transações com sucesso

O fluxo de informações que ocorre quando uma transação é bem sucedida, a automação comercial (integrador) envia o comando de inicialização de conexão bluetooth e de solicitação de transação via PlugPag, que faz a comunicação com o terminal, e este processa a informação junto aos servidores PagBank. Em caso de sucesso, uma mensagem de retorno bem sucedido é enviado ao integrador via PluPag.

Fluxo com erro

O fluxo de informações que ocorre quando uma transação não é bem sucedida. No exemplo abaixo isso ocorre ao processar a informação de pagamento junto aos servidores PagBank que irá retornar os detalhes do motivo da falha.

Fluxo em caso de timeout

O fluxo de informações que ocorre quando uma transação não é bem sucedida, neste exemplo isso ocorreu ao solicitar a conexão bluetooth com o terminal, que por sua vez irá dar o retorno com a mensagem de falha Timeout. Para garantir que esta transação de fato não ocorreu, o integrador pode solicitar as informações da última transação bem sucedida.

Terminal Minizinha

Na sequência você encontra exemplos do fluxo de informações entre sua automação comercial, o terminal Minizinha e os servidores PagBank.

Fluxo de Integração

O fluxo de integração PlugPag para o terminal Minizinha, o terminal se conecta via bluetooth à automação comercial e esta se conecta via GSM/WIFI aos servidores PagBank.

Fluxo normal para transações com sucesso

Em uma transação bem-sucedida, a automação comercial envia comandos via PlugPag para iniciar a conexão Bluetooth e solicitar a transação. O PlugPag comunica-se com o terminal, que processa as informações nos servidores do PagBank. Em caso de sucesso, uma mensagem de retorno bem sucedido é enviado ao integrador via PluPag, assim como as mensagens de inserção e remoção de cartão.

Fluxo com erro

O fluxo de informações que ocorre quando uma transação não é bem sucedida. Nesse exemplo o problema ocorre ao solicitar a conexão bluetooth com o terminal, que por sua vez irá dar o retorno com a mensagem de falha Timeout.