- Directives d'intégration
- Fonctionnalités prises en charge (Modes de paiement)
- Mise en œuvre d'une intégration des paiements avec redirection
- Paiements WeChat Pay
WeChat Pay
WeChat Pay est un système de paiement pour commerce électronique utilisé en Chine qui permet aux payeurs d'effectuer des achats en utilisant les virements en ligne directs à partir de leur compte WeChat Pay. Les payeurs sont redirigés sur leur compte WeChat Pay où ils peuvent initier un paiement instantané.
WeChat Pay est un mode de paiement avec redirection pris en charge sur Mastercard Gateway. Cette page explique les détails de l'intégration spécifique à WeChat Pay. Nous vous recommandons de lire les instructions d'intégration pour les paiements avec redirection avant de créer une intégration WeChat Pay.
Les paiements avec redirection WeChat Pay sont pris en charge pour les transactions libellées en EUR, USD, GBP, CNY et CHF.
Conditions préalables
Pour proposer WeChat Pay comme mode de paiement via Mastercard Gateway :
- vous devez être inscrit auprès de votre prestataire de services de paiement avec redirection.
- votre profil de commerçant sur la passerelle doit être configuré en utilisant les détails de votre compte auprès de votre prestataire de services de paiement avec redirection,
- vous devez disposer d'un compte bancaire dans l'une des devises prise en charge enregistré pour votre compte de commerçant chez votre prestataire de services de paiement avec redirection.
Notez que la passerelle ne prend en charge WeChat Pay que pour les commerçants transfrontaliers, c.-à-d., les commerçants internationaux accédant au marché chinois et aux touristes chinois à l'étranger qui souhaitent payer avec WeChat Pay. La passerelle n'autorise pas le traitement en devise locale CNY pour les commerçants domiciliés en Chine.
Dans le cas de commerçants transfrontaliers :
- Le montant de la commande est présenté au payeur (par la passerelle) dans la devise de traitement (par ex., EUR).
- Le payeur est débité par WeChat Pay en CNY et les frais de conversion de devises lui sont facturés.
- Le commerçant réglé par le prestataire de services de paiement avec redirection en EUR.
Intégration WeChat Pay
WeChat Pay via Hosted Checkout sera bientôt disponible. Pour plus d'informations, veuillez contacter votre your payment service provider.
L'intégration Direct Payment vous permet de proposer le mode de paiement WeChat Pay sur votre propre page de paiement.
En plus des champs standard requis dans une demande de paiement avec redirection, vous devez renseigner les champs suivants dans la demande Initiate Browser Payment (Lancer un paiement avec redirection) :
sourceOfFunds.type=WECHAT_PAYbrowserPayment.operation=PAY(l'opération Authorize (Autoriser) n'est pas prise en charge par WeChat Pay)sourceOfFunds.provided.weChatPay.accountHolder: nom du titulaire du compte bancaire pour le compte WeChat Pay du payeur.
Langue préférée
Vous pouvez définir la langue que vous préférez que WeChat Pay utilise pour les pages affichées au payeur en renseignant le champ browserPayment.preferredLanguage dans la demande Initiate Browser Payment (Lancer un paiement avec redirection). Toutefois, la langue n'est utilisée que si WeChat Pay la prend en charge.
{
"apiOperation":"INITIATE_BROWSER_PAYMENT",
"browserPayment":{
"operation":"PAY",
"returnUrl":"https://<return_url>"
},
"order": {
"amount": "10.00",
"currency": "EUR"
},
"sourceOfFunds": {
"type": "WECHAT_PAY",
"provided": {
"weChatPay": {
"accountHolder": "John Smith"
}
}
}
}
Comment interpréter le résultat de la transaction
Le tableau ci-dessous illustre les codes de réponse de transaction pour les scénarios possibles auxquels vous pouvez devoir faire face après avoir initié un paiement WeChat Pay.
Réponse Initiate Browser Payment (Lancer un paiement avec redirection) |
Qu'est-ce que cela signifie ? |
|---|---|
response.gatewayCode=SUBMITTEDresult=SUCCESS |
Redirigez le payeur en utilisant l'URL indiquée dans la réponse. |
Réponse Retrieve Transaction/Retrieve Order (Extraire une transaction/Extraire une commande) |
Qu'est-ce que cela signifie ? |
response.gatewayCode=APPROVEDresult=SUCCESSsourceOfFunds.provided.weChatPay.accountHolder
|
Le paiement a réussi. |
response.gatewayCode=PENDINGresult=PENDING |
Mastercard Gateway attend une notification de l'acquéreur à propos du résultat du paiement. Réessayez la transaction RETRIEVE_TRANSACTION ou surveillez les notifications de Mastercard Gateway. |
response.gatewayCode=CANCELLEDresult=FAILURE |
Le payeur a annulé l'interaction pour ce paiement. Proposez au payeur d'essayer un autre mode de paiement. |
response.gatewayCode=DECLINED or ACQUIRER_SYSTEM_ERRORresult=FAILURE |
Le paiement a été refusé. Proposez au payeur d'essayer un autre mode de paiement. Dans le cas d'une erreur ACQUIRER_SYSTEM_ERROR, vous pouvez vouloir demander à l'acquéreur la raison de l'échec du paiement, ou vous pouvez réessayer la transaction RETRIEVE_TRANSACTION. |
response.gatewayCode=TIMED_OUTresult=FAILURE |
Traitez cela comme un paiement refusé. Mastercard Gateway vérifiera que la transaction a échoué ou l'annulera. |
Remboursements
Vous pouvez rembourser les paiements WeChat Pay en partie ou en totalité. Les remboursements doivent être configurés pour vous sur Mastercard Gateway et sur votre compte de commerçant au niveau de votre prestataire de services de paiement avec redirection.
Test de votre intégration
Mastercard Gateway propose un émulateur de paiements avec redirection qui vous permet de tester votre intégration WeChat Pay.