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

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.

Esta página aborda as Filipinas, Hong Kong e a Malásia. Para outros mercados asiáticos, consulte India para UPI e Rupay, South Korea para Kakao Pay, Naver Pay e PAYCO, e WeChat Pay para clientes chineses.

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

Wallet-First Markets

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.

Low Card Penetration

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.

Instant Settlement

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.

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

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.

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.

Detalhes dos métodos

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.

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.

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.

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.

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

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

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

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:

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

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.

Testes

Enable test mode

Use suas chaves de API de teste do Dodo Payments.

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.

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.

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.

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.

Práticas recomendadas

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.

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.

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.

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.

Solução de problemas

Method not appearing at checkout

Verifique:

O país de cobrança está definido como PH, HK ou MY, de acordo com o método?
A moeda de cobrança está definida como PHP, HKD, CNY ou MYR, de acordo com o método?
Este é um pagamento avulso? Nenhum desses métodos aparece em assinaturas.
O método (gcash, ali_pay_hk, fps ou touch_n_go) foi incluído em allowed_payment_method_types?
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.

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.

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.

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.

Páginas relacionadas

Payment Methods Overview

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

Adaptive Currency

Cobre os clientes em sua moeda local, incluindo PHP, HKD, CNY e MYR.

Checkout Guide

Guia completo de implementação do checkout.

Testing Process

Dados de teste e orientações para testar o checkout.

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

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

Wallet-First Markets

Low Card Penetration

Instant Settlement

Métodos compatíveis

Detalhes dos métodos

Configuração

Tipos de métodos da API

Exemplo: checkout nas Filipinas

Exemplo: checkout em Hong Kong

Exemplo: checkout na Malásia

Requisitos

Testes

Práticas recomendadas

Solução de problemas

Páginas relacionadas

Payment Methods Overview

Adaptive Currency

Checkout Guide

Testing Process

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

Wallet-First Markets

Low Card Penetration

Instant Settlement

​Métodos compatíveis

​Detalhes dos métodos

​Configuração

​Tipos de métodos da API

​Exemplo: checkout nas Filipinas

​Exemplo: checkout em Hong Kong

​Exemplo: checkout na Malásia

​Requisitos

​Testes

​Práticas recomendadas

​Solução de problemas

​Páginas relacionadas

Payment Methods Overview

Adaptive Currency

Checkout Guide

Testing Process

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

Métodos compatíveis

Detalhes dos métodos

Configuração

Tipos de métodos da API

Exemplo: checkout nas Filipinas

Exemplo: checkout em Hong Kong

Exemplo: checkout na Malásia

Requisitos

Testes

Práticas recomendadas

Solução de problemas

Páginas relacionadas