Skip to main content
Permita que clientes chineses paguem escaneando um código QR com o app WeChat. WeChat Pay é a carteira de pagamentos dentro do WeChat, o principal app móvel da China, e Dodo Payments oferece esse método em pagamentos únicos cobrados em USD ou CNY.

Por que Oferecer WeChat Pay?

800M+ Users

O WeChat tem mais de 1 bilhão de usuários ativos mensais, e o WeChat Pay tem mais de 800 milhões de usuários.

Mobile-First

O cliente aprova o pagamento dentro do app WeChat, em um fluxo que os clientes chineses já conhecem.

Dual Currency

Faça a cobrança em USD ou CNY, dependendo dos clientes para os quais você vende.

Visão Geral

Como Funciona

Experiência do Cliente

  1. O cliente seleciona WeChat no checkout e clica em Pay.
  2. Um código QR é aberto em uma sobreposição de tela inteira na página de checkout.
  3. O cliente abre o WeChat no celular e escaneia o código QR. Se o cliente já estiver pagando pelo celular, o checkout mostra instruções para fazer uma captura de tela do código QR e escaneá-lo pelo álbum de fotos do WeChat.
  4. O cliente confirma o pagamento no app WeChat.
  5. O checkout detecta o pagamento concluído e redireciona o cliente para sua página de sucesso.
Clientes pagam em USD ou CNY, e você recebe a liquidação em USD.

Configuração

WeChat Pay aparece em checkouts de pagamento único cobrados em USD ou CNY. Para fazer a cobrança em CNY, habilite Adaptive Currency e passe billing_currency: 'CNY'.

Tipo de método da API

Testes

1

Enable test mode

Desative a opção Live Mode na barra lateral do dashboard e use API keys criadas no modo de teste.
2

Create a test checkout

Crie uma sessão de checkout de pagamento único com we_chat_pay em allowed_payment_method_types.
3

Scan the QR code

O checkout exibe um código QR de teste. Escaneie-o com a câmera do celular; o app WeChat não é necessário. O código QR abre uma página de teste na qual você pode autorizar ou rejeitar o pagamento.

Boas práticas

O WeChat Pay é usado principalmente por consumidores chineses. Inclua-o quando seus clientes incluírem compradores chineses ou quando você vender para o mercado chinês.
Nem todos os clientes têm WeChat. Inclua credit e debit como métodos de pagamento alternativos.
Escanear é mais fácil quando o checkout está aberto em um computador ou tablet e o cliente escaneia com o celular. No celular, o checkout orienta o cliente a fazer uma captura de tela do código QR e escaneá-lo pelo álbum de fotos do WeChat. Por isso, mantenha sua página de checkout responsiva.
WeChat Pay é compatível com USD e CNY. Escolha a moeda de cobrança mais adequada para seus clientes: USD se seus preços forem em USD ou CNY para mostrar aos clientes chineses um preço na própria moeda. A liquidação é em USD em ambos os casos.

Solução de problemas

Verifique:
  1. we_chat_pay está incluído em allowed_payment_method_types?
  2. A moeda de cobrança é USD ou CNY?
  3. O valor atende ao mínimo ($0.50 ou 4.00 CNY)?
  4. Este é um pagamento único? WeChat Pay não é oferecido em assinaturas.
Solução: verifique o tipo de método de pagamento e a moeda na sua solicitação de API.
Causa: O código QR pode ter expirado ou a versão do WeChat do cliente pode estar desatualizada. O código QR expira após um período limitado.Solução: Se o código QR tiver expirado, o cliente precisará iniciar um novo checkout no seu site, ou você poderá criar uma nova sessão de checkout para ele. Se o código ainda estiver válido, peça ao cliente para atualizar o WeChat para uma versão atual.
Causa: o WeChat Pay geralmente confirma em segundos, mas podem ocorrer atrasos de rede.Solução: use webhooks para a confirmação do pagamento. Se o pagamento não for confirmado em alguns minutos, talvez o cliente precise tentar novamente.

Páginas relacionadas

Payment Methods Overview

Veja todos os métodos de pagamento compatíveis.

Checkout Guide

Guia completo de implementação do checkout.

Webhooks

Gerencie confirmações de pagamento de forma assíncrona.

Asia-Pacific

GCash (Filipinas), Alipay HK e FPS (Hong Kong), e Touch ‘n Go (Malásia).

Testing Process

Guia completo de testes para todos os métodos de pagamento.
Última modificação em 26 de setembro de 2026