Accepter un paiement Alipay
Découvrez comment accepter des paiements par Alipay, un portefeuille électronique très répandu en Chine.
Alipay est un moyen de paiement à usage unique qui nécessite l’authentification du paiement par le client. Pour effectuer un paiement, les clients sont redirigés depuis votre site Web ou application, autorisent le paiement via Alipay, puis reviennent vers votre site Web ou application. Vous recevez alors une notification immédiate indiquant si le paiement a abouti ou échoué.
Configurer StripeCôté clientCôté serveur
Pour commencer, il vous faut un compte Stripe. Créez votre compte Stripe.
Côté serveur
Pour cette intégration, votre serveur doit être doté d’endpoints qui communiquent avec l’API Stripe. Utilisez nos bibliothèques officielles pour accéder à l’API Stripe depuis votre serveur :
Côté client
Le SDK iOS de Stripe est disponible en open source et fait l’objet d’une documentation complète. Il est également compatible avec les applications prenant en charge iOS 13 et les versions ultérieures.
Remarque
Pour obtenir de plus amples informations sur la version la plus récente du SDK et ses versions antérieures, consultez la page des versions sur GitHub. Pour recevoir une notification lors de la publication d’une nouvelle version, surveillez les versions à partir du référentiel.
Configurez le SDK avec votre clé publiable Stripe au démarrage de votre application. Cela lui permet d’envoyer des requêtes à l’API Stripe.
Remarque
Utilisez vos clés de test lors de vos activités de test et de développement et vos clés du mode production pour la publication de votre application.
Créer un PaymentIntentCôté serveur
Un PaymentIntent est un objet qui représente votre intention d’encaisser un paiement auprès de votre client et suit le cycle de vie du processus de paiement. Créez un PaymentIntent
sur votre serveur et précisez le montant à encaisser ainsi qu’une devise prise en charge. Si vous avez une intégration Payment Intents existante, ajoutez alipay
à la liste des types de moyens de paiement.
Rediriger l'utilisateur vers le portefeuille AlipayCôté client
Définissez un schéma d’URL personnalisé pour votre application depuis l’onglet Informations des paramètres cibles de votre application.

L’application Alipay ouvre cette URL pour revenir vers votre application une fois que le client a effectué son paiement. Transférez cette URL au SDK Stripe dans votre UISceneDelegate
ou votre UIApplicationDelegate
:
Lorsque le client appuie sur le bouton permettant de payer avec Alipay, confirmez le PaymentIntent à l’aide de STPPaymentHandler confirmPayment. Cela déclenchera le lancement de l’application Alipay ou l’affichage d’une vue Web si l’application Alipay n’est pas installée.
Alipay ouvre l’URL de redirection avec safepay/
comme hôte. Par exemple si votre schéma d’URL personnalisé est myapp
, votre URL de redirection devra être myapp://safepay/
.
Devises prises en charge
Vous pouvez créer des paiements Alipay dans les devises correspondant à votre pays. La devise locale par défaut pour Alipay est le cny
. Les clients voient également le montant de leurs achats s’afficher en cny
.
Devise | Pays |
---|---|
cny | Tous les pays |
aud | Australie |
cad | Canada |
eur | Allemagne, Autriche, Belgique, Bulgarie, Chypre, Danemark, Espagne, Estonie, Finlande, France, Grèce, Irlande, Italie, Lettonie, Lituanie, Luxembourg, Malte, Norvège, Pays-Bas, Portugal, République tchèque, Roumanie, Slovaquie, Slovénie, Suède, Suisse |
gbp | Royaume-Uni |
hkd | Hong Kong |
jpy | Japon |
myr | Malaisie |
nzd | Nouvelle-Zélande |
sgd | Singapour |
usd | États-Unis |
Si vous détenez un compte bancaire dans une autre devise et souhaitez créer un paiement Alipay dans cette devise, veuillez contacter le service Support. Les devises supplémentaires sont prises en charge au cas par cas.