Alipay

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 clientsConsommateurs chinois
Chinois d'outre-mer
Voyageurs chinois
Traitement des devisesCNY, GBP, USD, EUR, HKD
Devises de règlementGBP,HKD,EUR
Montant minimum de la transaction0,01 CNY
Montant maximum de la transactionAucune 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 #

ProduitDescription des scénarios de paiement
Paiement par InternetSur 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 APPSur 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 #

pic_1.png

Paiement APP #

pic_2.png

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

  1. API directe
  2. Sortie de caisse
Méthode d'intégrationscénarios de paiementValeurs de l'énumération terminal_type
API directePaiement par InternetWEB
API directePaiement APPAPP
Sortie de caissePaiement par InternetIl 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 caissePaiement APPIl 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.

Quels sont vos sentiments ?
Mise à jour le 8 août 2023