> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.

# WeChat Pay

> Aceite WeChat Pay de clientes chineses em pagamentos únicos. Saiba mais sobre cobrança em USD e CNY, o fluxo de pagamento por código QR, testes e configuração.

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

| Detalhe | Valor |
| :- | :- |
| **Moeda de cobrança** | USD, CNY |
| **Assinaturas** | Não |
| **Valor mínimo** | \$0.50 / 4.00 CNY |
| **Liquidação** | USD |

## Como Funciona

```mermaid theme={null}
sequenceDiagram
    participant Customer
    participant Checkout
    participant Dodo
    participant WeChat

    Customer->>Checkout: Select WeChat Pay
    Checkout->>Dodo: Create payment
    Dodo->>WeChat: Initiate payment
    WeChat->>Customer: Display QR code
    Customer->>WeChat: Scan QR in WeChat app
    WeChat->>Dodo: Payment confirmed
    Dodo->>Checkout: Payment complete
```

## 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.

> [!NOTE]
>
> Clientes pagam em USD ou CNY, e você recebe a liquidação em USD.

## Configuração

```javascript theme={null}
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  allowed_payment_method_types: ['we_chat_pay', 'credit', 'debit'],
  return_url: 'https://example.com/success'
});
```

WeChat Pay aparece em checkouts de pagamento único cobrados em USD ou CNY. Para fazer a cobrança em CNY, habilite [Adaptive Currency](https://docs.dodopayments.com/features/adaptive-currency.md) e passe `billing_currency: 'CNY'`.

## Tipo de método da API

| Tipo | Método | Moedas |
| :- | :- | :- |
| `we_chat_pay` | WeChat Pay | USD, CNY |

## 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

> **Target Chinese customers**
>
> 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.

> **Always include card fallbacks**
>
> Nem todos os clientes têm WeChat. Inclua `credit` e `debit` como métodos de pagamento alternativos.

> **Optimize for mobile**
>
> 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.

> **Consider both currencies**
>
> 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

> **WeChat Pay not appearing at checkout**
>
> **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.

> **QR code not scanning**
>
> **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.

> **Payment not confirming**
>
> **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](https://docs.dodopayments.com/features/payment-methods.md)**
>
> Veja todos os métodos de pagamento compatíveis.

> **[Checkout Guide](https://docs.dodopayments.com/developer-resources/checkout-session.md)**
>
> Guia completo de implementação do checkout.

> **[Webhooks](https://docs.dodopayments.com/developer-resources/webhooks.md)**
>
> Gerencie confirmações de pagamento de forma assíncrona.

> **[Asia-Pacific](https://docs.dodopayments.com/features/payment-methods/asia-pacific.md)**
>
> GCash (Filipinas), Alipay HK e FPS (Hong Kong), e Touch 'n Go (Malásia).

> **[Testing Process](https://docs.dodopayments.com/miscellaneous/testing-process.md)**
>
> Guia completo de testes para todos os métodos de pagamento.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.