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:

WooCommerce com a moeda padrão da sua loja definida em WooCommerce > Configurações > Geral e pelo menos um produto publicado.
Núcleo do WPML e o complemento de compatibilidade WPML Multilingual & Multicurrency for WooCommerce. Faça o download do 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 multilíngue para usá-lo. Se você só precisa de várias moedas em uma loja de um único idioma, o plugin gratuito WooCommerce Multilingual do WordPress.org também gerencia 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 (Ativar o modo multimoeda). Depois, 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 a 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 multimoeda, escolha entre preços manuais por moeda ou conversão automática da 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 redondos que os clientes esperam

Defina o preço de cada produto em cada moeda de forma explícita. Um produto de $ 20 se torna € 19,99 em euros e ¥ 3.000 em ienes. Números redondos que os clientes reconhecem, e não o resultado da divisão por uma taxa de câmbio em tempo real. Você define preços manuais na tela de edição de cada produto, no painel 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, preços premium em outros. Você não deixa a taxa de câmbio de ontem ditar tudo.

Conversão automática a partir do preço original

Defina o preço original 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 Taxas de câmbio automáticas em WPML > Configurações > Multimoeda. Defina as taxas manualmente ou busque-as em tempo real de uma fonte configurada em um cronograma de sua escolha.

A conversão automática é a escolha certa para lojas com catálogos que mudam rapidamente ou com 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 template onde você queira que o seletor apareça.

Configure a aparência do seletor na seção Opções do seletor de moedas em WPML > Configurações > Multimoeda. Você pode escolher menu suspenso, 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 naquela 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 template de seletor, há uma referência separada de arquivos de template para desenvolvedores.

Mostre diferentes gateways de pagamento por país e moeda

Para rotear os gateways de pagamento por moeda, abra WPML > Configurações > Multimoeda e clique em Editar em cada moeda na tabela Moedas. Cada moeda lista os gateways de pagamento disponíveis com caixas de seleção. Ative os gateways que funcionam para aquela 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.

Esta é a maneira correta 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 gateway local processa outra moeda. Os clientes que pagam em cada moeda veem o gateway vinculado àquela moeda, e não todos eles de uma vez.

Troque a moeda automaticamente com base na localização do visitante

Para trocar a moeda automaticamente pela localização do visitante, abra WPML > Configurações > Multimoeda e na seção Moedas escolha Localização do cliente (em vez de Idioma do site) em Exibir moedas com base em. Esta opção requer 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 trocar 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 está 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 para confirmar antes de ir ao ar.

WooCommerce Subscriptions. Produtos de assinatura recorrente respeitam a precificação multimoeda. Defina o preço da assinatura em cada moeda da mesma forma que você define os preços dos produtos. Os pagamentos de renovação são processados na moeda em que o cliente fez a assinatura.
WooCommerce Bookings. Preços de produtos reserváveis, valores de depósito e custos por recurso suportam precificação por moeda. A confirmação da reserva exibe a moeda do cliente do início ao fim.
Product Bundles, Composite Products, Mix and Match. Produtos de pacote e 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 exemplo 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. 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 troca de moeda ou idioma no meio da sessão, o carrinho dele ainda contém 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 Carrinho.

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

Trocar de idioma quando há itens no carrinho. Escolha Sincronizar o conteúdo do carrinho ao trocar de idioma para manter o carrinho e reprecificar seus itens, ou escolha Pedir uma confirmação e redefinir o carrinho para perguntar ao cliente antes de redefinir.
Trocar de moeda quando há itens no carrinho. As mesmas duas opções para mudanças de moeda.

A sincronização do carrinho requer 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ê ativa o cookie.

Erros comuns

Multimoeda ativado, mas nenhuma moeda aparece. Adicione pelo menos uma moeda além da padrão em WPML > Configurações > Multimoeda > Moedas. 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 existem 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 Moedas). Cada moeda lista os gateways disponíveis e eles precisam ser ativados explicitamente por moeda.
A localização do cliente retorna a moeda errada. Esta opção usa uma chave de licença da MaxMind para detecção baseada em IP. Bancos de dados GeoIP ocasionalmente classificam incorretamente. Seu provedor de hospedagem também pode armazenar em cache IPs de uma borda de CDN. Teste com uma nova sessão do navegador e confirme se o seu host está repassando o IP real do visitante.
Os preços parecem corretos, mas o imposto está errado. As configurações de imposto por localização do WooCommerce se aplicam sobre o preço baseado na moeda. Configure as classes de impostos em WooCommerce > Configurações > Impostos separadamente.