Gateway Mollie Terminal

O gateway Mollie Terminal permite aceitar pagamentos presenciais em equipamentos Mollie Terminal diretamente no WCPOS. Um pagamento é iniciado no WooCommerce e concluído no terminal, e a confirmação da Mollie é registrada no pedido.

Recursos

Integração de hardware

Envie pagamentos para terminais Mollie registrados na conta Mollie e receba pagamentos presenciais com cartão

Sem emparelhamento manual

Os terminais são obtidos em tempo real da conta Mollie — selecione um em uma lista suspensa, sem precisar colar o ID do dispositivo

Conclusão confiável

Os pagamentos são confirmados por consulta à Mollie, e o POS redireciona automaticamente para o recibo assim que o terminal confirma

Transações seguras

Processamento presencial de cartões em conformidade com PCI, realizado no hardware da Mollie

Suporte a reembolsos

Reembolse pela tela do pedido do WooCommerce, com reconciliação com a Mollie para que os reembolsos nunca sejam duplicados

Como funciona

O Mollie Terminal usa os pagamentos pointofsale no lado do servidor da Mollie. Ao iniciar um pagamento, o WooCommerce cria um pagamento Mollie para o pedido, e a Mollie o envia ao terminal selecionado. O cliente paga no dispositivo, e a Mollie é a fonte de verdade para o status do pagamento e do reembolso — os metadados locais do pedido do WooCommerce são apenas um cache.

Como um pagamento é confirmado. Enquanto o pagamento está em andamento, o POS consulta a Mollie (a cada 2 segundos por padrão) e, quando o terminal confirma, redireciona diretamente para a página de agradecimento. Os webhooks da Mollie também são usados para acelerar esse processo — e a URL do webhook é definida automaticamente em cada pagamento, portanto não há nada a configurar no painel da Mollie.

O terminal deve estar registrado e ativo na mesma conta da Mollie que o plugin.

Configuração

1

Instale o Mollie Terminal for WooCommerce

Instale em WP Admin > POS > Configurações > Extensões ou baixe o arquivo ZIP mais recente do plugin (não o ZIP ou tarball do código-fonte do GitHub) na página de releases do GitHub e envie-o por Plugins > Adicionar novo > Enviar plugin.

2

Configure suas credenciais da Mollie

1. Acesse WP Admin > WooCommerce > Configurações > Pagamentos e abra Mollie Terminal
2. Defina Modo como Live — pagamentos por terminal exigem uma conta ativa (consulte Escopo e limitações)
3. Defina Origem da chave de API para reutilizar a chave do plugin oficial Mollie Payments for WooCommerce ou usar a chave informada nesta tela
4. Se informar a chave aqui, cole sua chave de API ativa da Mollie em Chave de API da Mollie
5. Salvar

Use o modo Live

Os terminais Mollie existem apenas em contas ativas, portanto a chave de API de teste não pode operar um terminal. A tela de configurações avisa quando o modo Test está selecionado — mude para Live com sua chave de API ativa para receber pagamentos. Consulte Escopo e limitações.

Não é necessário ID de perfil

Os pagamentos pointofsale não exigem um ID de perfil da Mollie, e os terminais são listados em toda a conta, portanto não há mais nada a colar.

3

Escolha seus terminais

1. Selecione um Terminal padrão no menu suspenso. A lista é obtida do ambiente Mollie selecionado — os terminais inativos ficam ocultos, pois a Mollie não pode reativá-los.
2. (Opcional) Restrinja os Terminais ativados aos dispositivos realmente em uso. O terminal padrão salvo continua disponível mesmo que não esteja selecionado aqui; deixe a configuração vazia para permitir todos os terminais ativos. Para desativar um terminal, também altere ou limpe o Terminal padrão.
3. (Opcional) Ative Bloquear seleção de terminal para que os operadores de caixa não possam alterar o terminal na finalização de compra — o terminal padrão será sempre usado, e isso também é aplicado no servidor.
4. Salvar

4

Ativar no WCPOS

1. Acesse WP Admin > POS > Configurações > Finalização de compra
2. Localize o método de pagamento Mollie Terminal e ative-o para o POS
3. Salve as configurações

nota

A caixa de seleção Ativar/Desativar na tela de configurações do WooCommerce controla apenas a finalização de compra da loja virtual. O WCPOS usa esse método de pagamento depois de configurado, independentemente de essa caixa estar marcada.

Referência de configurações

Configuração	O que faz
Ativar/desativar	Ativa o gateway para o checkout da loja online (não é necessário para o POS)
Título / Descrição	Rótulo e texto exibidos ao cliente no checkout
Modo	Test ou Live. Os pagamentos por terminal exigem Live — a chave de API de teste não pode operar um terminal
Origem da chave de API	Usa a chave inserida abaixo ou reutiliza a chave de teste/produção correspondente do plugin oficial Mollie Payments for WooCommerce. Se a chave compartilhada não estiver disponível, o plugin usará a chave abaixo como alternativa
Chave de API da Mollie	A chave de API de teste ou produção para o modo selecionado. Usada quando Origem da chave de API está definida como a chave inserida aqui e como alternativa para uma chave compartilhada ausente
Terminal padrão	O terminal usado por padrão no checkout, escolhido em uma lista suspensa de terminais ativos no ambiente Mollie selecionado
Terminais ativados	Restringe a lista do checkout aos terminais selecionados. Vazio = todos os terminais ativos. O padrão salvo está sempre disponível; portanto, altere-o ou limpe-o também ao retirar um terminal de uso
Bloquear seleção de terminal	Força o terminal padrão no checkout para que os operadores de caixa não possam alterá-lo (requer um terminal padrão)
Logs de depuração do checkout	Mostra as ferramentas Mostrar logs, Copiar e Limpar no painel de pagamento do checkout. Mantenha esta opção desativada, exceto ao coletar logs para o suporte; a atividade de pagamento é sempre registrada em WooCommerce > Status > Logs

A URL do webhook é aplicada automaticamente a cada pagamento, portanto, não há campo de webhook a preencher nem configuração necessária no painel da Mollie.

Uso

Processamento de pagamentos

1. Adicionar itens: Adicione produtos ao carrinho no POS
2. Selecionar forma de pagamento: Escolha "Mollie Terminal" como forma de pagamento
3. Escolher terminal: Selecione um terminal na lista suspensa (o padrão é o terminal configurado; fica oculto se a seleção de terminal estiver bloqueada)
4. Iniciar pagamento: Clique em Iniciar pagamento no terminal — a Mollie envia a solicitação de pagamento ao dispositivo
5. Pagamento do cliente: O cliente aproxima, insere ou passa o cartão no terminal. O status é atualizado em tempo real — Sending to terminal… → Waiting for terminal…
6. Conclusão automática: Quando o terminal confirma, o pedido é marcado como pago e o POS redireciona automaticamente para o recibo

Controles de pagamento

• Iniciar pagamento no terminal: Envie uma nova solicitação de pagamento ao terminal selecionado
• Cancelar pagamento: Cancele um pagamento que ainda está em aberto. Quando o pagamento chega ao terminal, a Mollie informa que ele não pode mais ser cancelado, e o caixa faz o cancelamento no próprio dispositivo

Gerenciamento de pedidos

• Conclusão verificada: Cada webhook, consulta, cancelamento e nova tentativa busca o estado autoritativo da Mollie antes de alterar um pedido, portanto os pedidos são marcados como pagos somente com base em um estado confirmado pela Mollie
• Acompanhamento de pagamentos: As tentativas de pagamento são registradas como histórico somente de acréscimo no pedido
• Geração de recibos: Recibos padrão do POS são gerados após pagamentos bem-sucedidos

Reembolsos

Há suporte para reembolsos. Reembolse um pedido na tela normal de pedidos do WooCommerce, e o reembolso será enviado à Mollie. Como a Mollie é a fonte de referência, as novas tentativas de reembolso são conciliadas com os IDs e os metadados de reembolso da Mollie antes de criar outro reembolso, para que um reembolso nunca seja emitido acidentalmente duas vezes.

Limpeza de pagamentos pendentes antigos

Um pagamento pointofsale da Mollie pode permanecer "aberto" do lado da Mollie se a finalização da compra for abandonada. O plugin cancela automaticamente esses pagamentos em aberto quando:

• a consulta automática atinge o tempo limite (5 minutos por padrão) — o cancelamento é enviado em vez de deixar o pagamento pendente
• o pedido é concluído com um método de pagamento diferente (por exemplo, o cliente paga em dinheiro), ou o pedido é cancelado no WooCommerce
• a página de finalização da compra é fechada durante o pagamento — uma tentativa de cancelamento é acionada quando a aba é fechada
• uma varredura do WP-Cron é executada a cada 10 minutos e cancela ou regulariza pagamentos que permanecerem abertos após o limite de expiração (10 minutos por padrão), inclusive quando o navegador fecha ou a conexão cai antes de as outras rotinas de limpeza serem executadas

Se o pagamento já chegou ao terminal, a Mollie o informa como não cancelável, e o operador o cancela no próprio dispositivo — essas limpezas não têm efeito nesse caso e são seguras.

Requisitos

Conta Mollie: Conta Mollie ativa com uma chave de API ativa

Hardware compatível: Um dispositivo Mollie Terminal ativo nessa conta Mollie

Moeda: EUR — os pagamentos no terminal POS estão limitados a EUR por enquanto

WCPOS: A versão Pro é necessária para o checkout do POS

Conexão estável: Conexão de internet confiável para comunicação com a API

Escopo e limitações

Limitação do modo de teste

Os terminais Mollie existem apenas em contas ativas. A chave de API de teste da Mollie não pode operar um terminal físico (ou iOS/Android), portanto não é possível testar pagamentos por terminal de ponta a ponta no modo de teste. Essa é uma limitação da plataforma Mollie, não uma restrição do plugin — a tela de configurações exibe um aviso quando o modo Test está selecionado. Use o modo Live com sua chave de API ativa para receber pagamentos pelo terminal.

Moeda

Os pagamentos pelo terminal POS estão limitados a EUR até que seja confirmado um suporte mais amplo a moedas no Mollie Terminal.

Solução de problemas

Problemas comuns

Nenhum terminal aparece na lista suspensa

• Confirme se Modo está definido como Live e se a chave de API efetiva é uma chave ativa — não há terminais em contas de teste
• Verifique se o terminal está registrado e ativo na sua conta Mollie; terminais inativos ficam ocultos porque a Mollie não pode reativá-los
• Verifique se o site consegue acessar a Mollie — a lista é obtida em tempo real pela API

O pagamento não inicia

• Confirme que um terminal está selecionado (ou que um Terminal padrão está definido quando a seleção está bloqueada)
• Verifique se o terminal está ligado, online e ativo na mesma conta da Mollie
• Verifique se a moeda do pedido é EUR

O terminal atingiu o tempo limite ou o pagamento permaneceu aberto

• O plugin tenta cancelar pagamentos abertos automaticamente quando o tempo limite é atingido (5 minutos por padrão)
• Se o pagamento já tiver chegado ao terminal e não puder ser cancelado automaticamente, cancele-o no próprio dispositivo
• Depois, é possível iniciar um novo pagamento ou aceitar o pagamento de outra forma

Pedido concluído no terminal, mas demora para atualizar

• O POS consulta a Mollie a cada 2 segundos e redireciona quando o pagamento é confirmado; um webhook geralmente o confirma antes
• Como a Mollie é a fonte confiável, o pedido é conciliado com o estado oficial da Mollie — ele não é perdido
• Verifique se há mensagens da API da Mollie em WooCommerce > Status > Logs

Como obter ajuda

Para suporte técnico:

• Acesse o repositório do GitHub para relatar problemas
• Consulte o guia de configuração do Mollie Terminal e a API Create Payment da Mollie para dúvidas relacionadas à API
• Entre em contato com o suporte da Mollie para problemas de conta e hardware

Capturas de tela

Capturas de tela serão adicionadas em uma atualização futura para mostrar:

• A tela de configurações do Mollie Terminal — chave de API, terminal padrão e terminais ativados
• Ativação do gateway nas configurações do WCPOS
• Fluxo de processamento de pagamentos no checkout do POS