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

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.

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

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.

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

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

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

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 de cobrança corresponde ao método: PHP, HKD (ou CNY para FPS) ou MYR.
O checkout é um pagamento avulso, não uma assinatura.
Adaptive Currency está ativado. Sem ele, billing_currency é ignorado, e o checkout não pode cobrar em PHP, HKD, CNY ou MYR.

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

Testes

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.

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 com uma contagem regressiva de 10 minutos, e o checkout verifica o status do pagamento enquanto a sobreposição está aberta.

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

O país de cobrança é PH, HK ou MY, correspondendo ao método?
A moeda de cobrança é PHP, HKD, CNY ou MYR, correspondendo ao 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) está incluído em allowed_payment_method_types?
Adaptive Currency está ativado?
O valor atende ao mínimo da moeda em Métodos compatíveis?

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.

Páginas relacionadas

Payment Methods Overview

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

Adaptive Currency

Cobre os clientes na moeda local deles, 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étodo 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étodo 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étodo 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