- Directives d'intégration
- Fonctionnalités prises en charge (Méthodes de paiement)
- Mise en œuvre d'une intégration des paiement avec redirection
- Paiements Alipay
Intégration Alipay
- Conditions préalables
- Intégration Alipay
- Comment interpréter le résultat de la transaction
- Remboursements de paiements
- Test d'une intégration des paiements avec redirection
- Boleto Bancario
- Giropay
- iDEAL
- Multibanco
- PayPal
- POLi
- SEPA
- Sofortbanking
- UnionPay SecurePay
- WeChat Pay
Paiements Alipay
Alipay est un portefeuille électronique utilisé en Chine qui permet aux clients d'acheter des marchandises en ligne à l'aide de leur solde AliPay ou en sélectionnant une méthode de paiement à partir du portefeuille.
Alipay est une méthode de paiement avec redirection prise en charge sur Mastercard Gateway. Cette page explique les détails de l'intégration spécifique à Alipay. Nous vous recommandons de lire les instructions d'intégration pour les paiements avec redirection avant de créer une intégration Alipay.
Les paiements avec redirection Alipay sont pris en charge pour les transactions libellées en AUD, CAD, EUR, GBP, HKD, SGD, USD, CHF, JPY, NZD et CNY.
Notez que la passerelle ne prend en charge Alipay 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 Alipay. 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 Alipay en CNY et les frais de conversion de devises lui sont facturés.
- Le commerçant réglé par le fournisseur de services de paiements avec redirection en EUR.
Conditions préalables
Pour proposer Alipay comme méthode de paiement via Mastercard Gateway :
- Vous devez être inscrit auprès de votre fournisseur de services de paiements 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 de ces devises prise en charge enregistré pour votre compte de commerçant chez votre fournisseur de services de paiements avec redirection.
Intégration Alipay
Avec les intégrations à compter de la version 51 de Hosted Checkout, Alipay est automatiquement disponible pour vos payeurs lorsque vous êtes activé et configuré pour cela par votre prestataire de services de paiement.
Pour plus d'informations, voir Intégration des paiements avec redirection via Hosted Checkout.
L'intégration Direct Payment vous permet de proposer la méthode de paiement Alipay sur votre propre page de paiement.
Faire une demande Initiate Browser Payment
où sourceOfFunds.type = ALIPAY
et browserPayment.operation = PAY
(l'opération Authorize (Autoriser) n'est pas prise en charge par Alipay). Pour les champs standard, voir Paiements avec redirection via l'intégration Direct Payment.
Langue préférée
Vous pouvez définir la langue que vous préférez que Alipay utilise pour les pages affichées au payeur en renseignant le champ browserPayment.preferredLanguage
dans la demande Initiate Browser Payment (Initialisation du paiement avec redirection). Toutefois, la langue n'est utilisée que si Alipay la prend en charge.
{ "apiOperation":"INITIATE_BROWSER_PAYMENT", "browserPayment":{ "operation":"PAY", "returnUrl":"https://<return_url>" }, "order":{ "amount":"10.00", "currency":"GBP" }, "sourceOfFunds":{"type":"ALIPAY" } }
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 Alipay.
Réponse Initiate Browser Payment (Initier un paiement avec redirection) |
Qu’est-ce que cela signifie ? |
---|---|
response.gatewayCode=SUBMITTED result=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=APPROVED result=SUCCESS |
Le paiement a réussi. |
response.gatewayCode= PENDING result=PENDING |
Mastercard Gateway attend une notification de l'acquéreur à propos du résultat du paiement. Réessayez la transaction RETRIEVE_TRANSACTION plus tard ou surveillez les notifications de la passerelle. |
response.gatewayCode= CANCELLED result=FAILURE |
Le payeur a annulé l'interaction pour ce paiement. Proposez au payeur d'essayer une autre méthode de paiement. |
response.gatewayCode= DECLINED or ACQUIRER_SYSTEM_ERROR result=FAILURE |
Le paiement a été refusé. Proposez au payeur d'essayer une autre méthode 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_OUT result=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 Alipay 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 fournisseur de services de paiements avec redirection.
Test de votre intégration
Mastercard Gateway propose un émulateur de paiements avec redirection qui vous permet de tester votre intégration Alipay.