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

Gateway de pagamento PayArc Terminal

O PayArc Terminal envia uma venda do caixa para um terminal PAX da PayArc. O cliente paga no terminal, e o caixa registra o pagamento assim que a PayArc o confirma.

Esta página começa pelo uso no caixa. Para configurar o gateway de pagamento, consulte Configurar o PayArc Terminal.

Recurso Pro

O PayArc Terminal requer o WCPOS Pro 2.0 ou posterior.

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 a configuração em Caixas.

Pressione Finalizar Compra no carrinho. O PayArc Terminal aparece como uma opção na aba Pagamentos, ao lado das outras formas de pagamento.

  1. Toque na opção PayArc Terminal.
  2. Confira o terminal indicado acima do teclado numérico: Terminal: …. Se houver mais de um terminal, pressione Alterar e toque no que está no seu balcão. O caixa guarda sua escolha para a próxima vez.
  3. Para receber parte do saldo no cartão, digite o valor. O restante continua em aberto para outro pagamento.
  4. Pressione Enviar … para o PayArc Terminal. O caixa mostra No terminal com quatro etapas: Enviado, No terminal, Aprovado e Capturado.
  5. O cliente paga no terminal. Quando o pagamento é capturado e não há mais nada a pagar, o recibo é aberto. Se ainda houver um valor em aberto, receba-o com outra opção de pagamento.

Detalhes, abaixo das etapas, abre um registro do pagamento: quando ele foi enviado, quando chegou ao terminal e o valor aprovado. O pagamento armazena a bandeira do cartão, os últimos 4 dígitos, a forma de leitura do cartão e o código de autorização da PayArc.

O terminal não solicita gorjeta. Consulte Gorjetas para saber quais terminais oferecem essa opção.

Cancelar um pagamento​

Pressione Cancelar no terminal antes de o cliente pagar. O caixa aguarda a confirmação do terminal e depois mostra Pagamento cancelado.

Se a leitura do cartão já estiver em andamento, a PayArc poderá recusar o cancelamento e concluir o pagamento; o caixa continua verificando e mostra o resultado. Enquanto aguarda, exibe Cancelando — aguardando a confirmação do terminal e oferece Liberar este pagamento. A liberação permite pagar o pedido de outra forma enquanto sua loja continua verificando o terminal.

aviso

Liberar não cancela o pagamento: o terminal ainda pode recebê-lo. Confira o resultado no terminal antes de receber outro pagamento.

Se houver um problema com o pagamento​

aviso

O terminal confirmou um valor diferente? Não receba o pagamento novamente. Confira primeiro o terminal, o pedido e o painel da PayArc.

Falha no pagamento: cartão recusado

Pressione Tentar novamente para enviá-lo ao terminal de novo, ou Escolher outra forma para pagar com outra opção.

Falha no pagamento, com uma mensagem da própria PayArc

A PayArc recusou a venda, por exemplo, porque o terminal está desligado ou sem conexão. Verifique o terminal e pressione Tentar novamente.

Tempo esgotado — pagamento cancelado

Ninguém pagou em até 5 minutos, ou o terminal aguardou um cartão que não foi apresentado. Verifique o terminal e pressione Tentar novamente.

A opção PayArc Terminal está desativada

O caixa informa o motivo abaixo das opções de pagamento. Consulte todos os motivos em Quando uma opção de pagamento não pode ser usada.

  • Nenhum terminal configurado para o PayArc Terminal — a loja não tem um terminal para este gateway de pagamento. Um gerente adiciona um na etapa 4 de Configurar o PayArc Terminal.
  • Em uso pelo pedido #… — o terminal está ocupado com o pagamento de outro pedido. Conclua ou cancele esse pagamento, ou pressione Alterar e escolha outro terminal.
  • Precisa de conexão — o caixa está sem conexão. Um pagamento no terminal passa pela sua loja, então receba outra forma de pagamento ou aguarde a conexão.
Conexão instável, ainda tentando

Isso aparece no registro de Detalhes. O caixa continua verificando. Deixe a tela aberta: o pagamento continua no terminal.

Um pagamento está travado, ou o caixa informa que o provedor não respondeu
Um pagamento demora demais
  • Verifique a tela do terminal e mantenha a tela de pagamento aberta
  • Após 5 minutos, o caixa interrompe a espera e mostra Tempo esgotado — pagamento cancelado
  • Confira o terminal, as notas do pedido e o painel da PayArc antes de receber o pagamento novamente
Um pagamento anterior deste pedido feito pelo PayArc Terminal não pode ser consultado com as credenciais atuais da PayArc
  • Receba o pagamento de outra forma ou peça ajuda a um gerente. O pedido tem um pagamento anterior a uma alteração de modo ou de credenciais
  • O gerente verifica esse pagamento no painel da PayArc, no modo em que ele foi recebido
  • Para usar a PayArc neste pedido novamente, o gerente volta a PayArc para aquele modo, clica em Conectar usando estas credenciais, e você recarrega a página

Reembolsar um pagamento da PayArc​

O reembolso é enviado ao terminal que recebeu a venda, no valor total ou parcial.

  1. No WCPOS, abra o reembolso do pedido. Consulte Reembolsos.
  2. Escolha Reembolsar pelo PayArc Terminal e pressione Processar reembolso.
  3. A PayArc envia o reembolso ao terminal, onde ele é aprovado ou recusado. O reembolso fica pendente até o terminal responder, e o resultado é adicionado às notas do pedido.

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

Se um reembolso continuar pendente, confira o painel da PayArc antes de reembolsar novamente.

Se a PayArc não responder a um reembolso

Sua loja faz uma nova solicitação a cada 2 minutos, até 5 vezes, com a mesma chave de solicitação, para que a PayArc trate cada tentativa como o mesmo reembolso. Se ainda não houver resposta, ela orienta a equipe a verificar o painel da PayArc.

Pagamentos recebidos com uma versão anterior

Este pagamento da PayArc foi recebido pelo painel de pagamento de pedidos do próprio plugin. O pagamento foi recebido pela versão 0.1 da extensão, anterior ao WCPOS 2, então o gateway de pagamento não pode reembolsá-lo. Faça o reembolso no painel da PayArc ou no terminal e depois registre-o no WooCommerce com Reembolsar … manualmente.

Configurar o PayArc Terminal​

Um gerente configura o gateway de pagamento uma vez no WP Admin e depois escolhe um terminal em cada caixa.

Antes de configurar: o que você precisa

Requisitos​

A PayArc fornece seu MID, ClientSecret e SecretKey, além do número de série de um terminal que ela configurou para você.

Sua loja se comunica com cada terminal pela internet, por meio da PayArc, então não é preciso parear nada, e qualquer caixa pode usar qualquer um dos seus terminais. Sem o WCPOS Pro 2.0 ou posterior, a extensão exibe um aviso no WP Admin e não adiciona nada ao WCPOS.

Conta PayArc: Uma conta de comerciante com acesso ao PayArc Connect V3
Hardware compatível: Um terminal PAX compatível com a PayArc vinculado à sua conta
Conexões: Somente com conexão à internet. A loja envia cada pagamento a um terminal PAX pelo número de série, para que todos os caixas possam usá-lo; cada caixa escolhe seu terminal na finalização da compra
WCPOS: WCPOS Pro 2.0 ou posterior e versão 1.0 ou posterior da extensão
Servidor: WooCommerce 7.0+, PHP 7.4+ e HTTPS para o modo de produção
Moeda: USD, CAD, GBP, EUR ou JPY
Seis etapas: instalar, conectar, adicionar seu terminal, ativá-lo e escolher o terminal de cada caixa
1

Instalar o PayArc Terminal for WooCommerce

Baixe payarc-terminal-for-woocommerce.zip, versão 1.0 ou posterior, na página de versões do GitHub e envie o arquivo em Plugins > Add Plugin, depois Enviar plugin. Ative o plugin.

WP Admin > POS > Configurações > Extensões ainda pode listar a versão 0.1, desenvolvida antes do WCPOS 2. Confira a versão antes de instalar por ali.

2

Inserir suas credenciais da PayArc

  1. Acesse WP Admin > WooCommerce > Configurações > Pagamentos e abra PayArc Terminal
  2. Escolha o Modo: Live é o padrão. Use Test somente com as credenciais do painel de testes da PayArc e o aplicativo PayArc Connect Test. Nunca misture os ambientes
  3. Preencha E-mail de login da PayArc com o e-mail que você usa para acessar o painel de comerciante da PayArc
  4. Preencha MID da PayArc com o MID do perfil de comerciante da PayArc, e não com o ID do terminal
  5. Preencha ClientSecret da PayArc com o valor da seção de API do painel e SecretKey da PayArc / token de portador da API com o valor do painel da PayArc
  6. Deixe Token de portador do callback em branco, a menos que o suporte da PayArc tenha fornecido um
3

Conectar

Clique em Conectar usando estas credenciais. Se a conexão for bem-sucedida, a tela mostra Conectado à PayArc e pede que você insira ou confirme o número de série do terminal e salve. Se informar que as credenciais parecem ser do outro ambiente, altere o Modo e conecte novamente.

nota

Após qualquer alteração no Modo ou em uma credencial, clique em Conectar usando estas credenciais novamente e salve. Depois que o PayArc Terminal for ativado no WCPOS (etapa 5), salvar exibirá um erro até você fazer isso. Enquanto houver um pagamento em andamento no terminal, você não poderá alterar o modo, as credenciais ou a conexão.

4

Adicionar seu terminal

  1. Preencha Número de série do terminal com o número da etiqueta S/N na parte traseira do dispositivo PAX, conforme configurado pela PayArc para sua conta
  2. Escolha Tipo de pagamento e Imprimir recibo
  3. Verifique se a URL do webhook usa HTTPS. Forneça-a à PayArc somente se ela solicitar
  4. Clique em Salvar alterações

O caixa oferece este terminal e todos os terminais que o cadastro de terminais da PayArc lista como habilitados para sua conta. Conectar consulta o cadastro, e Atualizar terminais faz uma nova consulta. Um terminal marcado como desabilitado pela PayArc fica fora da lista, mesmo quando é o número de série que você digitou. Um número de série digitado que não conste no cadastro ainda será oferecido. O modo de produção exige um site com HTTPS.

5

Ativar no WCPOS

  1. Acesse WP Admin > POS > Configurações > Finalização de compra
  2. Encontre PayArc Terminal na lista e ative a opção Habilitado
  3. A opção de pagamento aparece no caixa no próximo carregamento da página
nota

Essa é a única opção que controla a ativação. A opção Habilitado na lista de pagamentos do WooCommerce não tem efeito, e o PayArc Terminal nunca é oferecido na finalização de compra da sua loja virtual. Consulte Configurações do caixa.

6

Escolher o terminal de cada caixa

Em cada caixa, abra Configurações > Leitores de cartão. Seus terminais PayArc aparecem em Leitores inteligentes, um por linha, todos marcados como Online: a PayArc não informa se um terminal está ligado. Pressione Usar este leitor no terminal daquele balcão; a linha dele passa a mostrar Selecionado. O operador de caixa ainda pode pressionar Alterar na finalização da compra.

Com apenas um terminal PayArc, não há nada para escolher: ele já aparece como Selecionado em todos os caixas. Uma linha com Definido pela loja significa que os caixas estão restritos ao terminal padrão da loja. Consulte Escolher um leitor inteligente.

Referência das configurações​

Tudo o que está na página do gateway de pagamento em WP Admin > WooCommerce > Configurações > Pagamentos > PayArc Terminal.

Todas as configurações do PayArc Terminal
ConfiguraçãoO que faz
TítuloO nome da opção de pagamento no caixa; o padrão é PayArc Terminal
DescriçãoA descrição da forma de pagamento; o padrão é Pay in person at a PayArc PAX terminal.
ModoLive (padrão) ou Test. O modo de teste exige credenciais do painel de testes da PayArc e o aplicativo PayArc Connect Test
E-mail de login da PayArcSeu e-mail de login no painel de comerciante da PayArc; obrigatório antes de conectar
MID da PayArcO MID do comerciante no seu perfil de comerciante da PayArc, e não o ID do terminal
ClientSecret da PayArcO segredo da seção de API do painel; armazenado apenas no seu servidor
SecretKey da PayArc / token de portador da APIO token do painel da PayArc, usado para fazer login e consultar o cadastro de terminais
Token de portador do callbackOpcional. Preencha somente se o suporte da PayArc tiver fornecido um
Conexão com a PayArcBotões Conectar usando estas credenciais, Atualizar terminais e Desconectar
Número de série do terminalO S/N do PAX configurado pela PayArc para sua conta. Obrigatório para pagamentos
Tipo de pagamentoCREDIT (padrão) ou DEBIT
Imprimir reciboImpressão no terminal: 0 - No receipt (padrão), 1 - Merchant receipt, 2 - Customer receipt ou 3 - Both receipts
URL do webhookEndereço de callback somente para leitura. Verifique se usa HTTPS; forneça-o à PayArc somente se ela solicitar
Diagnóstico da PayArcInformações de conexão e um botão Validar configurações; os segredos nunca são exibidos

Os campos de segredo salvos mostram apenas os últimos 4 caracteres. Deixe um campo de segredo em branco para manter o valor salvo.

A tabela Diagnóstico da PayArc mostra o modo, os endpoints da PayArc, se o e-mail de login e o token de acesso do Connect estão definidos, o MID, o ID do tenant e o número de série do terminal mascarados, quantos terminais foram encontrados, a URL do webhook, o horário do último callback e o último erro da PayArc. Validar configurações verifica as configurações salvas e lista o que está faltando.

Desconectar limpa a conexão salva com a PayArc, a lista de terminais e o Número de série do terminal. Suas credenciais são mantidas para que você possa se conectar novamente com rapidez. Confira o número de série antes de salvar.

Logs​

Ao pedir ajuda, envie o número do pedido e as linhas relevantes do log.

Encontrar logs para o suporte

Encontre os logs em WooCommerce > Status > Logs, na origem payarc-terminal-for-woocommerce. Os identificadores são mascarados e os segredos são removidos.

Não há um pacote de suporte para download. Não compartilhe MIDs completos, IDs de terminais, tokens ou dados de cartão.

Escopo e limitações​

  • Sem gorjetas no terminal
  • Um terminal recebe um pagamento por vez; enquanto estiver ocupado, os outros caixas mostram Em uso pelo pedido #…
  • As moedas são limitadas a USD, CAD, GBP, EUR e JPY
  • A conexão não informa se um terminal está ligado: uma venda enviada a um terminal sem conexão falha imediatamente, sem que nada seja enviado a ele
  • Pagamentos recebidos pela versão 0.1 da extensão são reembolsados na PayArc, e não pelo gateway de pagamento
  • O reembolso é enviado ao terminal que recebeu a venda

Se houver um problema na configuração​

Problemas comuns​

Estas parecem ser credenciais de teste (ou de produção) da PayArc
  • O modo selecionado e as credenciais são de ambientes diferentes da PayArc
  • Altere o Modo para o indicado na mensagem ou substitua as credenciais pelas do modo selecionado
  • Clique em Conectar usando estas credenciais novamente e salve
Não foi possível conectar à PayArc
  • A PayArc recusou o login. Confira as credenciais inseridas e tente novamente
  • Consulte WooCommerce > Status > Logs, na origem payarc-terminal-for-woocommerce, para ver os detalhes
A URL de callback precisa usar HTTPS antes de ativar o modo de produção
  • O modo de produção exige que seu site use HTTPS para que a PayArc consiga acessar a URL do webhook
  • Passe o site para HTTPS ou use o modo Teste em um site de testes
O cadastro de terminais está vazio
  • Nesse caso, o caixa oferece apenas o terminal indicado em Número de série do terminal, e os pagamentos nele continuam funcionando
  • Peça à PayArc que confirme esse número de série para sua conta e liste seus outros terminais se você quiser que o caixa os ofereça
  • Clique em Atualizar terminais depois que a PayArc os adicionar
A PayArc rejeitou tanto o AccessToken do Connect quanto a SecretKey
  • A PayArc recusou o acesso à API de transações para sua conta
  • Peça ao suporte da PayArc que confirme se o PayArc Connect V3 está habilitado para sua conta de comerciante e qual credencial autoriza as transações

Obter ajuda​

  • Inclua o número do pedido e as linhas relevantes do log na sua solicitação de suporte
  • Acesse o repositório no GitHub para relatar problemas
  • Entre em contato com o suporte da PayArc para questões sobre sua conta, o PayArc Connect e a configuração do terminal