Como adicionar várias moedas e gateways de pagamento a uma loja WooCommerce

Para traduzir o conteúdo da sua loja, consulte Como traduzir o WooCommerce no WordPress.

Antes de começar

Instale e ative:

• O WooCommerce com a moeda padrão da sua loja definida em WooCommerce → Configurações → Geral, e pelo menos um produto publicado.
• O núcleo do WPML e o complemento de compatibilidade WPML Multilingual & Multicurrency for WooCommerce. Baixe o complemento na página de downloads da sua conta do WPML.

O recurso multimoeda funciona sem idiomas secundários. Sua loja não precisa ser um site multilíngue para usá-lo. Se você só precisa do recurso multimoeda em uma loja de um único idioma, o plugin gratuito WooCommerce Multilingual do WordPress.org também lida com isso sozinho.

Ative o recurso multimoeda para a sua loja

Para ativar o recurso multimoeda no WooCommerce, abra WPML → Configurações → Multimoeda e ative a opção Enable the multicurrency mode. Em seguida, adicione cada moeda na qual você quer vender. Para cada moeda, defina a posição do símbolo, o separador decimal, o separador de milhares e o número de casas decimais. A formatação do preço corresponde ao que os compradores daquele mercado esperam.

Sua moeda padrão continua sendo aquela configurada nas próprias configurações do WooCommerce em WooCommerce → Configurações → Geral. As moedas adicionais que você adiciona nas configurações de Multimoeda são aquelas para as quais os clientes podem alternar.

Defina preços por moeda ou use a conversão automática

Para definir preços em cada moeda em uma loja WooCommerce com multimoeda, escolha entre preços manuais por moeda ou conversão automática de taxa de câmbio. As duas opções funcionam por moeda. Misture preços manuais para algumas moedas e conversão automática para outras, ou use uma única abordagem para tudo.

Preços manuais por moeda – números limpos que os clientes esperam

Defina o preço de cada produto em cada moeda explicitamente. Um produto de $ 20 se torna € 19,99 em euros e ¥ 3.000 em ienes. Números limpos que os clientes reconhecem, não o resultado da divisão por uma taxa de câmbio em tempo real. Você define os preços manuais na tela de edição de cada produto, no painel de multimoeda que aparece ao lado dos campos de preço padrão do WooCommerce.

A precificação manual é a escolha certa para a maioria das lojas que vendem para mercados estabelecidos. Ela permite que você precifique cada mercado intencionalmente. Ofereça descontos em alguns mercados e preços premium em outros. Você não deixa que a taxa de câmbio de ontem dite tudo.

Conversão automática a partir do preço de origem

Defina o preço de origem uma vez. O plugin de compatibilidade aplica uma taxa de câmbio e mostra o preço convertido em cada moeda. Configure a taxa na seção Automatic Exchange Rates em WPML → Configurações → Multimoeda. Defina as taxas manualmente ou busque-as em tempo real de uma fonte configurada em um cronograma que você escolher.

A conversão automática é a escolha certa para lojas com catálogos que mudam rapidamente ou muitas moedas, onde definir cada preço manualmente seria impraticável.

Exiba um seletor de moedas – widget, bloco ou shortcode

Para mostrar um seletor de moedas na sua loja WooCommerce, você tem três opções de posicionamento. Escolha a que melhor se adapta ao local onde você quer que o seletor apareça.

• Bloco. Arraste o bloco Seletor de moedas para qualquer página ou post pelo editor de blocos do WordPress.
• Widget. Arraste o widget Seletor de moedas para qualquer área de widget em Aparência → Widgets.
• Shortcode. Cole [currency_switcher] em qualquer página, post ou modelo onde você quer que o seletor apareça.

Configure a aparência do seletor na seção Currency switcher options em WPML → Configurações → Multimoeda. Você pode escolher lista suspensa, lado a lado ou lista. Você também pode escolher apenas símbolo, apenas código ou ambos. As configurações se aplicam a todos os posicionamentos.

Referência do shortcode do seletor de moedas

O shortcode [currency_switcher] aceita estes atributos:

• format. Controla como cada moeda é renderizada. Tokens: %name (nome completo da moeda, ex.: Euro), %symbol (ex.: €), %code (ex.: EUR), %subtotal (subtotal do carrinho nessa moeda). Exemplo: [currency_switcher format="%name (%symbol)"] renderiza Euro (€).
• switcher_style. O estilo visual. Valores: wcml-dropdown, wcml-dropdown-click, wcml-horizontal-list, wcml-vertical-list.

Exemplo com ambos os atributos:

[currency_switcher format="%code %symbol" switcher_style="wcml-dropdown"]

Para uma personalização mais profunda, como criar seu próprio modelo de seletor, há uma referência separada de arquivos de modelo para desenvolvedores.

Mostre diferentes gateways de pagamento por país e moeda

Para rotear gateways de pagamento por moeda, abra WPML → Configurações → Multimoeda e clique em Editar em cada moeda na tabela Currencies. Cada moeda lista os gateways de pagamento disponíveis com caixas de seleção. Ative os gateways que funcionam para essa moeda. Desative os que não funcionam. Os clientes veem apenas as opções de pagamento que se aplicam à moeda na qual estão pagando.

Essa é a maneira certa de lidar com lojas que vendem em várias regiões. Sua conta padrão do Stripe pode processar dólares, enquanto uma conta regional do Stripe ou um gateway local processa outra moeda. Os clientes que pagam em cada moeda veem o gateway vinculado a essa moeda, e não todos eles de uma vez.

Troca automática de moeda com base na localização do visitante

Para trocar a moeda automaticamente com base na localização do visitante, abra WPML → Configurações → Multimoeda e, na seção Currencies, escolha Client Location (em vez de Site language) em Show currencies based on. Essa opção exige uma chave de licença da MaxMind para a detecção de país baseada em IP. O plugin então detecta o país do visitante e mostra a moeda desse país por padrão. Você mapeia cada país para uma moeda no mesmo painel de configurações.

Os clientes ainda podem alternar manualmente se você tiver adicionado um seletor de moedas à página. Os dois funcionam juntos. A detecção de localização define o padrão. O seletor fica disponível para substituições.

WooCommerce Subscriptions, Bookings e outros tipos de produtos de extensão

O recurso multimoeda funciona em conjunto com os principais tipos de produtos de extensão do WooCommerce. Cada um tem seu próprio comportamento que deve ser confirmado antes de entrar em produção.

• WooCommerce Subscriptions. Produtos de assinatura recorrente respeitam a precificação multimoeda. O WPML Multilingual & Multicurrency for WooCommerce converte os preços dos planos de assinatura para cada moeda automaticamente. Para definir os preços manualmente, use o pop-up Manually set plan prices, conforme explicado em Como usar o WooCommerce Subscriptions com o WPML. Os pagamentos de renovação são processados na moeda em que o cliente fez a assinatura.
• WooCommerce Bookings. Os preços de produtos reserváveis, os valores de depósito e os custos por recurso suportam precificação por moeda. A confirmação da reserva exibe a moeda do cliente em todas as etapas.
• Product Bundles, Composite Products, Mix and Match. Os produtos de pacote e os componentes respeitam a configuração de moeda e preço do produto pai.

Para qualquer tipo de produto de extensão, teste uma compra de amostra de ponta a ponta em cada moeda antes do lançamento. As configurações de multimoeda funcionam de forma consistente em todas as extensões. As regras de precificação específicas da extensão (depósitos, planos de pagamento, descontos em pacotes) podem interagir de maneiras que você vai querer verificar.

Lide com o carrinho quando a moeda ou o idioma mudar

Quando um cliente muda de moeda ou idioma no meio da sessão, o carrinho dele ainda contém os itens precificados na moeda anterior. O WPML 5 permite que você escolha como o carrinho se comporta para cada caso separadamente. Abra WPML → Configurações → WCML e role até a seção Cart.

Você verá dois pares de botões de opção:

• Switching languages when there are items in the cart. Escolha Synchronize cart content when switching languages para manter o carrinho e reprecificar seus itens, ou escolha Prompt for a confirmation and reset the cart para perguntar ao cliente antes de redefinir.
• Switching currencies when there are items in the cart. As mesmas duas opções para mudanças de moeda.

A sincronização do carrinho exige o cookie de idioma do WPML. Se ele estiver desativado, a seção mostrará um aviso integrado com um link para WPML → Configurações → Idiomas → Redirecionamento de idioma do navegador, onde você pode ativar o cookie.

Armadilhas comuns

• Recurso multimoeda ativado, mas nenhuma moeda aparece. Adicione pelo menos uma moeda além da padrão em WPML → Configurações → Multimoeda → Currencies. Apenas as moedas configuradas aparecem no seletor.
• O shortcode do seletor de moedas não renderiza nada. Confirme se o recurso multimoeda está ativado e se pelo menos uma moeda foi adicionada. O shortcode renderiza um seletor vazio quando não há moedas alternativas.
• O gateway errado aparece para uma moeda. Verifique novamente as configurações de gateway por moeda (clique em Editar em cada moeda na tabela Currencies). Cada moeda lista os gateways disponíveis e eles precisam ser ativados explicitamente por moeda.
• O recurso Client Location retorna a moeda errada. Essa opção usa uma chave de licença da MaxMind para detecção baseada em IP. Ocasionalmente, os bancos de dados GeoIP classificam incorretamente. Seu provedor de hospedagem também pode armazenar IPs em cache a partir de uma borda de CDN. Teste com uma sessão de navegador limpa e confirme se o seu host está repassando o IP real do visitante.
• Os preços parecem certos, mas os impostos estão errados. As configurações de impostos por localização do WooCommerce são aplicadas sobre o preço baseado na moeda. Configure as classes de impostos em WooCommerce → Configurações → Impostos separadamente.