Metodi di pagamento nell'area Asia-Pacifico

Gli acquirenti di tutta la regione Asia-Pacifico effettuano il checkout con e-wallet locali e trasferimenti bancari in tempo reale molto più spesso che con carte internazionali. Dodo Payments supporta GCash (Filippine), Alipay HK e FPS (Hong Kong) e Touch ‘n Go (Malaysia), ciascuno addebitato nella valuta locale.

Questa pagina riguarda le Filippine, Hong Kong e Malaysia. Per gli altri mercati asiatici, consulta India per UPI e Rupay, South Korea per Kakao Pay, Naver Pay e PAYCO e WeChat Pay per i clienti cinesi.

Perché gli e-wallet dell’Asia-Pacifico sono importanti

Wallet-First Markets

GCash e Touch ‘n Go sono il metodo predefinito per pagare online nelle Filippine e in Malaysia, nettamente più utilizzati rispetto all’inserimento dei dati della carta.

Low Card Penetration

La titolarità di una carta è limitata in gran parte della regione. Gli e-wallet locali e i circuiti bancari raggiungono clienti che i checkout basati esclusivamente sulle carte non riescono a servire.

Instant Settlement

FPS esegue trasferimenti bancari in tempo reale a Hong Kong, quindi i pagamenti vengono confermati durante il checkout anziché dopo diverse ore.

Metodi supportati

Metodo	Paese	Valuta di addebito	Abbonamenti	Importo minimo
GCash	Filippine	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

Tutti e quattro i metodi sono disponibili solo per pagamenti una tantum. Nessuno supporta abbonamenti o altri addebiti ricorrenti. Includi sempre credit e debit nei checkout degli abbonamenti, così i clienti di questi mercati possono comunque registrarsi.

I clienti pagano nella loro valuta locale e tu ricevi il settlement in USD, come per ogni altro metodo non in USD.

Dettagli dei metodi

GCash (Philippines)

GCash è il principale e-wallet delle Filippine, utilizzato per ogni esigenza, dal pagamento delle bollette agli acquisti online. I clienti approvano il pagamento nell’app GCash e vengono reindirizzati alla pagina di conferma.Disponibile nei checkout una tantum con addebito nelle Filippine (PH) in PHP.

Alipay HK (Hong Kong)

Alipay HK è l’edizione di Alipay per Hong Kong, gestita per il mercato locale e con settlement in dollari di Hong Kong. È un metodo distinto dal prodotto Alipay della Cina continentale.Disponibile nei checkout una tantum con addebito a Hong Kong (HK) in HKD. Alipay HK effettua il settlement esclusivamente in HKD, quindi non viene visualizzato in un checkout in CNY anche quando il Paese di addebito è Hong Kong.

FPS (Hong Kong)

FPS (Faster Payment System) è la rete di trasferimenti interbancari in tempo reale di Hong Kong, gestita dalla Hong Kong Monetary Authority. I clienti pagano direttamente dal proprio conto bancario e il trasferimento viene completato immediatamente.Disponibile nei checkout una tantum con addebito a Hong Kong (HK) in HKD o CNY.

Touch 'n Go (Malaysia)

Touch ‘n Go è l’e-wallet principale della Malaysia. I clienti confermano il pagamento nell’app Touch ‘n Go e tornano alla pagina di conferma.Disponibile nei checkout una tantum con addebito in Malaysia (MY) in MYR.

Configurazione

Tipi di metodo API

Tipo	Descrizione
`gcash`	E-wallet GCash (Filippine)
`ali_pay_hk`	E-wallet Alipay HK (Hong Kong)
`fps`	Trasferimento bancario FPS in tempo reale (Hong Kong)
`touch_n_go`	E-wallet Touch ‘n Go (Malaysia)

Esempio: checkout nelle Filippine

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'
});

Esempio: checkout a 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'
});

Esempio: checkout in Malaysia

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'
});

Requisiti

Affinché questi metodi vengano visualizzati al checkout:

Paese di addebito corrispondente al mercato del metodo — PH per GCash, HK per Alipay HK e FPS, MY per Touch ‘n Go
Valuta corrispondente al metodo — PHP, HKD (o CNY per FPS) oppure MYR
Tipo di pagamento costituito da un pagamento una tantum, non da un abbonamento
Per i merchant con prezzi in un’altra valuta: Adaptive Currency deve essere abilitato, così i clienti ricevono l’addebito nella valuta locale

Se imposti i prezzi in un’altra valuta e Adaptive Currency non è abilitato, ai clienti di questi mercati non verrà addebitato l’importo nella valuta locale e nessuno di questi metodi sarà disponibile.

Test

Enable test mode

Utilizza le chiavi API di test di Dodo Payments.

Set the billing country and currency

Crea un checkout una tantum con il Paese dell’indirizzo di addebito e la valuta di addebito del metodo che stai testando:

Metodo	Paese di addebito	Valuta di addebito
GCash	`PH`	`PHP`
Alipay HK	`HK`	`HKD`
FPS	`HK`	`HKD` o `CNY`
Touch ‘n Go	`MY`	`MYR`

Includi il tipo di metodo in allowed_payment_method_types. Questi metodi non sono disponibili nei checkout degli abbonamenti.

Select the method and confirm

Seleziona il metodo di pagamento al checkout e fai clic su Paga. Un codice QR si apre in una sovrapposizione a schermo intero e il checkout attende il pagamento.

Verify the checkout behavior

Verifica che il metodo venga visualizzato solo per il Paese e la valuta corrispondenti e che il codice QR venga visualizzato correttamente.

I codici QR in modalità test vengono emessi dall’ambiente di test del provider dell’e-wallet e potrebbero comportarsi diversamente rispetto a un pagamento reale.

Best practice

Lead with the local wallet

Nelle Filippine e in Malaysia, l’e-wallet locale è il metodo di pagamento principale che i clienti si aspettano. Mostrare GCash o Touch ‘n Go insieme alle carte riduce significativamente l’abbandono.

Offer both Hong Kong methods

Alipay HK e FPS servono clienti diversi: gli utenti degli e-wallet e quelli che preferiscono i trasferimenti bancari. Includili entrambi nei checkout in HKD, così Dodo Payments può presentare l’opzione preferita dal cliente.

Keep cards on subscription checkouts

Poiché tutti i metodi di questa pagina sono disponibili solo per pagamenti una tantum, un checkout di abbonamento che elenca esclusivamente gli e-wallet locali non ha alcun metodo da mostrare. Includi sempre credit e debit per i piani ricorrenti.

Match currency to region

Questi metodi richiedono la valuta di addebito locale. Se il tuo catalogo ha prezzi in USD o EUR, abilita Adaptive Currency, così ai clienti verranno mostrati i prezzi e gli addebiti saranno effettuati in PHP, HKD, CNY o MYR.

Risoluzione dei problemi

Method not appearing at checkout

Verifica:

Il Paese di addebito è impostato su PH, HK o MY in base al metodo?
La valuta di addebito è impostata su PHP, HKD, CNY o MYR in base al metodo?
Si tratta di un pagamento una tantum? Nessuno di questi metodi viene visualizzato per gli abbonamenti.
Il metodo (gcash, ali_pay_hk, fps o touch_n_go) è incluso in allowed_payment_method_types?
Se il prezzo è espresso in un’altra valuta: Adaptive Currency è abilitato?

Soluzione: rimuovi temporaneamente allowed_payment_method_types per visualizzare tutti i metodi idonei, quindi restringi la ricerca per individuare la condizione che non viene soddisfatta.

Alipay HK missing on a CNY checkout

Causa: Alipay HK effettua il settlement esclusivamente in HKD. Un checkout con addebito a Hong Kong in CNY offre FPS, ma non Alipay HK.Soluzione: effettua l’addebito in HKD per offrire Alipay HK oppure includi fps nei checkout in CNY a Hong Kong.

Wallet missing on a subscription

Causa: GCash, Alipay HK, FPS e Touch ‘n Go sono disponibili solo per pagamenti una tantum e non vengono mai offerti per gli addebiti ricorrenti.Soluzione: utilizza credit e debit per gli abbonamenti in questi mercati.

Payment not confirming

Causa: questi metodi reindirizzano il cliente a un’app di e-wallet o bancaria. Se il cliente abbandona l’app, il pagamento rimane incompleto.Soluzione: monitora i webhook per conoscere lo stato finale del pagamento invece di affidarti al reindirizzamento di ritorno. Consulta la guida sui webhook.

Pagine correlate

Payment Methods Overview

Visualizza tutti i metodi di pagamento supportati.

Adaptive Currency

Addebita ai clienti la loro valuta locale, inclusi PHP, HKD, CNY e MYR.

Checkout Guide

Guida completa all’implementazione del checkout.

Testing Process

Dati di test e indicazioni per il test del checkout.

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Perché gli e-wallet dell’Asia-Pacifico sono importanti

Wallet-First Markets

Low Card Penetration

Instant Settlement

Metodi supportati

Dettagli dei metodi

Configurazione

Tipi di metodo API

Esempio: checkout nelle Filippine

Esempio: checkout a Hong Kong

Esempio: checkout in Malaysia

Requisiti

Test

Best practice

Risoluzione dei problemi

Pagine correlate

Payment Methods Overview

Adaptive Currency

Checkout Guide

Testing Process

​Perché gli e-wallet dell’Asia-Pacifico sono importanti

Wallet-First Markets

Low Card Penetration

Instant Settlement

​Metodi supportati

​Dettagli dei metodi

​Configurazione

​Tipi di metodo API

​Esempio: checkout nelle Filippine

​Esempio: checkout a Hong Kong

​Esempio: checkout in Malaysia

​Requisiti

​Test

​Best practice

​Risoluzione dei problemi

​Pagine correlate

Payment Methods Overview

Adaptive Currency

Checkout Guide

Testing Process

Perché gli e-wallet dell’Asia-Pacifico sono importanti

Metodi supportati

Dettagli dei metodi

Configurazione

Tipi di metodo API

Esempio: checkout nelle Filippine

Esempio: checkout a Hong Kong

Esempio: checkout in Malaysia

Requisiti

Test

Best practice

Risoluzione dei problemi

Pagine correlate