> ## 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.

# Metodi di pagamento nell'area Asia-Pacifico

> Accetta GCash nelle Filippine, Alipay HK e FPS a Hong Kong e Touch 'n Go in Malaysia. Scopri i requisiti valutari, il supporto per i pagamenti una tantum e la configurazione.

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.

<Note>
  Questa pagina riguarda le Filippine, Hong Kong e Malaysia. Per gli altri mercati asiatici, consulta [India](/features/payment-methods/india) per UPI e Rupay, [South Korea](/features/payment-methods/south-korea) per Kakao Pay, Naver Pay e PAYCO e [WeChat Pay](/features/payment-methods/wechat) per i clienti cinesi.
</Note>

## Perché gli e-wallet dell'Asia-Pacifico sono importanti

<CardGroup cols={3}>
  <Card title="Wallet-First Markets" icon="wallet">
    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.
  </Card>

  <Card title="Low Card Penetration" icon="credit-card">
    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.
  </Card>

  <Card title="Instant Settlement" icon="bolt">
    FPS esegue trasferimenti bancari in tempo reale a Hong Kong, quindi i pagamenti vengono confermati durante il checkout anziché dopo diverse ore.
  </Card>
</CardGroup>

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

<Warning>
  **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.
</Warning>

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

### Dettagli dei metodi

<AccordionGroup>
  <Accordion title="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**.
  </Accordion>

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

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

  <Accordion title="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**.
  </Accordion>
</AccordionGroup>

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

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

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

### Esempio: checkout in Malaysia

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

### Requisiti

Affinché questi metodi vengano visualizzati al checkout:

1. **Paese di addebito** corrispondente al mercato del metodo — `PH` per GCash, `HK` per Alipay HK e FPS, `MY` per Touch 'n Go
2. **Valuta** corrispondente al metodo — PHP, HKD (o CNY per FPS) oppure MYR
3. **Tipo di pagamento** costituito da un pagamento una tantum, non da un abbonamento
4. Per i merchant con prezzi in un'altra valuta: **[Adaptive Currency](/features/adaptive-currency)** deve essere abilitato, così i clienti ricevono l'addebito nella valuta locale

<Warning>
  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.
</Warning>

## Test

<Steps>
  <Step title="Enable test mode">
    Utilizza le chiavi API di test di Dodo Payments.
  </Step>

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

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

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

<Note>
  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.
</Note>

## Best practice

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

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

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

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

## Risoluzione dei problemi

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

    1. Il Paese di addebito è impostato su `PH`, `HK` o `MY` in base al metodo?
    2. La valuta di addebito è impostata su PHP, HKD, CNY o MYR in base al metodo?
    3. Si tratta di un pagamento una tantum? Nessuno di questi metodi viene visualizzato per gli abbonamenti.
    4. Il metodo (`gcash`, `ali_pay_hk`, `fps` o `touch_n_go`) è incluso in `allowed_payment_method_types`?
    5. 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.
  </Accordion>

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

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

  <Accordion title="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](/developer-resources/webhooks).
  </Accordion>
</AccordionGroup>

## Pagine correlate

<CardGroup cols={2}>
  <Card title="Payment Methods Overview" icon="credit-card" href="/features/payment-methods">
    Visualizza tutti i metodi di pagamento supportati.
  </Card>

  <Card title="Adaptive Currency" icon="globe" href="/features/adaptive-currency">
    Addebita ai clienti la loro valuta locale, inclusi PHP, HKD, CNY e MYR.
  </Card>

  <Card title="Checkout Guide" icon="book" href="/developer-resources/checkout-session">
    Guida completa all'implementazione del checkout.
  </Card>

  <Card title="Testing Process" icon="flask" href="/miscellaneous/testing-process">
    Dati di test e indicazioni per il test del checkout.
  </Card>
</CardGroup>