Skip to main content
Permettez à vos clients chinois de payer en scannant un code QR avec l’application WeChat. WeChat Pay est le portefeuille de paiement intégré à WeChat, la principale application mobile de Chine, et Dodo Payments le propose pour les paiements ponctuels facturés en USD ou en CNY.

​
Pourquoi proposer WeChat Pay ?

800M+ Users

WeChat compte plus d’un milliard d’utilisateurs actifs chaque mois, et WeChat Pay compte plus de 800 millions d’utilisateurs.

Mobile-First

Le client approuve le paiement dans l’application WeChat, un processus que les clients chinois connaissent déjà.

Dual Currency

Facturez en USD ou en CNY, selon les clients auxquels vous vous adressez.

​
Aperçu

​
Comment ça fonctionne

​
Expérience client

  1. Le client sélectionne WeChat au moment du paiement et clique sur Payer.
  2. Un code QR s’ouvre dans une superposition en plein écran sur la page de paiement.
  3. Le client ouvre WeChat sur son téléphone et scanne le code QR. Si le client effectue déjà le paiement sur son téléphone, la page de paiement affiche les étapes pour prendre une capture d’écran du code QR et le scanner depuis l’album photo WeChat.
  4. Le client confirme le paiement dans l’application WeChat.
  5. La page de paiement détecte que le paiement est terminé et redirige le client vers votre page de réussite.
Les clients paient en USD ou CNY, et vous recevez le règlement en USD.

​
Configuration

WeChat Pay apparaît lors des paiements ponctuels facturés en USD ou en CNY. Pour facturer en CNY, activez Adaptive Currency et transmettez billing_currency: 'CNY'.

​
Type de méthode API

​
Tests

1

Enable test mode

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

Create a test checkout

Créez une session de paiement ponctuel avec we_chat_pay dans allowed_payment_method_types.
3

Scan the QR code

La page de paiement affiche un code QR de test. Scannez-le avec l’appareil photo de votre téléphone ; l’application WeChat n’est pas nécessaire. Le code QR ouvre une page de test où vous pouvez autoriser ou échouer le paiement.

​
Bonnes pratiques

WeChat Pay est principalement utilisé par les consommateurs chinois. Proposez-le lorsque vos clients comprennent des acheteurs chinois ou lorsque vous vendez sur le marché chinois.
Tous les clients n’utilisent pas WeChat. Incluez credit et debit comme méthodes de paiement de secours.
Le scan est plus facile lorsque la page de paiement est ouverte sur un ordinateur ou une tablette et que le client scanne avec son téléphone. Sur un téléphone, la page de paiement guide le client pour prendre une capture d’écran du code QR et le scanner depuis l’album photo WeChat ; veillez donc à ce que votre page de paiement soit responsive.
WeChat Pay prend en charge l’USD et le CNY. Choisissez la devise de facturation qui convient à vos clients : l’USD si vos prix sont en USD, ou le CNY pour afficher aux clients chinois un prix dans leur propre devise. Le règlement se fait en USD dans les deux cas.

​
Résolution des problèmes

Vérifiez :
  1. we_chat_pay est-il inclus dans allowed_payment_method_types ?
  2. La devise de facturation est-elle l’USD ou le CNY ?
  3. Le montant atteint-il le minimum ($0.50 ou 4.00 CNY) ?
  4. S’agit-il d’un paiement ponctuel ? WeChat Pay n’est pas proposé pour les abonnements.
Solution : vérifiez le type de méthode de paiement et la devise dans votre requête API.
Cause : Le code QR a peut-être expiré, ou la version de WeChat du client est obsolète. Le code QR expire après un certain temps.Solution : Si le code QR a expiré, le client doit démarrer un nouveau checkout depuis votre site, ou vous pouvez créer une nouvelle session de checkout pour lui. Si le code est toujours valide, demandez au client de mettre WeChat à jour vers une version récente.
Cause : WeChat Pay confirme généralement le paiement en quelques secondes, mais des délais réseau peuvent survenir.Solution : utilisez des webhooks pour confirmer le paiement. Si le paiement n’est pas confirmé après quelques minutes, le client devra peut-être réessayer.

​
Pages associées

Payment Methods Overview

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

Checkout Guide

Guide complet d’implémentation de la page de paiement.

Webhooks

Gérez les confirmations de paiement de manière asynchrone.

Asia-Pacific

GCash (Philippines), Alipay HK et FPS (Hong Kong), ainsi que Touch ‘n Go (Malaisie).

Testing Process

Guide complet des tests pour toutes les méthodes de paiement.
Dernière modification le 26 septembre 2026