Pular para o conteúdo principal
WeChat Pay é uma das duas plataformas dominantes de pagamento móvel na China, utilizada por mais de um bilhão de pessoas. Permite pagamentos via códigos QR dentro do aplicativo WeChat, tornando-se essencial para empresas que têm como alvo consumidores chineses.

​
Por que Oferecer WeChat Pay?

1B+ Users

WeChat Pay é utilizado por mais de um bilhão de pessoas, tornando-se uma das maiores plataformas de pagamento do mundo.

Mobile-First

Os pagamentos são concluídos inteiramente no aplicativo WeChat — rápido, familiar e sem fricção para os clientes chineses.

Dual Currency

Aceite pagamentos em USD e CNY, proporcionando flexibilidade para transações internacionais e domésticas.

​
Visão Geral

DetalheValor
Moeda de FaturamentoUSD, CNY
AssinaturasNão
Valor Mínimo$0.50 / ¥1.00
LiquidaçãoUSD

​
Como Funciona

​
Experiência do Cliente

  1. O cliente seleciona WeChat Pay no checkout
  2. Um código QR é exibido na página de checkout
  3. O cliente abre o WeChat no celular e escaneia o código QR
  4. O cliente confirma o pagamento no aplicativo WeChat
  5. O pagamento é confirmado instantaneamente e o cliente é redirecionado para a página de sucesso
Clientes pagam em USD ou CNY, e você recebe a liquidação em USD.

​
Configuração

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'prod_123', quantity: 1 }],
  allowed_payment_method_types: ['wechat_pay', 'credit', 'debit'],
  return_url: 'https://example.com/success'
});

​
Tipo de Método de API

TipoMétodoMoedas
wechat_payWeChat PayUSD, CNY

​
Testes

1

Enable test mode

Use suas chaves de API de teste Dodo Payments.
2

Create a test checkout

Crie uma sessão de checkout com wechat_pay nos métodos de pagamento permitidos.
3

Scan the QR code

Um código QR de teste será gerado — escaneie-o com a câmera normal do telefone (não é necessário o aplicativo WeChat). Você será redirecionado para uma página de teste onde poderá simular a transação como sucesso ou falha.

​
Melhores Práticas

WeChat Pay é usado principalmente por consumidores chineses. Inclua-o quando sua base de clientes incluir compradores chineses ou quando você estiver direcionando ao mercado chinês.
Nem todos os clientes têm WeChat. Sempre inclua credit e debit como métodos de pagamento alternativos.
Muitos usuários do WeChat Pay navegam no celular. Certifique-se de que sua página de checkout seja responsiva — a leitura de QR code funciona melhor quando o checkout é exibido em um desktop ou tablet enquanto o cliente escaneia com o celular.
WeChat Pay suporta tanto USD quanto CNY. Escolha a moeda de faturamento que melhor se adapte ao seu mercado-alvo — USD para transações internacionais, CNY para transações domésticas chinesas.

​
Solução de Problemas

Verifique:
  1. wechat_pay incluído em allowed_payment_method_types?
  2. Moeda de faturamento definida para USD ou CNY?
  3. Valor da transação atende ao mínimo?
Solução: Verifique se o tipo de método de pagamento e a moeda estão corretos em sua solicitação de API.
Causa: O código QR pode ter expirado, ou a versão do WeChat do cliente está desatualizada.Solução: Atualize a página de checkout para gerar um novo código QR. Certifique-se de que o cliente está utilizando uma versão atual do WeChat.
Causa: O WeChat Pay geralmente confirma instantaneamente, mas atrasos na rede podem ocorrer.Solução: Monitore os webhooks para confirmação do pagamento. Se o pagamento não for confirmado em poucos minutos, o cliente pode precisar tentar novamente.

​
Páginas Relacionadas

Payment Methods Overview

Veja todos os métodos de pagamento suportados.

Checkout Guide

Guia de implementação completa do checkout.

Webhooks

Trate as confirmações de pagamento de forma assíncrona.

Testing Process

Guia de teste completa para todos os métodos de pagamento.
Last modified on April 8, 2026