Moyens de paiement en Asie-Pacifique

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.

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

Low Card Penetration

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.

Instant Settlement

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.

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

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.

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.

Détails des moyens

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.

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.

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.

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.

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

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

Exigences

Pour que ces moyens apparaissent lors du checkout :

Le pays de facturation correspond au marché du moyen — PH pour GCash, HK pour Alipay HK et FPS, MY pour Touch ‘n Go
La devise correspond au moyen — PHP, HKD (ou CNY pour FPS) ou MYR
Le type de paiement est un paiement unique, et non un abonnement
Pour les marchands dont les prix sont dans une autre devise : Adaptive Currency doit être activé afin que les clients soient facturés dans la devise locale

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.

Tests

Enable test mode

Utilisez vos clés API de test Dodo Payments.

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.

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.

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.

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.

Bonnes pratiques

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.

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.

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.

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.

Dépannage

Method not appearing at checkout

Vérifiez :

Le pays de facturation est-il défini sur PH, HK ou MY, selon le moyen ?
La devise de facturation est-elle définie sur PHP, HKD, CNY ou MYR, selon le moyen ?
S’agit-il d’un paiement unique ? Aucun de ces moyens n’apparaît pour les abonnements.
Le moyen (gcash, ali_pay_hk, fps ou touch_n_go) est-il inclus dans allowed_payment_method_types ?
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.

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.

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.

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.

Pages associées

Payment Methods Overview

Consultez tous les moyens de paiement pris en charge.

Adaptive Currency

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

Checkout Guide

Guide complet de mise en œuvre 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 moyens

Configuration

Types de moyens API

Exemple : checkout aux Philippines

Exemple : checkout à Hong Kong

Exemple : checkout en Malaisie

Exigences

Tests

Bonnes pratiques

Dépannage

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 moyens

​Configuration

​Types de moyens API

​Exemple : checkout aux Philippines

​Exemple : checkout à Hong Kong

​Exemple : checkout en Malaisie

​Exigences

​Tests

​Bonnes pratiques

​Dépannage

​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 moyens

Configuration

Types de moyens API

Exemple : checkout aux Philippines

Exemple : checkout à Hong Kong

Exemple : checkout en Malaisie

Exigences

Tests

Bonnes pratiques

Dépannage

Pages associées