Como Configurar Gateway de Pagamento da Tailândia no WooCommerce: Guia Técnico

Expandir as vendas de uma loja virtual para o Sudeste Asiático, especificamente para a Tailândia, exige muito mais do que apenas traduzir páginas ou configurar taxas de envio internacional. O comportamento de compra no comércio eletrônico tailandês depende diretamente de ecossistemas locais de pagamento. Clientes na Tailândia priorizam amplamente métodos como transferências via PromptPay (pagamento instantâneo via QR Code), Internet Banking e cartões locais, tornando soluções genéricas ocidentais ineficazes para a conversão.

Neste guia, abordamos os fundamentos e o fluxo técnico para integrar com sucesso um gateway compatível com a Tailândia no seu e-commerce WooCommerce.

Principais Opções de Gateways para o Mercado Tailandês

Para processar pagamentos locais na moeda Thai Baht (THB), os gateways mais consolidados e compatíveis com o ecossistema WooCommerce incluem:

1. Omise (Opn Payments): Um dos gateways mais populares na região, oferece suporte nativo a PromptPay, cartões de crédito/débito, TrueMoney Wallet e parcelamentos locais.
2. 2C2P: Focado em grandes operações corporativas no Sudeste Asiático, cobrindo canais alternativos e pagamentos em pontos físicos (over-the-counter).
3. GB Prime Pay: Solução tailandesa voltada a PMEs com integração direta para QR Code e cartões.
4. Stripe Tailândia: Embora disponível, exige conta registrada localmente e suporte específico para habilitar métodos além de cartões.

Passo a Passo da Implementação Técnica

1. Configuração Regional e Moeda Base

Antes de instalar qualquer extensão de pagamento, o WooCommerce deve estar alinhado às diretrizes monetárias tailandesas. No painel, navegue até WooCommerce > Configurações > Geral e defina:

• Moeda: Thai Baht (฿ / THB)
• Posição da Moeda: Esquerda ou Direita (dependendo do idioma do tema)
• Separador de Milhares: Vírgula (,)
• Separador Decimal: Ponto (.)

2. Instalação e Configuração das Chaves de API

Tomando o plugin oficial da Omise como referência padrão para WooCommerce:

• Instale o plugin através do repositório ou via Composer no seu ambiente de desenvolvimento.
• Obtenha as credenciais no painel do gateway: Public Key e Secret Key (iniciando em modo Sandbox/Test).
• Ative os métodos necessários no WooCommerce: Checkout com Cartão e PromptPay QR Code.

3. Tratamento de Pagamentos Assíncronos (Webhooks para PromptPay)

Diferente do cartão de crédito onde a resposta é praticamente síncrona, pagamentos via PromptPay exigem o escaneamento de um QR Code no aplicativo bancário do cliente. Isso transforma a transação em um evento assíncrono.

Para que o pedido transite de Pendente (pending payment) para Processando (processing), a configuração de Webhooks é mandatória:

• No painel do gateway, cadastre a URL do webhook apontada para a API REST do WooCommerce (ex: https://seusite.com/wc-api/omise_callback).
• Garanta que seu servidor não bloqueie requisições POST externas via firewall ou regras restritivas de Cloudflare/WAF.

Em implementações que realizo para e-commerces que operam no Sudeste Asiático, configuro rotinas de fallback usando o hook woocommerce_order_status_changed associado a cron jobs agendados (wp_schedule_event). Esse fluxo consulta a API do gateway a cada 15 minutos caso o webhook primário falhe por oscilação de rede, prevenindo pedidos travados.

4. Customização de Exibição via Hooks do WooCommerce

Se você opera uma loja multimoeda (multi-currency) e precisa exibir o gateway tailandês apenas quando a moeda selecionada for THB ou o país de faturamento for a Tailândia, utilize o filtro woocommerce_available_payment_gateways no seu plugin de funcionalidades ou no functions.php:

php
addfilter(‘woocommerceavailablepaymentgateways’, ‘filtrargatewaystailandia’);
function filtrargatewaystailandia($gateways) {
if (is_admin()) return $gateways;

$moeda_atual = get_woocommerce_currency();

// Desativa o gateway específico se a moeda não for Baht Tailandês
if ($moeda_atual !== 'THB' && isset($gateways['omise'])) {
    unset($gateways['omise']);
}

return $gateways;

}

Validação e Testes em Sandbox

Antes de entrar em produção, realize testes rigorosos:

1. Fluxo de Sucesso: Simule a leitura do QR Code usando a ferramenta de testes do gateway.
2. Expiração de QR Code: Verifique se o pedido é devidamente cancelado ou marcado como falho caso o cliente não conclua a transferência dentro da janela de tempo definida.
3. Reembolsos (Refunds): Teste a emissão de reembolsos diretamente pelo painel administrativo do WooCommerce via API.

Conclusão

Integrar um gateway tailandês no WooCommerce remove a principal barreira de entrada para clientes da região, elevando as taxas de conversão por meio de métodos familiares como PromptPay. A correta configuração de webhooks e tratamento de status assíncrono é o que garante uma operação estável e sem intervenções manuais.

Se a sua empresa precisa de suporte técnico para planejar, integrar ou customizar gateways de pagamento internacionais em lojas WooCommerce existentes, entre em contato para avaliarmos seu projeto por meio de uma consultoria técnica especializada.