> ## 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. Saiba mais sobre requisitos de moeda, suporte a pagamentos avulsos e configuração.

Os compradores em toda a região da Ásia-Pacífico finalizam compras com e-wallets locais e transferências bancárias em tempo real com muito mais frequência do que com cartões internacionais. O Dodo Payments oferece suporte a **GCash** (Filipinas), **Alipay HK** e **FPS** (Hong Kong) e **Touch 'n Go** (Malásia), cada um cobrado em sua moeda local.

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

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

<CardGroup cols={3}>
  <Card title="Wallet-First Markets" icon="wallet">
    GCash e Touch 'n Go são a forma padrão de pagar online nas Filipinas e na Malásia, muito à frente da inserção de dados do cartão.
  </Card>

  <Card title="Low Card Penetration" icon="credit-card">
    A posse de cartões é limitada em grande parte da região. As e-wallets locais e as redes bancárias alcançam clientes que checkouts que aceitam apenas cartões não conseguem atender.
  </Card>

  <Card title="Instant Settlement" icon="bolt">
    O FPS realiza compensações entre bancos em tempo real em Hong Kong, portanto os pagamentos são confirmados durante o checkout, em vez de horas depois.
  </Card>
</CardGroup>

## Métodos compatíveis

| Método          | País        | Moeda de cobrança | Assinaturas | Valor mínimo        |
| :-------------- | :---------- | :---------------- | :---------: | :------------------ |
| **GCash**       | Philippines | PHP               |      No     | 50.00 PHP           |
| **Alipay HK**   | Hong Kong   | HKD               |      No     | 4.00 HKD            |
| **FPS**         | Hong Kong   | HKD, CNY          |      No     | 4.00 HKD / 4.00 CNY |
| **Touch 'n Go** | Malaysia    | MYR               |      No     | 4.00 MYR            |

<Warning>
  **Os quatro métodos estão disponíveis apenas para pagamentos avulsos.** Nenhum deles é compatível com assinaturas ou qualquer outra cobrança recorrente. Sempre inclua `credit` e `debit` nos checkouts de assinatura para que os clientes desses mercados ainda possam se cadastrar.
</Warning>

<Info>
  Os clientes pagam em sua moeda local e você recebe a liquidação em **USD**, assim como ocorre com todos os outros métodos que não usam USD.
</Info>

### Detalhes dos métodos

<AccordionGroup>
  <Accordion title="GCash (Philippines)">
    O GCash é a maior e-wallet das Filipinas, usada para tudo, desde o pagamento de contas até compras online. Os clientes aprovam o pagamento no aplicativo GCash e retornam à sua página de sucesso.

    Disponível em checkouts de **pagamento avulso** cobrados para as **Filipinas (`PH`)** em **PHP**.
  </Accordion>

  <Accordion title="Alipay HK (Hong Kong)">
    O Alipay HK é a versão do Alipay para Hong Kong, operada para o mercado local e liquidada em dólares de Hong Kong. É um método separado do produto Alipay da China continental.

    Disponível em checkouts de **pagamento avulso** cobrados para **Hong Kong (`HK`)** em **HKD**. O Alipay HK faz a liquidação somente em HKD, portanto não aparece em um checkout em CNY, mesmo quando o país de cobrança é Hong Kong.
  </Accordion>

  <Accordion title="FPS (Hong Kong)">
    O FPS (Faster Payment System) é a rede de transferências interbancárias em tempo real de Hong Kong, administrada pela Hong Kong Monetary Authority. Os clientes pagam diretamente de sua conta bancária, e a transferência é compensada instantaneamente.

    Disponível em checkouts de **pagamento avulso** cobrados para **Hong Kong (`HK`)** em **HKD** ou **CNY**.
  </Accordion>

  <Accordion title="Touch 'n Go (Malaysia)">
    O Touch 'n Go é a e-wallet dominante da Malásia. Os clientes confirmam o pagamento no aplicativo Touch 'n Go e retornam à sua página de sucesso.

    Disponível em checkouts de **pagamento avulso** cobrados para a **Malásia (`MY`)** em **MYR**.
  </Accordion>
</AccordionGroup>

## Configuração

### Tipos de métodos da API

| Tipo         | Descrição                                            |
| :----------- | :--------------------------------------------------- |
| `gcash`      | E-wallet GCash (Filipinas)                           |
| `ali_pay_hk` | E-wallet Alipay HK (Hong Kong)                       |
| `fps`        | Transferência bancária em tempo real FPS (Hong Kong) |
| `touch_n_go` | E-wallet 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

Para que esses métodos apareçam no checkout:

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** corresponde ao método — PHP, HKD (ou CNY para FPS) ou MYR
3. O **tipo de pagamento** é um pagamento avulso, não uma assinatura
4. Para comerciantes que definem preços em outra moeda: a **[Adaptive Currency](/features/adaptive-currency)** deve estar ativada para que os clientes sejam cobrados na moeda local

<Warning>
  Se você definir preços em outra moeda e a Adaptive Currency não estiver ativada, os clientes desses mercados não serão cobrados na moeda local e nenhum desses métodos estará disponível.
</Warning>

## Testes

<Steps>
  <Step title="Enable test mode">
    Use suas chaves de API de teste do Dodo Payments.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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, e o checkout aguarda o pagamento.
  </Step>

  <Step title="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.
  </Step>
</Steps>

<Note>
  Os códigos QR do modo de teste são emitidos pelo ambiente de teste do provedor da e-wallet e podem se comportar de forma diferente de um pagamento real.
</Note>

## Práticas recomendadas

<AccordionGroup>
  <Accordion title="Lead with the local wallet">
    Nas Filipinas e na Malásia, a e-wallet local é a principal forma de pagamento esperada pelos clientes. Disponibilizar GCash ou Touch 'n Go junto aos cartões reduz significativamente o abandono.
  </Accordion>

  <Accordion title="Offer both Hong Kong methods">
    O Alipay HK e o FPS atendem clientes diferentes — usuários de e-wallet e usuários de transferências bancárias. Inclua ambos nos checkouts em HKD para que o Dodo Payments possa apresentar a opção preferida pelo cliente.
  </Accordion>

  <Accordion title="Keep cards on subscription checkouts">
    Como todos os métodos desta página estão disponíveis apenas para pagamentos avulsos, um checkout de assinatura que liste apenas e-wallets locais não terá opções a mostrar. Sempre inclua `credit` e `debit` para planos recorrentes.
  </Accordion>

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

## Solução de problemas

<AccordionGroup>
  <Accordion title="Method not appearing at checkout">
    **Verifique:**

    1. O país de cobrança está definido como `PH`, `HK` ou `MY`, de acordo com o método?
    2. A moeda de cobrança está definida como PHP, HKD, CNY ou MYR, de acordo com o 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`) foi incluído em `allowed_payment_method_types`?
    5. Se o preço estiver em outra moeda: a Adaptive Currency está ativada?

    **Solução:** remova temporariamente `allowed_payment_method_types` para ver todos os métodos elegíveis e, em seguida, identifique qual condição está falhando.
  </Accordion>

  <Accordion title="Alipay HK missing on a CNY checkout">
    **Causa:** o Alipay HK faz a liquidação 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.
  </Accordion>

  <Accordion title="Wallet missing on a subscription">
    **Causa:** GCash, Alipay HK, FPS e Touch 'n Go estão disponíveis apenas para pagamentos avulsos e nunca são oferecidos para cobranças recorrentes.

    **Solução:** use `credit` e `debit` para assinaturas nesses mercados.
  </Accordion>

  <Accordion title="Payment not confirming">
    **Causa:** esses métodos redirecionam o cliente para um aplicativo de e-wallet ou bancário. Se o cliente abandonar o aplicativo, o pagamento permanecerá incompleto.

    **Solução:** monitore os webhooks para verificar o status final do pagamento, em vez de depender do redirecionamento de retorno. Consulte o [guia de Webhooks](/developer-resources/webhooks).
  </Accordion>
</AccordionGroup>

## Páginas relacionadas

<CardGroup cols={2}>
  <Card title="Payment Methods Overview" icon="credit-card" href="/features/payment-methods">
    Veja todos os métodos de pagamento compatíveis.
  </Card>

  <Card title="Adaptive Currency" icon="globe" href="/features/adaptive-currency">
    Cobre os clientes em sua moeda local, incluindo PHP, HKD, CNY e MYR.
  </Card>

  <Card title="Checkout Guide" icon="book" href="/developer-resources/checkout-session">
    Guia completo de implementação do checkout.
  </Card>

  <Card title="Testing Process" icon="flask" href="/miscellaneous/testing-process">
    Dados de teste e orientações para testar o checkout.
  </Card>
</CardGroup>