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

# Moyens de paiement en Asie-Pacifique

> Acceptez GCash aux Philippines, Alipay HK et FPS à Hong Kong, ainsi que Touch 'n Go en Malaisie. Découvrez les exigences en matière de devise, la prise en charge des paiements uniques et la configuration.

Les acheteurs de la région Asie-Pacifique paient beaucoup plus souvent avec des portefeuilles électroniques locaux et des virements bancaires en temps réel qu'avec des cartes internationales. Dodo Payments prend en charge **GCash** (Philippines), **Alipay HK** et **FPS** (Hong Kong), ainsi que **Touch 'n Go** (Malaisie), chacun étant facturé dans sa devise locale.

<Note>
  Cette page couvre les Philippines, Hong Kong et la Malaisie. Pour les autres marchés asiatiques, consultez [l'Inde](/features/payment-methods/india) pour UPI et Rupay, la [Corée du Sud](/features/payment-methods/south-korea) pour Kakao Pay, Naver Pay et PAYCO, ainsi que [WeChat Pay](/features/payment-methods/wechat) pour les clients chinois.
</Note>

## Pourquoi les portefeuilles d'Asie-Pacifique sont importants

<CardGroup cols={3}>
  <Card title="Wallet-First Markets" icon="wallet">
    GCash et Touch 'n Go sont les moyens de paiement en ligne par défaut aux Philippines et en Malaisie, largement devant la saisie des informations de carte.
  </Card>

  <Card title="Low Card Penetration" icon="credit-card">
    La détention d'une carte reste limitée dans une grande partie de la région. Les portefeuilles et réseaux bancaires locaux atteignent des clients que les paiements par carte uniquement ne peuvent pas atteindre.
  </Card>

  <Card title="Instant Settlement" icon="bolt">
    FPS effectue des compensations interbancaires en temps réel à Hong Kong. Les paiements sont ainsi confirmés pendant le checkout, plutôt que plusieurs heures plus tard.
  </Card>
</CardGroup>

## Moyens pris en charge

| Moyen           | Pays        | Devise de facturation | Abonnements | Montant minimum     |
| :-------------- | :---------- | :-------------------- | :---------: | :------------------ |
| **GCash**       | Philippines | PHP                   |     Non     | 50.00 PHP           |
| **Alipay HK**   | Hong Kong   | HKD                   |     Non     | 4.00 HKD            |
| **FPS**         | Hong Kong   | HKD, CNY              |     Non     | 4.00 HKD / 4.00 CNY |
| **Touch 'n Go** | Malaisie    | MYR                   |     Non     | 4.00 MYR            |

<Warning>
  **Les quatre moyens sont disponibles uniquement pour les paiements uniques.** Aucun ne prend en charge les abonnements ou tout autre prélèvement récurrent. Incluez toujours `credit` et `debit` dans les checkouts d'abonnement afin que les clients de ces marchés puissent tout de même s'inscrire.
</Warning>

<Info>
  Les clients paient dans leur devise locale et vous recevez le règlement en **USD**, comme pour tout autre moyen qui n'est pas en USD.
</Info>

### Détails des moyens

<AccordionGroup>
  <Accordion title="GCash (Philippines)">
    GCash est le plus grand portefeuille électronique des Philippines, utilisé pour tout, des factures aux achats en ligne. Les clients approuvent le paiement dans l'application GCash, puis sont redirigés vers votre page de confirmation.

    Disponible pour les checkouts **uniquement ponctuels** facturés aux **Philippines (`PH`)** en **PHP**.
  </Accordion>

  <Accordion title="Alipay HK (Hong Kong)">
    Alipay HK est la version hongkongaise d'Alipay, exploitée pour le marché local et réglée en dollars de Hong Kong. Il s'agit d'un moyen distinct du produit Alipay de Chine continentale.

    Disponible pour les checkouts **uniquement ponctuels** facturés à **Hong Kong (`HK`)** en **HKD**. Alipay HK est réglé uniquement en HKD et n'apparaît donc pas lors d'un checkout en CNY, même si le pays de facturation est Hong Kong.
  </Accordion>

  <Accordion title="FPS (Hong Kong)">
    FPS (Faster Payment System) est le réseau de virements interbancaires en temps réel de Hong Kong, géré par la Hong Kong Monetary Authority. Les clients paient directement depuis leur compte bancaire et le virement est compensé instantanément.

    Disponible pour les checkouts **uniquement ponctuels** facturés à **Hong Kong (`HK`)** en **HKD** ou en **CNY**.
  </Accordion>

  <Accordion title="Touch 'n Go (Malaysia)">
    Touch 'n Go est le portefeuille électronique dominant en Malaisie. Les clients confirment le paiement dans l'application Touch 'n Go, puis reviennent sur votre page de confirmation.

    Disponible pour les checkouts **uniquement ponctuels** facturés à **la Malaisie (`MY`)** en **MYR**.
  </Accordion>
</AccordionGroup>

## Configuration

### Types de moyens API

| Type         | Description                                     |
| :----------- | :---------------------------------------------- |
| `gcash`      | Portefeuille GCash (Philippines)                |
| `ali_pay_hk` | Portefeuille Alipay HK (Hong Kong)              |
| `fps`        | Virement bancaire FPS en temps réel (Hong Kong) |
| `touch_n_go` | Portefeuille Touch 'n Go (Malaisie)             |

### Exemple : checkout aux Philippines

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

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

### Exemple : checkout en Malaisie

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

### Exigences

Pour que ces moyens apparaissent lors du checkout :

1. Le **pays de facturation** correspond au marché du moyen — `PH` pour GCash, `HK` pour Alipay HK et FPS, `MY` pour Touch 'n Go
2. La **devise** correspond au moyen — PHP, HKD (ou CNY pour FPS) ou MYR
3. Le **type de paiement** est un paiement unique, et non un abonnement
4. Pour les marchands dont les prix sont dans une autre devise : **[Adaptive Currency](/features/adaptive-currency)** doit être activé afin que les clients soient facturés dans la devise locale

<Warning>
  Si vous définissez vos prix dans une autre devise et que Adaptive Currency n'est pas activé, les clients de ces marchés ne seront pas facturés dans la devise locale et aucun de ces moyens ne sera disponible.
</Warning>

## Tests

<Steps>
  <Step title="Enable test mode">
    Utilisez vos clés API de test Dodo Payments.
  </Step>

  <Step title="Set the billing country and currency">
    Créez un checkout ponctuel avec le pays et la devise de facturation correspondant au moyen que vous testez :

    | Moyen       | Pays de facturation | Devise de facturation |
    | :---------- | :------------------ | :-------------------- |
    | GCash       | `PH`                | `PHP`                 |
    | Alipay HK   | `HK`                | `HKD`                 |
    | FPS         | `HK`                | `HKD` ou `CNY`        |
    | Touch 'n Go | `MY`                | `MYR`                 |

    Incluez le type de moyen dans `allowed_payment_method_types`. Ces moyens ne sont pas proposés dans les checkouts d'abonnement.
  </Step>

  <Step title="Select the method and confirm">
    Sélectionnez le moyen de paiement lors du checkout et cliquez sur **Payer**. Un code QR s'ouvre dans une superposition plein écran et le checkout attend le paiement.
  </Step>

  <Step title="Verify the checkout behavior">
    Vérifiez que le moyen apparaît uniquement pour le pays et la devise correspondants et que le code QR s'affiche.
  </Step>
</Steps>

<Note>
  Les codes QR du mode test sont émis par l'environnement de test du fournisseur du portefeuille et peuvent se comporter différemment d'un paiement réel.
</Note>

## Bonnes pratiques

<AccordionGroup>
  <Accordion title="Lead with the local wallet">
    Aux Philippines et en Malaisie, le portefeuille local est le principal moyen de paiement attendu par les clients. Proposer GCash ou Touch 'n Go aux côtés des cartes réduit considérablement les abandons.
  </Accordion>

  <Accordion title="Offer both Hong Kong methods">
    Alipay HK et FPS s'adressent à des clients différents : les utilisateurs de portefeuilles et ceux qui utilisent les virements bancaires. Incluez les deux dans les checkouts en HKD afin que Dodo Payments puisse proposer le moyen préféré du client.
  </Accordion>

  <Accordion title="Keep cards on subscription checkouts">
    Comme tous les moyens de cette page sont uniquement ponctuels, un checkout d'abonnement qui ne propose que des portefeuilles locaux n'aura rien à afficher. Incluez toujours `credit` et `debit` pour les offres récurrentes.
  </Accordion>

  <Accordion title="Match currency to region">
    Ces moyens nécessitent leur devise de facturation locale. Si votre catalogue est tarifé en USD ou en EUR, activez Adaptive Currency afin que les clients voient les prix et soient facturés en PHP, HKD, CNY ou MYR.
  </Accordion>
</AccordionGroup>

## Dépannage

<AccordionGroup>
  <Accordion title="Method not appearing at checkout">
    **Vérifiez :**

    1. Le pays de facturation est-il défini sur `PH`, `HK` ou `MY`, selon le moyen ?
    2. La devise de facturation est-elle définie sur PHP, HKD, CNY ou MYR, selon le moyen ?
    3. S'agit-il d'un paiement unique ? Aucun de ces moyens n'apparaît pour les abonnements.
    4. Le moyen (`gcash`, `ali_pay_hk`, `fps` ou `touch_n_go`) est-il inclus dans `allowed_payment_method_types` ?
    5. Si les prix sont dans une autre devise : Adaptive Currency est-il activé ?

    **Solution :** Supprimez temporairement `allowed_payment_method_types` pour voir tous les moyens éligibles, puis déterminez quelle condition n'est pas respectée.
  </Accordion>

  <Accordion title="Alipay HK missing on a CNY checkout">
    **Cause :** Alipay HK est réglé uniquement en HKD. Un checkout facturé à Hong Kong en CNY propose FPS, mais jamais Alipay HK.

    **Solution :** Facturez en HKD pour proposer Alipay HK, ou incluez `fps` pour les checkouts en CNY à Hong Kong.
  </Accordion>

  <Accordion title="Wallet missing on a subscription">
    **Cause :** GCash, Alipay HK, FPS et Touch 'n Go sont tous uniquement ponctuels et ne sont jamais proposés pour la facturation récurrente.

    **Solution :** Utilisez `credit` et `debit` pour les abonnements dans ces marchés.
  </Accordion>

  <Accordion title="Payment not confirming">
    **Cause :** Ces moyens redirigent le client vers une application de portefeuille ou une application bancaire. Si le client abandonne l'application, le paiement reste incomplet.

    **Solution :** Surveillez les webhooks pour connaître le statut final du paiement au lieu de vous fier à la redirection de retour. Consultez le [guide Webhooks](/developer-resources/webhooks).
  </Accordion>
</AccordionGroup>

## Pages associées

<CardGroup cols={2}>
  <Card title="Payment Methods Overview" icon="credit-card" href="/features/payment-methods">
    Consultez tous les moyens de paiement pris en charge.
  </Card>

  <Card title="Adaptive Currency" icon="globe" href="/features/adaptive-currency">
    Facturez les clients dans leur devise locale, notamment en PHP, HKD, CNY et MYR.
  </Card>

  <Card title="Checkout Guide" icon="book" href="/developer-resources/checkout-session">
    Guide complet de mise en œuvre du checkout.
  </Card>

  <Card title="Testing Process" icon="flask" href="/miscellaneous/testing-process">
    Données de test et instructions pour tester le checkout.
  </Card>
</CardGroup>