Zoop Developer Center

Bem-vindo ao hub do desenvolvedor Zoop. Você encontrará guias da API e uma documentação abrangente para ajudá-lo a começar a trabalhar com a Zoop o mais rápido possível, além de ajudá-lo se você tiver algum problema. Vamos lá!

Documentação    Referência da API

Integração por Mensagens do Windows

Introdução

O Zoop Checkout Lite é uma aplicação Windows desenvolvida em C#, .Net (CLR VERSÃO) que pode ser utilizada de forma independente, stand alone, instalada no computador com sistema operacional Windows do Estabelecimento Comercial (seller).

O modelo de integração utiliza mensagens do Windows WM_COPYDATA, disponíveis em todas as tecnologias Windows em aplicações com janelas.

Para aplicações sem janelas, oferecemos os modelos de integração via Process IO ou File IO.

O fluxo é dividido em 3 partes (detalhadas na seção 2):

1) Aplicação Inicia a cobrança com o envio da mensagem charge

2) Aplicação responde as mensagens que demandam interface gráfica como:

  • Apresentar mensagens para o operador da Aplicação PDV (ApplicationDisplayListener, métodos showMessage com ou sem detalhes)
  • Responder a mensagens com solicitação de informações adicionais sobre o cartão, geralmente em transações com cartões de tarja magnética (extraCardInformation). Essas informações podem ser: 4 últimos digitos e/ ou CVV (CVC2, 3 números atrás do cartão) e/ ou data de expiração.

3) Finalização da transação com a possibilidade de transação aprovada (paymentSuccessful), transação falhou (paymentFailed) ou transação abortada pelo usuário ou operador, clicando o botão de cancelar do pinpad ou cancelar no Sistema PDV (transactionAborted). Além disso, uma transação aprovada pode solicitar a assinatura do portador (cardholderSignatureRequested).

As mensagens são strings com formato JSON, com o atributo “message” com o identificador da mensagem e os parâmetros adicionais de cada mensagem.

As respostas também devem ser feitas usando o padrão JSON, detalhado na seção 3.

Abaixo o diagrama com o fluxo de troca de mensagens para realizar uma cobrança (charge):

No código de exemplo fornecido, o processo é inicializado com 2 parâmetros. O tipo de integração no primeiro parâmetro, integration=wm e o título da janela como segundo parâmetro. O título da janela é utilizado para que a aplicação PDV encontre a janela e possa enviar e receber as mensagens WM_COPYDATA.

As mensagens WM_COPYDATA devem ser respondidas como recebidas/ processadas em todos os casos.

No caso das mensagens ExtraCardInformation, aonde os 4 últimos digitos (cardLast4Digits), CVV ou CVV (cardCVCRequested) ou data de expiração (cardExpirationDate Requested) forem chamados, a aplicação deve responder mesmo que a resposta não seja informada pelo usuário/ operador ou que a Aplicação PDV não tenha implementado a resposta, pois a transação estará esperando esses dados para completar o processamento.

Ao finalizar a transação o executável que foi inicializado pela Aplicação PDV é finalizado e o código de retorno deve ser 0 (zero) se tudo correu bem.

Integração por Mensagens do Windows


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.