WeChat Pay
Introduction
WeChat Pay est une fonctionnalité de paiement chinoise intégrée dans l'application WeChat. Plus de 900 millions de clients l'utilisent au moins une fois par mois pour des paiements rapides et faciles depuis leur smartphone. Vos clients paient en CNY, mais vous recevrez le remise (en paiement) dans votre devise locale.
L'intégration est très simple et permet à vos clients de payer rapidement : vous envoyez une demande standard à notre plateforme pour rediriger vos clients vers le portail WeChat, lançant leur application mobile pour confirmer le paiement.
Vos clients ont besoin d'un portefeuille dans l'application WeChat lié à un compte bancaire chinois.
Pays & devises
Pays pris en charge
-
Australie
-
Autriche
-
Belgique
-
Bulgarie
-
Croatie
-
Chypre
-
République tchèque
-
Danemark
-
Estonie
-
Finlande
-
France
-
Allemagne
Grèce
Hongrie
Islande
Irlande
Italie
Lettonie
Liechtenstein
Lituanie
Luxembourg
Malte
Pays-Bas
Norvège
Pologne
Portugal
Roumanie
Slovaquie
Slovénie
Espagne
Suède
Suisse
Royaume-Uni
Devises prises en charge
- Australian dollar (AUD)
- Czech koruna (CZK)
- Danish krone (DKK)
- Euro (EUR)
- Norwegian krone (NOK)
- Pound sterling (GBP)
- Swedish krona/kronor (SEK)
- Swiss franc (CHF)
- United States dollar (USD)
Intégration
Nous proposons ces méthodes de paiement pour les modes d'intégration suivants. Apprenez dans nos guides dédiés les spécificités de chacun :
Trouvez un aperçu général dans le chapitre "Cinématique".
En fonction du mode d'intégration, des différences s'appliquent :
Hosted Checkout Page
Ajoutez les propriétés suivantes à une requête CreateHostedCheckout :
{
""order"": {
""amountOfMoney"": {
""currencyCode"": ""EUR"",
""amount"": 1200
}
},
""hostedCheckoutSpecificInput"": {
""locale"": ""fr_FR"",
""returnUrl"": ""https://yourReturnUrl.com""
},
""redirectPaymentMethodSpecificInput"": {
""PaymentProductId"": 5404
}
}
| Propriétés | Remarques |
|---|---|
|
order.amountOfMoney |
amount: Le montant brut que vous souhaitez facturer pour cette commande. |
|
hostedCheckoutSpecificInput |
returnURL: L'URL vers laquelle nous redirigeons vos clients après que le paiement a été finalisé. locale: La version linguistique de notre Hosted Checkout Page. |
|
redirectPaymentMethodSpecificInput.paymentProductId |
L'identifiant numérique de la méthode de paiement sur notre plateforme. Trouvez cet identifiant dans l'onglet "Aperçu". Il indique à notre plateforme d'envoyer vos clients directement au portail WeChat Pay. En cas d'omission, notre plateforme redirige vos clients vers la Hosted Checkout Page, leur permettant de choisir ce mode de paiement ou tout autre actif dans votre compte. |
Retrouvez des informations détaillées sur cet objet et ses propriétés dans notre documentation CreateHostedCheckoutAPI.
Server-to-server
Ajoutez les propriétés suivantes à une requête CreatePayment :
{
""Order"":{
""AmountOfMoney"":{
""Amount"":1200,
""CurrencyCode"":""EUR""
},
""Customer"":{
""Device"":{
""IpAddress"":""217.149.44.205"",
""UserAgent"":""Mozilla/5.0 (Linux; Android 4.4.4; MX4 Pro Build/KTU84P) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/33.0.0.0 Mobile Safari/537.36; 360 Aphone Browser (6.9.7)""
}
},
""References"":{
""MerchantReference"":""mr_638143243872475406""
}
},
""RedirectPaymentMethodSpecificInput"":{
""PaymentProductId"":5404,
""redirectionData"":{
""returnURL"":""https://yourReturnUrl.com""
}
}
}
| Propriétés | Remarques |
|---|---|
|
order.amountOfMoney |
amount: Le montant brut que vous souhaitez facturer pour cette commande. |
|
customer.device |
ipAdress: L'adresse IP de vos clients. userAgent: L'appareil utilisé par vos clients pour la transaction. Obligatoire pour le flux ""Avec un appareil mobile"" pour garantir que notre plateforme renvoie un merchantAction.showFormData.paymentProduct5404.appSwitchLink pour ouvrir l'application WeChat Pay sur l'appareil de vos clients. Si omis, notre plateforme renverra un merchantAction.showFormData.paymentProduct5404.qrCodeUrl à la place pour le flux ""Avec un Desktop et un appareil mobile"". |
|
redirectPaymentMethodSpecificInput |
paymentProductId: L'identifiant numérique de la méthode de paiement sur notre plateforme. Trouvez cet identifiant dans l'onglet "Aperçu". returnURL: L'URL vers laquelle nous redirigeons vos clients après que le paiement a été finalisé. |
|
order.customer.contactDetails.emailAddress |
L'adresse e-mail de votre client. |
Trouvez des informations détaillées sur cet objet et ses propriétés dans notre CreatePaymentAPI.
Cinématique
En fonction des appareils utilisés par vos clients, des différences s'appliquent :
Avec un ordinateur et un appareil mobile
Ce flux implique l'interaction de l'appareil mobile/tablette et de l'ordinateur de vos clients.
- Vos clients finalisent une commande dans votre boutique et sélectionnent WeChat Pay.
- Vous envoyez cette requête CreateHostedCheckout/CreatePayment à notre plateforme. En fonction de votre mode d'intégration, des différences s'appliquent. Consultez le chapitre "Intégration" pour trouver des exemples pour chaque mode.
- Vous redirigez vos clients via le redirectUrl vers le portail WeChat Pay (pour les demandes CreateHostedCheckout) ou affichez un code QR sur votre page de paiement en utilisant le merchantAction.showFormData.paymentProduct5404.qrCodeUrl de notre réponse (pour les demandes CreatePayment).
- Vos clients scannent le code QR avec leur appareil mobile/tablette.
- L'appareil mobile/tablette ouvre l'application WeChat Pay. Vos clients confirment le paiement dans l'application.
- Nous recevons le résultat de la transaction.
- L'appareil mobile/tablette affiche le résultat de la transaction dans l'application WeChat Pay. Nous redirigeons vos clients vers votre returnURL sur leur appareil de Desktop.
- Vous demandez le résultat de la transaction à notre plateforme via GetPaymentDetails/GetHostedCheckout ou recevez le résultat via webhooks.
- Si la transaction a été réussie, vous pouvez livrer les biens/services.
Avec un appareil mobile
Ce flux implique uniquement l'appareil mobile de vos clients.
- Vos clients finalisent une commande dans votre boutique et sélectionnent WeChat Pay.
- Vous envoyez cette requête CreateHostedCheckout/CreatePayment à notre plateforme. En fonction de votre mode d'intégration, des différences s'appliquent. Consultez le chapitre "Intégration" pour trouver des exemples pour chaque mode.
- Vous redirigez vos clients via le redirectUrl (pour les demandes CreateHostedCheckout) ou le merchantAction.showFormData.paymentProduct5404.appSwitchLink (pour les demandes CreatePayment). L'appareil mobile/tablette ouvre l'application WeChat Pay.
- Vos clients choisissent leur portefeuille et confirment le paiement dans l'application.
- Nous recevons le résultat de la transaction.
- L'appareil mobile/tablette affiche le résultat de la transaction dans l'application WeChat Pay.
- Vous demandez le résultat de la transaction à notre plateforme via GetPaymentDetails/GetHostedCheckout ou recevez le résultat via webhooks.
- Si la transaction a été réussie, vous pouvez livrer les biens/services.
Test
Consultez nos Cas de test pour des données de test et des instructions détaillées.
Assurez-vous d'utiliser le bon endpoint et de renseigner l'URL de production dès que vous avez terminé vos tests.