Alipay Plus Payments #
Alipay Plus est un portefeuille numérique chinois qui sert les clients d'Asie du Sud-Est et de Chine. Les utilisateurs d'Alipay Plus peuvent payer sur le web ou sur un appareil mobile en utilisant leurs identifiants de connexion ou une application spécifique prise en charge par Alipay Plus.
Caractéristiques #
Localisation des clients
- Consommateurs chinois
- Chinois d'outre-mer
- Voyageurs chinois
- Consommateurs d'Asie du Sud-Est
Monnaie de présentation
CNY, HKD, GBP, IDR, MYR, PHP, THB
Liste des portefeuilles
- AlipayHK
- DANA
- TNG
- ICPE
- Rabbit LINE Pay
- GCash
- Boost
- Akulaku PayLater
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 être interdite d'utilisation de Stripe ou figurer sur la liste des entreprises interdites d'Alipay. Si vous n'êtes pas sûr que votre entreprise soit une entreprise interdite, ou si vous avez des questions sur la manière dont ces exigences s'appliquent à vous, veuillez contacter [email protected].
Intégration serveur à serveur #
En utilisant Alipay Plus, les clients paient en se redirigeant depuis votre site web ou votre application, autorisent le paiement via différents portefeuilles, puis retournent sur votre site web ou votre application où vous recevez une notification immédiate indiquant si le paiement a réussi ou échoué.
Vue d'ensemble #
Pour l'intégration directe de l'API, vous pouvez créer des intentions de paiement et obtenir l'url en une seule étape, voici la démonstration de la création d'intentions de paiement :
- Créer une intention de paiement
- Remboursement
- Crochet Web
1. Créer un PaymentIntent #
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 à collecter ainsi qu'une devise prise en charge. Si vous avez déjà intégré PaymentIntent, ajoutez alipayplus à la liste des types de méthodes de paiement.
Demande Créer un PaymentIntent
{
"montant":200,
"currency" : "IDR", //des devises différentes peuvent donner des portefeuilles différents
"confirm":true,
"payment_method_options":{
"alipayplus":{
"terminal_type" : "WEB"
}
},
"payment_method_data":{
"type" : "alipayplus"
},
"return_url" : "https://wooshpay.com"
}Réponse
{
"id" : "pi_1646355176136638464",
"object" : "payment_intent",
"created" : 1681356636000,
"currency" : "IDR",
"amount" : 200,
"status" : "requires_action",
"livemode" : true,
"client_secret": "pi_1646355176136638464_secret_gxkV1LYb76c2nFvtzDmHevyw",
"next_action" : {
"alipayplus_handle_redirect" : {
"normalUrl" : "https://open-sea.alipayplus.com/api/open/v1/ac/cashier/self/codevalue/checkout.htm?codeValue=281666040092tDht8YNMR2t2u648Mu5v476I"
}
},
"payment_method_types" : [
"alipay",
"wechat_pay",
"card",
"alipayplus"
],
"confirmation_method" : "automatique",
"payment_method_options" : {
"alipayplus" : {
"terminal_type" : "WEB"
}
},
"return_url" : "https://wooshpay.com",
"payment_method" : "pm_1646355176006615040",
"capture_method" : "automatic"
}L'URL normale de action_suivante Le client peut choisir celui qu'il souhaite payer, soit en scannant le code QR, soit en se connectant au portefeuille.
2. Remboursement #
Vous pouvez rembourser partiellement ou totalement tout paiement réussi, en utilisant l'API ou le tableau de bord. Pour afficher une liste de tous vos remboursements, allez à la page Paiements remboursés dans le tableau de bord.
Pour rembourser un paiement à l'aide de l'API, créez un remboursement en fournissant le PaymentIntent.
Demande Créer un remboursement
{
"reason" : "requested_by_customer",
"payment_intent":"pi_1575055712604651520"
}Réponse
{
"id":"re_1575092157281206272",
"objet" : "remboursement",
"created":1664366209000,
"amount":20,
"currency" : "CNY",
"metadata":null,
"reason" : "requested_by_customer",
"status" : "succeeded",
"description":null,
"payment_intent":"pi_1575055712604651520",
"failure_reason":null
}3. Crochet Web #
É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 événements_activés et url.
Etapes pour recevoir un webhook :
- Identifiez les événements que vous souhaitez surveiller et les données utiles à analyser.
- Créez un point de terminaison webhook en tant que point de terminaison HTTP (URL) sur votre serveur local.
- Vérifiez que votre point de terminaison webhook fonctionne correctement et voyez si vous avez reçu un rappel.
Demande
{
"url" : "https://apitest.wooshpay.com/v1/receives",
"description" : "I_am_description",
"enabled_events" :[
"payment_intent.created",
"payment_intent.payment_failed",
"payment_intent.succeeded",
"charge.refund.updated"
],
"api_version":"1.0.1"
}Réponse
{
"id":"we_1575093135514533888",
"object" : "webhook_endpoint",
"created":1664366442000,
"description" : "I_am_description",
"metadata":null,
"status" : "enabled",
"url" : "https://apitest.wooshpay.com/v1/receives",
"livemode":false,
"api_version":"1.0.1",
"enabled_events" :[
"payment_intent.created",
"payment_intent.payment_failed",
"payment_intent.succeeded",
"charge.refund.updated"
]
}Sortie de caisse #
Pour prendre en charge les paiements Alipayplus, une session de paiement doit remplir toutes les conditions suivantes :
- Les prix de tous les postes doivent être exprimés dans la même devise.
Si vous avez des postes dans différentes devises, créez des sessions de paiement distinctes pour chaque devise. - Vous ne pouvez utiliser que des postes uniques.
Activer Alipayplus 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.
Demande Créer une session
{
"cancel_url" : "www.baide.com",
"mode" : "paiement",
"success_url" : "www.wooshpay.com",
"payment_method_options" : { //add alipayplus as payment method
"alipayplus" : {
"terminal_type" : "WEB"
}
},
"line_items" : [
{
"price_data" : {
"currency" : "GBP",
"produit" : null,
"unit_amount" : 5,
"active" : true,
"metadata" : {
"key1" : "value1",
"key2" : "valeur2"
},
"pseudo" : "fengli",
"product_data" : {
"id" : null,
"name" : "taiwan fengli",
"active" : true,
"description" : "très délicieux",
"metadata" : {
"key1" : "value1",
"key2" : "valeur2"
},
"url" : "www.baidu.com"
},
"billing_scheme" : "testscheme",
"lookup_key" : "test_lookup_key"
},
"quantity" : 1
}
]
}Réponse
{
"id" : "cs_1597163428114333696",
"object" : "checkout.session",
"created" : 1669628410000,
"currency" : "GBP",
"client" : "",
"mode" : "paiement",
"livemode" : true,
"shipping" : null,
"status" : "ouvert",
"url" : "https://checkout.wooshpay.com/pay/cs_1597163428114333696?key=pk_live_dGVzdDpKeEQzUXhpWDJyYkFRZEo1QWtWN0dHUFo=",
"cancel_url" : "www.baidu.com",
"client_reference_id" : null,
"customer_email" : null,
"line_items" : {
"object" : "liste",
"data" : [
{
"id" : "li_1597163428139499520",
"object" : "item",
"devise" : "GBP",
"description" : "taiwan fengli",
"prix" : {
"id" : "price_1597163428152082432",
"objet" : "prix",
"created" : 1669628410000,
"active" : true,
"currency" : "GBP",
"metadata" : {
"key1" : "value1",
"key2" : "valeur2"
},
"pseudo" : "fengli",
"produit" : {
"id" : "prod_1597163428164665344",
"objet" : "produit",
"created" : 1669628410000,
"active" : true,
"description" : "très délicieux",
"métadonnées" : {
"key1" : "value1",
"key2" : "valeur2"
},
"name" : "taiwan fengli",
"livemode" : true,
"url" : "www.baidu.com",
"updated" : 1669628410000,
"images" : null
},
"type" : "one_time",
"livemode" : true,
"unit_amount" : 5,
"billing_scheme" : "per_unit",
"lookup_key" : "test_lookup_key"
},
"quantity" : 1,
"amount_subtotal" : 5,
"amount_total" : 5
}
],
"url" : null,
"has_more" : null
},
"payment_intent" : "pi_1597163428336631808",
"payment_method_types" : null,
"payment_status" : "unpaid",
"success_url" : "www.wooshpay.com",
"amount_subtotal" : 5,
"amount_total" : 5,
"billing_address_collection" : "auto",
"expires_at" : 1669714809783,
"payment_link" : "",
"payment_method_options" : null,
"phone_number_collection" : null,
"shipping_address_collection" : null,
"client_secret": "pi_1597163428336631808_secret_pxwFDDYAbSnC99NpAKVwE1Sr"
}L'url dirigera le client vers la page de paiement de WooshPay, le client verra différents portefeuilles en fonction de la devise, et le client pourra choisir celui qu'il souhaite payer, soit en scannant le code QR, soit en se connectant au porte-monnaie.
