Pular para o conteúdo principal
Versão: 2.x

Gateway de pagamento Windcave Terminal

O Windcave Terminal envia uma venda do caixa para um terminal Windcave. O cliente paga no terminal, e o caixa registra o pagamento quando a Windcave o confirma.

Esta página começa no caixa. Administradores da loja: Configurar o Windcave Terminal explica as credenciais, as configurações do WP Admin e como verificar se tudo funcionou.

Recurso Pro

O Windcave Terminal requer WCPOS Pro 2.0 ou posterior e a versão 1.0 ou posterior da extensão.

Ainda não certificado pela Windcave

Somente pagamentos de teste: ainda não aceite o cartão de um cliente real na Windcave. A Windcave aprova todas as integrações de ponto de venda antes que elas recebam pagamentos reais, e ainda não aprovou esta integração.

O que ainda não foi testado

A extensão ainda não foi executada em um terminal Windcave físico. Os pagamentos e reembolsos foram testados com um serviço HIT simulado, criado com base na documentação da Windcave. Faça uma pequena venda UAT e reembolse-a antes de confiar na integração.

Receber um pagamento com cartão​

Abra o caixa primeiro

Com Abrir e fechar o caixa ativado, o caixa não registra pagamentos enquanto estiver fechado, e um pagamento com cartão já recebido precisaria ser reembolsado. Consulte Caixas para ver essa configuração.

  1. Pressione Finalizar Compra no carrinho e toque no bloco Windcave Terminal na aba Pagamentos. Se os terminais solicitarem uma assinatura, use a aba Legado: consulte Quando o terminal faz uma pergunta.
  2. Olhe acima do teclado. Se aparecer Escolha um terminal, toque no ID da estação do terminal no seu balcão: o nome que a Windcave atribui a cada terminal, como DOCS-STATION-1. Se aparecer Terminal: e um ID, esse é o terminal usado por este caixa; pressione Alterar para escolher outro. O caixa memoriza sua escolha.
  3. Para cobrar parte do saldo no cartão, digite o valor. O restante continuará pendente para outro pagamento.
  4. Pressione Enviar … para o Windcave Terminal. O caixa mostra No terminal com quatro etapas: Enviado, No terminal, Aprovado e Capturado, o que significa que o valor foi cobrado.
  5. O cliente aproxima, insere ou passa o cartão no terminal. Quando o pagamento é capturado e não resta nenhum valor a pagar, o recibo é aberto. Se ainda restar algum valor, receba-o usando outro bloco.
Checkout na aba Pagamentos para uma venda de $45.00: bloco Windcave Terminal selecionado, dois IDs da estação abaixo de Escolha um terminal, Saldo total abaixo deles e botão Enviar $45.00 para o Windcave Terminal esmaecido até que um terminal seja escolhido
  1. Windcave Terminal — o bloco, contornado depois que você toca nele.
  2. IDs da estação em Escolha um terminal — toque no terminal do seu balcão. Depois que este caixa tiver um terminal, esta linha mostrará Terminal: e seu ID, com Alterar.
  3. A pagar — o valor deste pagamento. Digite um valor menor para cobrar parte do saldo no cartão.
  4. Saldo total — coloca novamente em A pagar o valor total ainda devido.
  5. Enviar … para o Windcave Terminal — inicia o pagamento no terminal. O botão fica esmaecido até que um terminal seja escolhido.
  6. Legado — a outra aba de pagamento, para gateways com página de pagamento própria. Use-a quando o terminal solicitar uma assinatura.

Detalhes, abaixo das quatro etapas, abre um registro do pagamento, incluindo a estação usada. O terminal não aceita gorjeta, acréscimo nem saque.

Quando o terminal faz uma pergunta​

Um terminal pode parar e perguntar algo, como se a assinatura do cliente corresponde. Nesta versão, a aba Pagamentos não mostra essas perguntas. A aba Legado mostra:

  1. Abra a aba Legado e escolha Windcave Terminal. Consulte A aba Legado.
  2. Inicie o pagamento nessa aba. O pedido inteiro é cobrado em um único pagamento.
  3. Quando o terminal fizer uma pergunta, a página de pagamento a mostrará com os botões do próprio terminal, como SIM e NÃO. Pressione a resposta.

Cancelar um pagamento​

Pressione Cancelar no terminal antes que o cliente pague. Isso só funciona enquanto o próprio terminal oferece CANCELAR. Caso contrário, o caixa informa O terminal não está oferecendo a opção de cancelar agora. Cancele no terminal.

Cancelar é uma solicitação. Se o cartão já tiver sido lido, o pagamento ainda poderá ser concluído: o caixa mostrará Cancelando — aguardando confirmação do terminal, continuará verificando e exibirá o resultado. Aguarde antes de receber o pagamento de outra forma.

Se o caixa não conseguir obter uma resposta, oferecerá Liberar este pagamento. Liberar não significa cancelar: pressione esse botão somente depois que um gerente verificar no portal da Windcave que não há um pagamento aprovado para o pedido. Em seguida, o pedido poderá ser pago de outra forma, enquanto a loja continua verificando o terminal.

Se algo der errado​

Quando o cliente talvez já tenha pago​

Não receba o pagamento novamente

Nestes dois casos, o cartão talvez já tenha sido cobrado. Primeiro, um gerente verifica no portal da Windcave, onde a venda aparece pelo número do pedido.

Não foi possível confirmar o resultado do terminal. Verifique a Windcave antes de receber o pagamento novamente. O caixa consultou novamente um pagamento que já havia enviado, mas a resposta da Windcave não foi clara. Só receba o pagamento novamente depois que um gerente procurar a venda no portal e confirmar que ela não está lá.

Falha no pagamento: o terminal confirmou outro valor. O terminal aprovou um valor diferente daquele enviado pelo caixa, então o caixa não o registrou, mas o cartão talvez tenha sido cobrado. Não receba outro pagamento: peça a um gerente que localize a venda no portal pelo número do pedido e compare o valor cobrado pelo terminal com o do pedido.

Outras mensagens​

Falha no pagamento: cartão recusado

Pressione Tentar novamente para reenviar ao terminal ou Escolher outra forma para pagar usando outro bloco.

O terminal ainda está concluindo uma transação anterior

A estação está ocupada com outro pagamento. Conclua ou cancele-o no terminal e pressione Tentar novamente.

O pagamento falha logo depois de ser enviado

A extensão aguarda 30 segundos para que a Windcave registre um novo pagamento. Se ainda não houver registro nesse prazo, a extensão considera que ele não foi enviado e o pagamento falha. Verifique se o terminal está ligado e online e se o ID da estação está nas configurações; em seguida, pressione Tentar novamente.

O terminal faz uma pergunta e o caixa continua aguardando

A aba Pagamentos não mostra as perguntas do terminal, então o caixa aguarda até o pagamento terminar. Pressione Cancelar no terminal ou cancele diretamente no terminal; em seguida, receba o pagamento na aba Legado. Consulte Quando o terminal faz uma pergunta.

Tempo limite esgotado — pagamento cancelado

Ninguém pagou em 5 minutos. Verifique o terminal e pressione Tentar novamente.

O bloco Windcave Terminal está esmaecido ou não aparece

Abaixo dos blocos, o caixa informa o motivo. Consulte Quando não é possível usar um bloco para ver todos os motivos.

  • Em uso pelo pedido #… — a estação está ocupada com o pagamento de outro pedido. Conclua ou cancele esse pagamento, ou pressione Alterar e escolha outra estação.
  • Requer conexão — o caixa está offline. O pagamento pelo terminal passa pela sua loja; receba de outra forma ou aguarde a conexão.
  • Nenhum bloco — faltam ao gateway o Nome de usuário HIT, a Chave HIT ou os IDs da estação, ou ele não está ativado no WCPOS. Um gerente verifica a configuração.

Reembolsar um pagamento da Windcave​

O reembolso é feito pela Windcave à estação que recebeu a venda, pelo valor total ou parcial.

  1. No POS, abra o reembolso do pedido. Consulte Reembolsos.
  2. Escolha Reembolsar pelo Windcave Terminal e pressione Processar reembolso.
  3. Sua loja aguarda até 20 segundos pela resposta da Windcave e, em seguida, adiciona o resultado às notas do pedido.

Um reembolso no WP Admin, usando o botão Reembolsar … pelo Windcave Terminal do WooCommerce, funciona da mesma forma.

Se um reembolso continuar pendente, verifique-o no portal da Windcave antes de reembolsar novamente.

Um reembolso continua pendente

A Windcave não respondeu em 20 segundos ou aprovou um valor diferente do solicitado. Sua loja não tenta novamente. Localize o reembolso no portal da Windcave: se tiver sido processado, o cliente recebeu o dinheiro; caso contrário, faça o reembolso novamente.

Uma venda recebida com a versão 0.1 não pode ser reembolsada

O reembolso é interrompido com a mensagem Configure uma estação padrão nas configurações do POS antes de reembolsar esta venda. A versão 0.1 da extensão não registrava qual estação recebeu a venda, então a versão 1.0 a reembolsa usando uma estação padrão para toda a loja. Agora, cada caixa escolhe sua estação em Configurações > Leitores de cartão, e o WCPOS 2.0 ainda não tem uma estação padrão para toda a loja. Reembolse a venda no portal da Windcave ou no terminal e registre-a no WooCommerce usando Reembolsar … manualmente.

Configurar o Windcave Terminal​

Um administrador faz isso uma vez por loja no WP Admin e, depois, escolhe uma estação em cada caixa. Sua loja se comunica com cada terminal pela Windcave via internet; não é necessário pareá-los, e qualquer caixa pode usar qualquer terminal.

Requisitos​

Você precisa das credenciais HIT, de um Nome de usuário HIT, de uma Chave HIT e do ID da estação de cada terminal. A Windcave fornece tudo isso; o WP Admin não consegue localizar nem criar essas informações. Entre em contato com a Windcave e solicite credenciais HIT de UAT e o ID da estação de cada terminal, ou use o formulário de requisitos de integração da Windcave para obter uma conta de desenvolvimento. UAT e produção têm nomes de usuário e chaves próprios, e a Windcave fornece um ID do fornecedor quando certifica a integração.

Conta Windcave: Credenciais HIT e um ID da estação por terminal. Use credenciais UAT até que a Windcave certifique a integração
Terminal: Um terminal Windcave que aceite pagamentos HIT
WCPOS: WCPOS Pro 2.0 ou posterior e versão 1.0 ou posterior da extensão
Servidor: WooCommerce e PHP 7.4 ou posterior com a extensão DOM (php-xml)

Instalar a extensão​

Abra WP Admin > POS > Configurações > Extensões, localize Windcave Terminal for WooCommerce, instale e ative a extensão. Você precisa da versão 1.0 ou posterior; a versão 0.1 é para o WCPOS anterior à 2.0. Consulte Extensões.

Você também pode enviar o arquivo zip do plugin (não o zip do código-fonte) pela página de versões do GitHub, em Plugins > Add Plugin > Enviar plugin.

Sem o WCPOS Pro 2.0, o WP Admin exibe Windcave Terminal requires WooCommerce POS Pro 2.0 or newer. e o gateway não é adicionado. A ativação é recusada no PHP anterior à versão 7.4 ou sem a extensão DOM: peça ao provedor de hospedagem para habilitar php-xml.

Inserir suas credenciais HIT​

Acesse WP Admin > WooCommerce > Configurações > Pagamentos e abra Windcave Terminal.

WP Admin, configurações do Windcave Terminal: Ambiente UAT (teste), campos Nome de usuário HIT, Chave HIT, IDs da estação e ID do fornecedor vazios, e nome do POS WCPOS
  1. Ambiente — mantenha UAT (teste), a opção padrão. Produção deve ser usada depois que a Windcave certificar a integração, com credenciais de produção.
  2. Nome de usuário HIT — fornecido pela Windcave para o ambiente escolhido.
  3. Chave HIT — fornecida pela Windcave. Depois de salva, o campo permanece em branco: deixe-o assim para manter a chave salva.
  4. IDs da estação — um por linha, um para cada terminal. A Windcave os fornece; eles não são encontrados automaticamente.
  5. ID do fornecedor — deixe vazio até que a Windcave forneça um.
  6. Nome do POS — como seu POS é identificado na Windcave. O padrão é WCPOS.

Abaixo deles, Notificações de resultado (FPRN) é opcional. Quando marcada, a Windcave também avisa sua loja quando um resultado está pronto, como alternativa às verificações feitas pelo caixa. Para funcionar, seu site precisa estar acessível pela internet.

Clique em Salvar alterações.

Ativar no WCPOS​

Acesse WP Admin > POS > Configurações > Finalização de compra, localize Windcave Terminal na tabela Gateways e ative Ativado. Essa tela salva as alterações automaticamente; não há botão Salvar.

Deixe Ativar/Desativar desativado na página de configurações do WooCommerce. O POS usa o gateway assim que Ativado é ativado aqui, independentemente de essa caixa estar marcada. Consulte Configurações de finalização da compra.

WP Admin, configurações do POS, finalização da compra: duas linhas da tabela Gateways, Vipps MobilePay ativado e Windcave Terminal desativado
  1. Windcave Terminal — a linha da extensão na tabela Gateways.
  2. Ativado — a opção ao lado do ID do gateway; ative-a. O bloco Windcave Terminal aparecerá no caixa depois que ele for recarregado.

Escolher a estação de cada caixa​

Em cada caixa, abra Configurações > Leitores de cartão. Todos os IDs da estação inseridos aparecem como leitores em Leitores inteligentes, marcados como Online: a extensão não consulta a Windcave para saber se um terminal está ligado. Pressione Usar este leitor na estação desse balcão; a linha mostrará Selecionado. O caixa ainda poderá pressionar Alterar na finalização da compra.

Se houver apenas uma estação, não há nada a escolher: ela já estará Selecionada em todos os caixas. Consulte Escolher um leitor inteligente.

Verificar se funcionou​

  1. Na página de configurações do Windcave Terminal, a linha abaixo das configurações mostra uat: HIT credentials configured (not verified). Isso significa que o nome de usuário e a chave foram salvos, não que a Windcave os aceitou. HIT credentials missing. significa que um deles está vazio.
  2. Em um caixa, recarregue o POS e pressione Finalizar Compra. O bloco Windcave Terminal aparecerá entre as formas de pagamento. Toque nele: os IDs da estação aparecerão acima do teclado, em Escolha um terminal ou como Terminal: e o terminal usado por esse caixa.
  3. Faça uma pequena venda em um terminal UAT e depois reembolse-a. Não há botão para testar a conexão: essa primeira venda verifica as credenciais e o ID da estação.

Atualizar da versão 0.1​

  • Primeiro atualize o WCPOS, o WCPOS Pro e o aplicativo para a versão 2.0; depois, atualize a extensão.
  • Um pagamento em andamento durante a atualização é mantido. Nenhum valor será cobrado duas vezes.
  • Um pagamento separado pela versão 0.1 é mantido se o pedido ainda não tiver sido pago. Caso contrário, o pedido recebe uma nota: Windcave TxnRef … foi separado antes da atualização para 1.0.0 e não é mais acompanhado automaticamente. Verifique o pagamento no portal da Windcave: se tiver sido aprovado, reembolse-o lá ou registre-o manualmente no pedido.
  • Estas configurações da versão 0.1 foram removidas: ID da estação padrão, Bloquear seleção do terminal, Logs do checkout e Nível de log. Agora, os caixas escolhem sua estação em Configurações > Leitores de cartão.
  • A opção de separar o pagamento também foi removida, e o texto do recibo do terminal não é mais adicionado ao pedido como nota privada.
  • Para reembolsar uma venda recebida com a versão 0.1, consulte Reembolsar um pagamento da Windcave.

Referência de configurações​

Em WP Admin > WooCommerce > Configurações > Pagamentos > Windcave Terminal:

ConfiguraçãoO que faz
Ativar/DesativarDisponibiliza o gateway no checkout da sua loja online. Deixe desativado; o POS tem uma opção própria em POS > Configurações > Finalização de compra
TítuloO nome do bloco no caixa. O padrão é Windcave Terminal
DescriçãoO padrão é Pay in person on the Windcave terminal.
AmbienteUAT (teste) (padrão) ou Produção. Cada ambiente tem suas próprias credenciais HIT; a produção requer certificação da Windcave. Um pagamento iniciado em um ambiente é sempre verificado nele
Nome de usuário HITFornecido pela Windcave para o ambiente escolhido
Chave HITFornecida pela Windcave. Nunca é exibida depois de salva; deixe o campo vazio para mantê-la
IDs da estaçãoUm por linha, um por terminal. IDs duplicados são descartados
ID do fornecedorDefinido com a Windcave durante a certificação. Deixe vazio até lá
Nome do POSO nome pelo qual seu POS é identificado na Windcave. O padrão é WCPOS
Notificações de resultado (FPRN)A Windcave também avisa sua loja quando um resultado está pronto, como complemento às verificações do caixa. Desativado por padrão

Logs e pacote de suporte​

No fim da página de configurações ficam o pacote de suporte, a linha de credenciais e um link para os logs.

WP Admin, final da página de configurações do Windcave Terminal em uma loja ainda não configurada: pacote de suporte com o botão Baixar pacote de suporte, linha uat: HIT credentials missing e Ver logs
  1. Linha de credenciais — nesta loja ainda não configurada, aparece HIT credentials missing.. Na sua, deve aparecer HIT credentials configured (not verified).
  2. Ver logs — abre WooCommerce > Status > Logs, origem windcave-terminal.
  3. Baixar pacote de suporte — um arquivo para o suporte do WCPOS.

Os logs registram cada solicitação enviada à Windcave e a respectiva resposta, ocultando a chave HIT e os números dos cartões.

Quando ocorrer um problema com um pagamento, clique em Baixar pacote de suporte e envie o arquivo ao suporte do WCPOS junto com o número do pedido. O WCPOS Pro adiciona esse botão: o pacote inclui todos os provedores de pagamento do POS no seu site, sem segredos nem números de cartão.

O que a integração não faz​

  • Pagamentos reais, até que a Windcave certifique a integração.
  • Gorjetas, acréscimos, saques ou autorizações com captura posterior.
  • Responder às perguntas do terminal na aba Pagamentos. Use a aba Legado.
  • Encontrar terminais automaticamente: você precisa digitar cada ID da estação.
  • Verificar as credenciais HIT antes do primeiro pagamento.
Como funciona, para desenvolvedores

O gateway usa o HIT (Host Initiated Transaction) da Windcave por HTTPS: uat.windcave.com para UAT e sec.windcave.com para produção. Cada terminal é identificado pelo ID da estação.

Um pagamento envia uma Purchase com o valor no caixa, Order # e o número do pedido como referência do comerciante; em seguida, o WCPOS Pro verifica o status até a conclusão. Se o caixa consultar novamente, a extensão primeiro consulta a mesma referência de transação, em vez de iniciar outra Purchase. Uma Purchase que a Windcave não registrar em 30 segundos é considerada não enviada.

Com Notificações de resultado (FPRN) ativadas, cada Purchase solicita que a Windcave chame o webhook de pagamentos do WCPOS da sua loja, wp-json/wcpos/v2/payments/webhook com provider=windcave e a referência da transação. Essa chamada é apenas um aviso: em seguida, a loja consulta o resultado diretamente à Windcave.

Um reembolso é uma operação Refund HIT vinculada à transação original da Windcave, pelo valor informado. A loja verifica o status a cada 2 segundos, por até 20 segundos.