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.
O PayArc Terminal requer o WCPOS Pro 2.0 ou posterior.
Receber um pagamento com cartão
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.
- Toque na opção PayArc Terminal.
- 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.
- Para receber parte do saldo no cartão, digite o valor. O restante continua em aberto para outro pagamento.
- Pressione Enviar … para o PayArc Terminal. O caixa mostra No terminal com quatro etapas: Enviado, No terminal, Aprovado e Capturado.
- 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.
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
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.
- No WCPOS, abra o reembolso do pedido. Consulte Reembolsos.
- Escolha Reembolsar pelo PayArc Terminal e pressione Processar reembolso.
- 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.
Seis etapas: instalar, conectar, adicionar seu terminal, ativá-lo e escolher o terminal de cada caixa
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.
Inserir suas credenciais da PayArc
- Acesse
WP Admin > WooCommerce > Configurações > Pagamentose abra PayArc Terminal - Escolha o Modo:
Liveé o padrão. UseTestsomente com as credenciais do painel de testes da PayArc e o aplicativo PayArc Connect Test. Nunca misture os ambientes - Preencha E-mail de login da PayArc com o e-mail que você usa para acessar o painel de comerciante da PayArc
- Preencha MID da PayArc com o MID do perfil de comerciante da PayArc, e não com o ID do terminal
- 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
- Deixe Token de portador do callback em branco, a menos que o suporte da PayArc tenha fornecido um
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.
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.
Adicionar seu terminal
- 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
- Escolha Tipo de pagamento e Imprimir recibo
- Verifique se a URL do webhook usa HTTPS. Forneça-a à PayArc somente se ela solicitar
- 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.
Ativar no WCPOS
- Acesse
WP Admin > POS > Configurações > Finalização de compra - Encontre PayArc Terminal na lista e ative a opção Habilitado
- A opção de pagamento aparece no caixa no próximo carregamento da página
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.
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ção | O que faz |
|---|---|
| Título | O nome da opção de pagamento no caixa; o padrão é PayArc Terminal |
| Descrição | A descrição da forma de pagamento; o padrão é Pay in person at a PayArc PAX terminal. |
| Modo | Live (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 PayArc | Seu e-mail de login no painel de comerciante da PayArc; obrigatório antes de conectar |
| MID da PayArc | O MID do comerciante no seu perfil de comerciante da PayArc, e não o ID do terminal |
| ClientSecret da PayArc | O segredo da seção de API do painel; armazenado apenas no seu servidor |
| SecretKey da PayArc / token de portador da API | O token do painel da PayArc, usado para fazer login e consultar o cadastro de terminais |
| Token de portador do callback | Opcional. Preencha somente se o suporte da PayArc tiver fornecido um |
| Conexão com a PayArc | Botões Conectar usando estas credenciais, Atualizar terminais e Desconectar |
| Número de série do terminal | O S/N do PAX configurado pela PayArc para sua conta. Obrigatório para pagamentos |
| Tipo de pagamento | CREDIT (padrão) ou DEBIT |
| Imprimir recibo | Impressão no terminal: 0 - No receipt (padrão), 1 - Merchant receipt, 2 - Customer receipt ou 3 - Both receipts |
| URL do webhook | Endereço de callback somente para leitura. Verifique se usa HTTPS; forneça-o à PayArc somente se ela solicitar |
| Diagnóstico da PayArc | Informaçõ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 origempayarc-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