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

# Métodos de pagamento da Ásia-Pacífico

> Aceite GCash nas Filipinas, Alipay HK e FPS em Hong Kong e Touch 'n Go na Malásia em pagamentos avulsos, cobrados na moeda local de cada mercado.

Permita que clientes nas Filipinas, em Hong Kong e na Malásia paguem com a carteira digital ou a transferência bancária que usam todos os dias. Dodo Payments oferece suporte a **GCash** (Filipinas), **Alipay HK** e **FPS** (Hong Kong) e **Touch 'n Go** (Malásia) em pagamentos avulsos. Cada método é cobrado na moeda local, e o cliente paga escaneando um código QR exibido no checkout.

> [!NOTE]
>
> Esta página aborda as Filipinas, Hong Kong e a Malásia. Para outros mercados asiáticos, consulte [India](https://docs.dodopayments.com/features/payment-methods/india.md) para UPI e Rupay, [South Korea](https://docs.dodopayments.com/features/payment-methods/south-korea.md) para Kakao Pay, Naver Pay e PAYCO, e [WeChat Pay](https://docs.dodopayments.com/features/payment-methods/wechat.md) para clientes chineses.

## Por que as e-wallets da Ásia-Pacífico são importantes

> **Wallet-First Markets**
>
> GCash é a carteira digital mais popular nas Filipinas, e Touch 'n Go é a maior carteira digital da Malásia.

> **Low Card Penetration**
>
> O uso de cartões de crédito é baixo nas Filipinas em comparação com mercados em que os cartões são predominantes. Carteiras digitais locais e transferências bancárias alcançam clientes que um checkout que aceita apenas cartões não alcança.

> **Instant Settlement**
>
> O FPS funciona 24 horas por dia em Hong Kong, e os fundos chegam ao beneficiário quase imediatamente, permitindo que o checkout confirme o pagamento enquanto o cliente aguarda.

## Métodos compatíveis

A tabela lista o mercado, a moeda de cobrança e o valor mínimo de cada método. O mínimo é o valor mínimo do checkout para essa moeda, portanto aplica-se a todos os métodos de pagamento em um checkout nessa moeda.

| Método | País | Moeda de cobrança | Assinaturas | Valor mínimo |
| :- | :- | :- | :-: | :- |
| **GCash** | Filipinas | PHP | Não | 50.00 PHP |
| **Alipay HK** | Hong Kong | HKD | Não | 4.00 HKD |
| **FPS** | Hong Kong | HKD, CNY | Não | 4.00 HKD / 4.00 CNY |
| **Touch 'n Go** | Malásia | MYR | Não | 4.00 MYR |

> [!WARNING]
>
> **Os quatro métodos são exclusivamente para pagamentos avulsos.** Nenhum deles aparece em checkouts de assinatura ou oferece suporte a qualquer outra cobrança recorrente. Inclua `credit` e `debit` nos checkouts de assinatura para que clientes desses mercados ainda possam se cadastrar.

> [!NOTE]
>
> Os clientes pagam na moeda local. Os pagamentos feitos com esses quatro métodos são liquidados na sua carteira em **USD**. Os pagamentos com cartão no mesmo checkout também são liquidados em USD.

### Detalhes dos métodos

> **GCash (Philippines)**
>
> GCash é a carteira digital mais popular nas Filipinas. No checkout, o cliente seleciona **GCash**, clica em **Pagar** e escaneia o código QR com o aplicativo GCash para aprovar o pagamento.
>
> Disponível em checkouts de **pagamento avulso** cobrados para as **Filipinas (`PH`)** em **PHP**.

> **Alipay HK (Hong Kong)**
>
> Alipay HK é a versão do Alipay para Hong Kong. Ele atende ao mercado local e liquida os pagamentos em dólares de Hong Kong. É um método separado do produto Alipay da China continental. O checkout o identifica como **AlipayHK**.
>
> Disponível em checkouts de **pagamento avulso** cobrados para **Hong Kong (`HK`)** em **HKD**. Alipay HK liquida pagamentos somente em HKD, portanto não aparece em um checkout em CNY, mesmo quando o país de cobrança é Hong Kong.

> **FPS (Hong Kong)**
>
> FPS (Faster Payment System) é o sistema de pagamentos em tempo real de Hong Kong, lançado pela Autoridade Monetária de Hong Kong. Ele conecta bancos e carteiras digitais, funciona 24 horas por dia e oferece suporte a dólares de Hong Kong e yuans chineses. O cliente escaneia o código QR com um aplicativo bancário ou de carteira digital, e os fundos chegam quase imediatamente.
>
> Disponível em checkouts de **pagamento avulso** cobrados para **Hong Kong (`HK`)** em **HKD** ou **CNY**.

> **Touch 'n Go (Malaysia)**
>
> Touch 'n Go é a maior carteira digital da Malásia. O cliente escaneia o código QR com o aplicativo Touch 'n Go e confirma o pagamento nele.
>
> Disponível em checkouts de **pagamento avulso** cobrados para a **Malásia (`MY`)** em **MYR**.

## Configuração

### Tipos de método da API

Passe estes valores em `allowed_payment_method_types`:

| Tipo | Descrição |
| :- | :- |
| `gcash` | Carteira GCash (Filipinas) |
| `ali_pay_hk` | Carteira Alipay HK (Hong Kong) |
| `fps` | Transferência bancária em tempo real FPS (Hong Kong) |
| `touch_n_go` | Carteira Touch 'n Go (Malásia) |

### Exemplo: checkout nas Filipinas

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

### Exemplo: checkout em Hong Kong

```javascript theme={null}
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  allowed_payment_method_types: ['ali_pay_hk', 'fps', 'credit', 'debit'],
  billing_currency: 'HKD',
  billing_address: {
    country: 'HK',
    zipcode: '999077'
  },
  return_url: 'https://example.com/success'
});
```

### Exemplo: checkout na Malásia

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

### Requisitos

Um método aparece no checkout somente quando todas estas condições são atendidas:

1. O **país de cobrança** corresponde ao mercado do método: `PH` para GCash, `HK` para Alipay HK e FPS, e `MY` para Touch 'n Go.
2. A **moeda de cobrança** corresponde ao método: PHP, HKD (ou CNY para FPS) ou MYR.
3. O checkout é um **pagamento avulso**, não uma assinatura.
4. **[Adaptive Currency](https://docs.dodopayments.com/features/adaptive-currency.md)** está ativado. Sem ele, `billing_currency` é ignorado, e o checkout não pode cobrar em PHP, HKD, CNY ou MYR.

> [!WARNING]
>
> Se Adaptive Currency estiver desativado, os clientes desses mercados não serão cobrados na moeda local, e nenhum desses métodos aparecerá.

## Testes

**1. Enable test mode**

Desative o botão **Live Mode** na barra lateral do dashboard e use as chaves de API criadas no modo de teste.

**2. Set the billing country and currency**

Crie um checkout de pagamento avulso com o país do endereço de cobrança e a moeda de cobrança correspondentes ao método que você está testando:

| Método | País de cobrança | Moeda de cobrança |
| :- | :- | :- |
| GCash | `PH` | `PHP` |
| Alipay HK | `HK` | `HKD` |
| FPS | `HK` | `HKD` ou `CNY` |
| Touch 'n Go | `MY` | `MYR` |

Inclua o tipo de método em `allowed_payment_method_types`. Esses métodos não são oferecidos em checkouts de assinatura.

**3. Select the method and confirm**

Selecione o método de pagamento no checkout e clique em **Pagar**. Um código QR é aberto em uma sobreposição de tela cheia com uma contagem regressiva de 10 minutos, e o checkout verifica o status do pagamento enquanto a sobreposição está aberta.

**4. Verify the checkout behavior**

Confirme que o método aparece somente para o país e a moeda correspondentes e que o código QR é renderizado.

> [!NOTE]
>
> Os códigos QR do modo de teste vêm do ambiente de teste do provedor da carteira e podem se comportar de maneira diferente de um pagamento real.

## Práticas recomendadas

> **Lead with the local wallet**
>
> Nas Filipinas e na Malásia, muitos clientes esperam pagar com uma carteira digital local. Liste GCash ou Touch 'n Go ao lado dos cartões nos checkouts desses mercados.

> **Offer both Hong Kong methods**
>
> Alipay HK e FPS atendem a clientes diferentes: usuários de carteiras digitais e usuários de transferências bancárias. Inclua ambos nos checkouts em HKD para que cada cliente veja o método de sua preferência.

> **Keep cards on subscription checkouts**
>
> Todos os métodos desta página são exclusivamente para pagamentos avulsos, portanto um checkout de assinatura que liste apenas carteiras digitais locais não terá nenhum método para exibir. Inclua `credit` e `debit` para planos recorrentes.

> **Match currency to region**
>
> Esses métodos exigem a moeda de cobrança local. Se o seu catálogo tiver preços em USD ou EUR, ative Adaptive Currency para que os clientes recebam cotações e sejam cobrados em PHP, HKD, CNY ou MYR.

## Solução de problemas

> **Method not appearing at checkout**
>
> **Verifique:**
>
> 1. O país de cobrança é `PH`, `HK` ou `MY`, correspondendo ao método?
> 2. A moeda de cobrança é PHP, HKD, CNY ou MYR, correspondendo ao método?
> 3. Este é um pagamento avulso? Nenhum desses métodos aparece em assinaturas.
> 4. O método (`gcash`, `ali_pay_hk`, `fps` ou `touch_n_go`) está incluído em `allowed_payment_method_types`?
> 5. Adaptive Currency está ativado?
> 6. O valor atende ao mínimo da moeda em [Métodos compatíveis](#supported-methods)?
>
> **Solução:** Remova `allowed_payment_method_types` temporariamente para ver todos os métodos elegíveis e, em seguida, identifique a condição que não está sendo atendida.

> **Alipay HK missing on a CNY checkout**
>
> **Causa:** Alipay HK liquida pagamentos somente em HKD. Um checkout cobrado para Hong Kong em CNY oferece FPS, mas nunca Alipay HK.
>
> **Solução:** Faça a cobrança em HKD para oferecer Alipay HK ou inclua `fps` nos checkouts em CNY para Hong Kong.

> **Wallet missing on a subscription**
>
> **Causa:** GCash, Alipay HK, FPS e Touch 'n Go são exclusivamente para pagamentos avulsos e não são oferecidos para cobranças recorrentes.
>
> **Solução:** Use `credit` e `debit` para assinaturas nesses mercados.

> **Payment not confirming**
>
> **Causa:** O cliente precisa escanear o código QR e aprovar o pagamento em um aplicativo de carteira digital ou bancário. Se o cliente fechar o aplicativo antes de aprovar, o pagamento permanecerá incompleto.
>
> **Solução:** Use webhooks para obter o status final do pagamento em vez do redirecionamento de retorno. Consulte o [guia de Webhooks](https://docs.dodopayments.com/developer-resources/webhooks.md).

## Páginas relacionadas

> **[Payment Methods Overview](https://docs.dodopayments.com/features/payment-methods.md)**
>
> Veja todos os métodos de pagamento compatíveis.

> **[Adaptive Currency](https://docs.dodopayments.com/features/adaptive-currency.md)**
>
> Cobre os clientes na moeda local deles, incluindo PHP, HKD, CNY e MYR.

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

> **[Testing Process](https://docs.dodopayments.com/miscellaneous/testing-process.md)**
>
> Dados de teste e orientações para testar o checkout.


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