Moyens de paiement en Asie-Pacifique

Permettez aux clients des Philippines, de Hong Kong et de Malaisie de payer avec le portefeuille ou le virement bancaire qu’ils utilisent au quotidien. Dodo Payments prend en charge GCash (Philippines), Alipay HK et FPS (Hong Kong), ainsi que Touch ‘n Go (Malaisie) pour les paiements ponctuels. Chaque méthode est facturée dans sa devise locale, et le client paie en scannant un code QR affiché lors du checkout.

Cette page couvre les Philippines, Hong Kong et la Malaisie. Pour les autres marchés asiatiques, consultez l’Inde pour UPI et Rupay, la Corée du Sud pour Kakao Pay, Naver Pay et PAYCO, ainsi que WeChat Pay pour les clients chinois.

Pourquoi les portefeuilles d’Asie-Pacifique sont importants

Wallet-First Markets

GCash est le portefeuille numérique le plus populaire aux Philippines, et Touch ‘n Go est le plus grand portefeuille électronique de Malaisie.

Low Card Penetration

L’utilisation des cartes de crédit est faible aux Philippines par rapport aux marchés où les cartes sont privilégiées. Les portefeuilles locaux et les virements bancaires permettent d’atteindre les clients qu’un checkout limité aux cartes ne peut pas toucher.

Instant Settlement

FPS fonctionne 24 heures sur 24 à Hong Kong, et les fonds parviennent presque immédiatement au bénéficiaire. Le checkout peut donc confirmer le paiement pendant que le client attend.

Moyens pris en charge

Le tableau répertorie le marché, la devise de facturation et le montant minimum de chaque méthode. Le minimum correspond au montant minimum du checkout pour cette devise et s’applique donc à toutes les méthodes de paiement d’un checkout dans cette devise.

Méthode	Pays	Devise de facturation	Abonnements	Montant min.
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

Les quatre méthodes sont exclusivement ponctuelles. Aucune n’apparaît lors des checkouts d’abonnement ni ne prend en charge d’autre paiement récurrent. Incluez credit et debit lors des checkouts d’abonnement afin que les clients de ces marchés puissent tout de même s’inscrire.

Les clients paient dans leur devise locale. Les paiements effectués avec ces quatre méthodes sont versés sur votre portefeuille USD. Les paiements par carte du même checkout sont également versés en USD.

Détails des méthodes

GCash (Philippines)

GCash est le portefeuille électronique le plus populaire aux Philippines. Lors du checkout, le client sélectionne GCash, clique sur Pay, puis scanne le code QR avec l’application GCash pour approuver le paiement.Disponible lors des checkouts ponctuels facturés aux Philippines (PH) en PHP.

Alipay HK (Hong Kong)

Alipay HK est l’édition hongkongaise d’Alipay. Elle dessert le marché local et effectue les règlements en dollars de Hong Kong. Il s’agit d’une méthode distincte du produit Alipay de Chine continentale. Le checkout l’affiche sous le nom AlipayHK.Disponible lors des checkouts ponctuels facturés à Hong Kong (HK) en HKD. Alipay HK effectue les règlements 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.

FPS (Hong Kong)

FPS (Faster Payment System) est le système de paiement en temps réel de Hong Kong, lancé par la Hong Kong Monetary Authority. Il relie les banques et les portefeuilles électroniques, fonctionne 24 heures sur 24 et prend en charge les dollars de Hong Kong et les yuans chinois. Le client scanne le code QR avec une application bancaire ou de portefeuille électronique, et les fonds arrivent presque immédiatement.Disponible lors des checkouts ponctuels facturés à Hong Kong (HK) en HKD ou en CNY.

Touch 'n Go (Malaysia)

Touch ‘n Go est le plus grand portefeuille électronique de Malaisie. Le client scanne le code QR avec l’application Touch ‘n Go et confirme le paiement dans celle-ci.Disponible lors des checkouts ponctuels facturés à la Malaisie (MY) en MYR.

Configuration

Types de méthodes API

Transmettez ces valeurs dans allowed_payment_method_types :

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

Exemple : checkout aux Philippines

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

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

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

Conditions requises

Une méthode apparaît lors du checkout uniquement lorsque toutes les conditions suivantes sont remplies :

Le pays de facturation correspond au marché de la méthode : PH pour GCash, HK pour Alipay HK et FPS, et MY pour Touch ‘n Go.
La devise de facturation correspond à la méthode : PHP, HKD (ou CNY pour FPS), ou MYR.
Le checkout correspond à un paiement ponctuel, et non à un abonnement.
Adaptive Currency est activé. Sans cela, billing_currency est ignoré et le checkout ne peut pas facturer en PHP, HKD, CNY ou MYR.

Si Adaptive Currency est désactivé, les clients de ces marchés ne sont pas facturés dans leur devise locale et aucune de ces méthodes n’apparaît.

Tests

Enable test mode

Désactivez le bouton Live Mode dans la barre latérale du dashboard et utilisez les clés API créées en mode test.

Set the billing country and currency

Créez un checkout ponctuel avec le pays et la devise de facturation correspondant à la méthode que vous testez :

Méthode	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 méthode dans allowed_payment_method_types. Ces méthodes ne sont pas proposées lors des checkouts d’abonnement.

Select the method and confirm

Sélectionnez la méthode de paiement lors du checkout et cliquez sur Pay. Un code QR s’ouvre dans une superposition en plein écran avec un compte à rebours de 10 minutes, et le checkout vérifie le statut du paiement tant que la superposition est ouverte.

Verify the checkout behavior

Vérifiez que la méthode apparaît uniquement pour le pays et la devise correspondants et que le code QR s’affiche.

Les codes QR en mode test proviennent de l’environnement de test du fournisseur du portefeuille et peuvent se comporter différemment d’un paiement réel.

Bonnes pratiques

Lead with the local wallet

Aux Philippines et en Malaisie, de nombreux clients s’attendent à payer avec un portefeuille local. Affichez GCash ou Touch ‘n Go à côté des cartes lors des checkouts pour ces marchés.

Offer both Hong Kong methods

Alipay HK et FPS s’adressent à des clients différents : les utilisateurs de portefeuilles et les utilisateurs de virements bancaires. Incluez les deux lors des checkouts en HKD afin que chaque client voie la méthode qu’il préfère.

Keep cards on subscription checkouts

Toutes les méthodes de cette page sont exclusivement ponctuelles. Un checkout d’abonnement qui ne répertorie que les portefeuilles locaux n’a donc aucune méthode à afficher. Incluez credit et debit pour les plans récurrents.

Match currency to region

Ces méthodes nécessitent leur devise de facturation locale. Si votre catalogue est tarifé en USD ou en EUR, activez Adaptive Currency afin que les clients reçoivent un devis et soient facturés en PHP, HKD, CNY ou MYR.

Résolution des problèmes

Method not appearing at checkout

Vérifiez :

Le pays de facturation est-il PH, HK ou MY, selon la méthode ?
La devise de facturation est-elle PHP, HKD, CNY ou MYR, selon la méthode ?
S’agit-il d’un paiement ponctuel ? Aucune de ces méthodes n’apparaît pour les abonnements.
La méthode (gcash, ali_pay_hk, fps ou touch_n_go) est-elle incluse dans allowed_payment_method_types ?
Adaptive Currency est-il activé ?
Le montant atteint-il le minimum de la devise indiqué dans Méthodes prises en charge ?

Solution : Supprimez temporairement allowed_payment_method_types afin d’afficher toutes les méthodes éligibles, puis identifiez la condition qui n’est pas remplie.

Alipay HK missing on a CNY checkout

Cause : Alipay HK effectue les règlements 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.

Wallet missing on a subscription

Cause : GCash, Alipay HK, FPS et Touch ‘n Go sont exclusivement ponctuels et ne sont pas proposés pour la facturation récurrente.Solution : Utilisez credit et debit pour les abonnements sur ces marchés.

Payment not confirming

Cause : Le client doit scanner le code QR et approuver le paiement dans une application de portefeuille ou bancaire. Si le client ferme l’application avant d’approuver le paiement, celui-ci reste incomplet.Solution : Utilisez des webhooks pour obtenir le statut final du paiement plutôt que la redirection de retour. Consultez le guide Webhooks.

Pages associées

Payment Methods Overview

Consultez toutes les méthodes de paiement prises en charge.

Adaptive Currency

Facturez les clients dans leur devise locale, notamment en PHP, HKD, CNY et MYR.

Checkout Guide

Guide complet d’implémentation du checkout.

Testing Process

Données de test et instructions pour tester le checkout.

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Pourquoi les portefeuilles d’Asie-Pacifique sont importants

Wallet-First Markets

Low Card Penetration

Instant Settlement

Moyens pris en charge

Détails des méthodes

Configuration

Types de méthodes API

Exemple : checkout aux Philippines

Exemple : checkout à Hong Kong

Exemple : checkout en Malaisie

Conditions requises

Tests

Bonnes pratiques

Résolution des problèmes

Pages associées

Payment Methods Overview

Adaptive Currency

Checkout Guide

Testing Process

​Pourquoi les portefeuilles d’Asie-Pacifique sont importants

Wallet-First Markets

Low Card Penetration

Instant Settlement

​Moyens pris en charge

​Détails des méthodes

​Configuration

​Types de méthodes API

​Exemple : checkout aux Philippines

​Exemple : checkout à Hong Kong

​Exemple : checkout en Malaisie

​Conditions requises

​Tests

​Bonnes pratiques

​Résolution des problèmes

​Pages associées

Payment Methods Overview

Adaptive Currency

Checkout Guide

Testing Process

Pourquoi les portefeuilles d’Asie-Pacifique sont importants

Moyens pris en charge

Détails des méthodes

Configuration

Types de méthodes API

Exemple : checkout aux Philippines

Exemple : checkout à Hong Kong

Exemple : checkout en Malaisie

Conditions requises

Tests

Bonnes pratiques

Résolution des problèmes

Pages associées