Metodi di pagamento nell'area Asia-Pacifico

Consenti ai clienti nelle Filippine, a Hong Kong e in Malaysia di pagare con il wallet o il bonifico bancario che usano ogni giorno. Dodo Payments supporta GCash (Filippine), Alipay HK e FPS (Hong Kong) e Touch ‘n Go (Malaysia) per i pagamenti una tantum. Ogni metodo viene fatturato nella relativa valuta locale e il cliente paga scansionando un codice QR mostrato al checkout.

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 è il wallet digitale più popolare nelle Filippine e Touch ‘n Go è il principale e-wallet in Malaysia.

Low Card Penetration

L’uso delle carte di credito è limitato nelle Filippine rispetto ai mercati in cui le carte sono il metodo principale. I wallet locali e i bonifici bancari raggiungono i clienti che un checkout con sole carte non riuscirebbe a servire.

Instant Settlement

FPS è attivo 24 ore su 24 a Hong Kong e i fondi arrivano al beneficiario quasi immediatamente, quindi il checkout può confermare il pagamento mentre il cliente attende.

Metodi supportati

La tabella elenca il mercato, la valuta di fatturazione e l’importo minimo di ciascun metodo. Il minimo è l’importo minimo del checkout per quella valuta, quindi si applica a ogni metodo di pagamento in un checkout che utilizza tale valuta.

Metodo	Paese	Valuta di fatturazione	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 di essi appare nei checkout degli abbonamenti né supporta altri addebiti ricorrenti. Includi credit e debit nei checkout degli abbonamenti, così i clienti di questi mercati possono comunque registrarsi.

I clienti pagano nella valuta locale. I pagamenti effettuati con questi quattro metodi vengono regolati sul tuo wallet USD. I pagamenti con carta nello stesso checkout vengono regolati in USD.

Dettagli dei metodi

GCash (Philippines)

GCash è l’e-wallet più popolare nelle Filippine. Al checkout, il cliente seleziona GCash, fa clic su Paga e scansiona il codice QR con l’app GCash per approvare il pagamento.Disponibile nei checkout una tantum fatturati alle Filippine (PH) in PHP.

Alipay HK (Hong Kong)

Alipay HK è l’edizione di Alipay per Hong Kong. Serve il mercato locale e i pagamenti vengono regolati in dollari di Hong Kong. È un metodo distinto dal prodotto Alipay della Cina continentale. Il checkout lo identifica come AlipayHK.Disponibile nei checkout una tantum fatturati a Hong Kong (HK) in HKD. Alipay HK viene regolato solo in HKD, quindi non appare in un checkout in CNY, anche quando il Paese di fatturazione è Hong Kong.

FPS (Hong Kong)

FPS (Faster Payment System) è il sistema di pagamento in tempo reale di Hong Kong, lanciato dalla Hong Kong Monetary Authority. Collega banche ed e-wallet, è attivo 24 ore su 24 e supporta i dollari di Hong Kong e lo yuan cinese. Il cliente scansiona il codice QR con un’app bancaria o di e-wallet e i fondi arrivano quasi immediatamente.Disponibile nei checkout una tantum fatturati a Hong Kong (HK) in HKD o CNY.

Touch 'n Go (Malaysia)

Touch ‘n Go è il principale e-wallet in Malaysia. Il cliente scansiona il codice QR con l’app Touch ‘n Go e conferma il pagamento nell’app.Disponibile nei checkout una tantum fatturati alla Malaysia (MY) in MYR.

Configurazione

Tipi di metodi API

Passa questi valori in allowed_payment_method_types:

Tipo	Descrizione
`gcash`	Wallet GCash (Filippine)
`ali_pay_hk`	Wallet Alipay HK (Hong Kong)
`fps`	Bonifico bancario in tempo reale FPS (Hong Kong)
`touch_n_go`	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

Un metodo appare al checkout solo quando tutte le condizioni seguenti sono soddisfatte:

Il Paese di fatturazione corrisponde al mercato del metodo: PH per GCash, HK per Alipay HK e FPS, MY per Touch ‘n Go.
La valuta di fatturazione corrisponde al metodo: PHP, HKD (o CNY per FPS) o MYR.
Il checkout è un pagamento una tantum, non un abbonamento.
Adaptive Currency è abilitato. Senza questa opzione, billing_currency viene ignorato e il checkout non può fatturare in PHP, HKD, CNY o MYR.

Se Adaptive Currency è disabilitato, ai clienti di questi mercati non viene addebitata la valuta locale e nessuno di questi metodi appare.

Test

Enable test mode

Disattiva l’interruttore Live Mode nella barra laterale della dashboard e usa le chiavi API create in modalità test.

Set the billing country and currency

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

Metodo	Paese di fatturazione	Valuta di fatturazione
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 con un conto alla rovescia di 10 minuti e il checkout verifica lo stato del pagamento mentre la sovrapposizione è aperta.

Verify the checkout behavior

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

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

Best practice

Lead with the local wallet

Nelle Filippine e in Malaysia, molti clienti si aspettano di pagare con un wallet locale. Mostra GCash o Touch ‘n Go accanto alle carte nei checkout per questi mercati.

Offer both Hong Kong methods

Alipay HK e FPS si rivolgono a clienti diversi: utenti di wallet e utenti di bonifici bancari. Includili entrambi nei checkout in HKD, così ogni cliente vede il metodo che preferisce.

Keep cards on subscription checkouts

Ogni metodo in questa pagina è disponibile solo per pagamenti una tantum, quindi un checkout di abbonamento che elenca solo wallet locali non ha alcun metodo da mostrare. Includi credit e debit per i piani ricorrenti.

Match currency to region

Questi metodi richiedono la valuta di fatturazione locale. Se il tuo catalogo ha prezzi in USD o EUR, abilita Adaptive Currency per fare un preventivo e fatturare i clienti in PHP, HKD, CNY o MYR.

Risoluzione dei problemi

Method not appearing at checkout

Verifica:

Il Paese di fatturazione è PH, HK o MY, in corrispondenza del metodo?
La valuta di fatturazione è PHP, HKD, CNY o MYR, in corrispondenza del metodo?
Si tratta di un pagamento una tantum? Nessuno di questi metodi appare negli abbonamenti.
Il metodo (gcash, ali_pay_hk, fps o touch_n_go) è incluso in allowed_payment_method_types?
Adaptive Currency è abilitato?
L’importo raggiunge il minimo della valuta indicato in Metodi supportati?

Soluzione: rimuovi temporaneamente allowed_payment_method_types per visualizzare ogni metodo idoneo, quindi individua la condizione che non viene soddisfatta.

Alipay HK missing on a CNY checkout

Causa: Alipay HK viene regolato solo in HKD. Un checkout fatturato a Hong Kong in CNY offre FPS, ma non Alipay HK.Soluzione: fattura 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 sono offerti per la fatturazione ricorrente.Soluzione: usa credit e debit per gli abbonamenti in questi mercati.

Payment not confirming

Causa: il cliente deve scansionare il codice QR e approvare il pagamento in un wallet o in un’app bancaria. Se il cliente chiude l’app prima di approvare, il pagamento rimane incompleto.Soluzione: usa i webhook per lo stato finale del pagamento invece del redirect di ritorno. Consulta la guida sui webhook.

Pagine correlate

Payment Methods Overview

Visualizza tutti i metodi di pagamento supportati.

Adaptive Currency

Fattura i clienti nella valuta locale, incluse PHP, HKD, CNY e MYR.

Checkout Guide

Guida completa all’implementazione del checkout.

Testing Process

Dati di test e indicazioni per i 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 metodi 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 metodi 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 metodi API

Esempio: checkout nelle Filippine

Esempio: checkout a Hong Kong

Esempio: checkout in Malaysia

Requisiti

Test

Best practice

Risoluzione dei problemi

Pagine correlate