Découvrez Alipay, un portefeuille numérique populaire auprès des clients chinois. #
Alipay est un portefeuille numérique chinois qui compte plus d'un milliard d'utilisateurs actifs dans le monde. Les utilisateurs d'Alipay peuvent payer sur le web ou sur un appareil mobile en utilisant leurs identifiants de connexion ou leur application Alipay. Alipay a un faible taux de litige et réduit la fraude en authentifiant les paiements à l'aide des identifiants de connexion du client.
Caractéristiques #
Localisation des clients | Consommateurs chinois Chinois d'outre-mer Voyageurs chinois |
---|---|
Traitement des devises | CNY, GBP, USD, EUR, HKD |
Devises de règlement | GBP,HKD,EUR |
Montant minimum de la transaction | 0,01 CNY |
Montant maximum de la transaction | Aucune limite |
Remboursements | ✅ |
Remboursements partiels | ✅ |
Remboursement partiel multiple | ❌ |
Répétition de la dette | ❌ |
Catégories d'entreprises interdites Tant WooshPay qu'Alipay Plus tiennent une liste des entreprises interdites qui ne sont pas autorisées à utiliser leurs services. Pour utiliser Alipay Plus sur WooshPay, votre entreprise ne doit pas faire l'objet d'une restriction d'utilisation ni figurer sur la liste des entreprises interdites d'Alipay. Si vous ne savez pas si votre entreprise fait partie des entreprises interdites ou si vous avez des questions sur la manière dont ces exigences s'appliquent à vous, veuillez contacter support@wooshpay.com.
Sous-produits #
Produit | Description des scénarios de paiement |
---|---|
Paiement par Internet | Sur le navigateur de bureau, après avoir sélectionné Alipay comme méthode de paiement, un code QR apparaît. L'acheteur ouvre alors l'application Alipay sur son téléphone portable et scanne le code-barres affiché sur la page du navigateur pour effectuer le paiement. |
Paiement APP | Sur le navigateur mobile, l'acheteur sélectionne Alipay comme méthode de paiement à la caisse du commerçant et est redirigé du navigateur vers l'application Alipay pour effectuer le paiement avant d'être redirigé vers le navigateur du commerçant. |
Flux de paiement #
Paiement par Internet #
Paiement APP #
Méthode d'intégration #
Valeurs de l'énumération des méthodes de paiement : alipay
Il existe deux méthodes d'intégration pour Alipay
- API directe
- Sortie de caisse
Méthode d'intégration | scénarios de paiement | Valeurs de l'énumération terminal_type |
---|---|---|
API directe | Paiement par Internet | WEB |
API directe | Paiement APP | APP |
Sortie de caisse | Paiement par Internet | Il n'est pas nécessaire d'identifier le type_de_terminal à la caisse. La caisse génère automatiquement un code QR ou redirige vers l'application Alipay en fonction de l'appareil du client. |
Sortie de caisse | Paiement APP | Il n'est pas nécessaire d'identifier le type_de_terminal à la caisse. La caisse génère automatiquement un code QR ou redirige vers l'application Alipay en fonction de l'appareil du client. |
API directe #
Un PaymentIntent est un objet qui représente votre intention de percevoir un paiement de la part de votre client et qui suit le cycle de vie du processus de paiement. Créez un PaymentIntent sur votre serveur et indiquez le montant à encaisser ainsi qu'une devise prise en charge.
Créer un PaymentIntent #
Pour une intégration API directe, vous pouvez créer un PaymentIntent et obtenir l'url en une seule étape. Voici une démonstration de la création d'intentions de paiement :
- Paiement par Internet
- Paiement APP
Vous pouvez contrôler les scénarios de paiement générés dans Payment Intent en modifiant les valeurs d'énumération du type de terminal:.options_méthode_de_paiement.alipay.type_de_terminal
Paiement par Internet #
Demande
{
"montant" : 20,
"devise" : "CNY",
"confirm" : true,
"payment_method_options" : {
"alipay" : {
"client_ip" : "192.168.0.1",
"terminal_type" : "WEB",
"os_type" : "IOS"
}
},
"payment_method_data" : {
"type" : "alipay"
},
"payment_method_types" : [
"alipay"
],
"return_url" : "https://wooshpay.com"
}
Réponse
{
"id" : "pi_1666729870215872512",
"object" : "payment_intent",
"created" : 1686214342000,
"currency" : "CNY",
"amount" : 20,
"status" : "requires_action",
"livemode" : true,
"client_secret": "pi_1666729870215872512_secret_jmGL6NBNInPx5zdjIJ2utli4",
"next_action" : {
"type" : "redirect_to_url",
"alipay_handle_redirect" : {
"url" : "https://open-sea.alipayplus.com/api/open/v1/ac/cashier/self/codevalue/checkout.htm?codeValue=28166604009zSv0130nTr0bKfhzSwT08YvSW"
}
},
"payment_method_types" : [
"alipay"
],
"confirmation_method" : "automatique",
"payment_method_options" : {
"alipay" : {
"terminal_type" : "WEB",
"os_type" : "IOS",
"client_ip" : "192.168.0.1"
}
},
"return_url" : "https://wooshpay.com",
"payment_method" : "pm_1666729870102626304",
"capture_method" : "automatic"
}
Le url
à partir de next_action peut être ouvert, à partir du lien, le client sera redirigé vers la page de paiement d'Alipay. Le client peut scanner le code QR ou se connecter au portefeuille pour payer.
Paiement APP #
Demande
{
"montant" : 20,
"devise" : "CNY",
"confirm" : true,
"payment_method_options" : {
"alipay" : {
"client_ip" : "192.168.0.1",
"terminal_type" : "APP",
"os_type" : "IOS"
}
},
"payment_method_data" : {
"type" : "alipay"
},
"payment_method_types" : [
"alipay"
],
"return_url" : "https://wooshpay.com"
}
Réponse
{
"id": "pi_1666732544285999104",
"object": "payment_intent",
"created": 1686214980000,
"currency": "CNY",
"amount": 20,
"status": "requires_action",
"livemode": true,
"client_secret": "pi_1666732544285999104_secret_NRUV59FL6qtFyz2bXVeDyLD4",
"next_action": {
"type": "redirect_to_url",
"alipay_handle_redirect": {
"url": "https://render.alipay.com/p/s/i/?scheme=alipays%3A%2F%2Fplatformapi%2FstartApp%3FappId%3D10000007%26actionType%3Droute%26qrcode%3D281666040092tD6e6GlEzzTlQl6HrEqv3kOI%26externalThrough%3D%257B%2522acTerminalType%2522%253A%2522WAP%2522%257D"
}
},
"payment_method_types": [
"alipay"
],
"confirmation_method": "automatic",
"payment_method_options": {
"alipay": {
"terminal_type": "APP",
"os_type": "IOS",
"client_ip": "192.168.0.1"
}
},
"return_url": "https://wooshpay.com",
"payment_method": "pm_1666732544155975680",
"capture_method": "automatic"
}
Sortie de caisse #
Pour prendre en charge les paiements Alipay, une session de paiement doit remplir toutes les conditions suivantes :
- Les prix de tous les articles doivent être exprimés dans la même devise. Si les articles sont libellés dans des devises différentes, créez des sessions de paiement distinctes pour chaque devise.
- Vous ne pouvez utiliser que des postes uniques.
Activer Alipay comme méthode de paiement
Lors de la création d'une nouvelle session de paiement, vous devez.. :
Ajouter Alipayplus à la liste des types_méthodes_de_paiement
. Assurez-vous que tous les articles_de_ligne
utilisent la même monnaie.
Créer une session #
Il n'est pas nécessaire d'identifier le type_de_terminal lorsque vous créez une session de paiement. Le paiement générera automatiquement un code QR ou redirigera vers l'application Alipay en fonction de l'appareil de l'utilisateur.
Demande
{
"cancel_url" : "www.baidu.com",
"mode" : "paiement",
"success_url" : "https://wooshpay.com/",
"payment_method_types" : [
"alipay"
],
"line_items" : [
{
"price_data" : {
"currency" : "CNY",
"unit_amount" : 100000,
"active" : true,
"product_data" : {
"name" : "taiwan fengli"
},
"billing_scheme" : "testcheme",
"lookup_key" : "test_lookup_key"
},
"quantity" : 1
}
]
}
Réponse
{
"id" : "cs_1666733999608823808",
"object" : "checkout.session",
"created" : 1686215327000,
"currency" : "CNY",
"client" : "",
"mode" : "paiement",
"livemode" : true,
"status" : "ouvert",
"url" : "https://checkout.wooshpay.com/pay/cs_1666733999608823808?key=pk_live_dGVzdDpKeEQzUXhpWDJyYkFRZEo1QWtWN0dHUFo=",
"cancel_url" : "www.baidu.com",
"line_items" : {
"object" : "liste",
"data" : [
{
"id" : "li_1666733999642378240",
"object" : "item",
"currency" : "CNY",
"description" : "fengli de Taïwan",
"prix" : {
"id" : "price_1666733999659155456",
"objet" : "prix",
"created" : 1686215327000,
"active" : true,
"currency" : "CNY",
"produit" : {
"id" : "prod_1666733999675932672",
"objet" : "produit",
"created" : 1686215327000,
"active" : true,
"name" : "taiwan fengli",
"livemode" : true,
"updated" : 1686215327000
},
"type" : "one_time",
"livemode" : true,
"unit_amount" : 100000,
"billing_scheme" : "per_unit",
"lookup_key" : "test_lookup_key"
},
"quantity" : 1,
"amount_subtotal" : 100000,
"montant_total" : 100000
}
]
},
"payment_intent" : "pi_1666733999864676352",
"payment_method_types" : [
"alipay"
],
"payment_status" : "non payé",
"success_url" : "https://wooshpay.com/",
"amount_subtotal" : 100000,
"amount_total" : 100000,
"billing_address_collection" : "auto",
"expires_at" : 1686301726587,
"payment_link" : "",
"client_secret": "pi_1666733999864676352_secret_5S1FMaseZU6gfIZjl2QlOdY7"
}
Le url
à partir de next_action peut être ouvert, à partir du lien, le client sera redirigé vers la page de paiement d'Alipay. Le client peut scanner le code QR ou se connecter au portefeuille pour payer.
Prochaine étape #
Vous pouvez ajouter d'autres fonctionnalités à votre intégration en fonction de vos besoins.
Créer un Webhook #
Écoutez les événements sur votre compte WooshPay afin que votre intégration puisse déclencher automatiquement des réactions. Créez un webhook qui se concentre principalement sur enabled_events et url.
Créer un remboursement #
Créez un remboursement pour restituer des fonds à votre client. Vous pouvez également effectuer des remboursements partiels, mais ils ne sont pas pris en charge par toutes les méthodes de paiement. Un remboursement partiel consiste à ne rembourser qu'une partie du montant de la transaction initiale.