Accepter des paiements pour des biens numériques sur iOS à l'aide de Payment Links

Les liens universels permettent aux liens de paiement d’établir un lien profond vers votre application après un paiement réussi. Pour configurer un lien universel :

1. Ajoutez un fichier apple-app-site-association à votre domaine.
2. Ajoutez un droit de domaine associé à votre application.
3. Ajoutez une page de renvoi pour vos URL de redirection Checkout.

Définissez les domaines associés

Ajoutez un fichier à votre domaine sur .well-known/apple-app-site-association pour définir les URL que votre application peut gérer. Ajoutez l’ID d’application avec votre ID d’équipe que vous pourrez trouver sur la page d’abonnement du portail développeur d’Apple.

{
  "applinks": {

      "apps": [],
      "details": [
           {
             "appIDs": [ "A28BC3DEF9.com.example.MyApp1",
                         "A28BC3DEF9.com.example.MyApp1-Debug" ],
             "components": [
               {
                  "/": "/checkout_redirect*",
                  "comment": "Matches any URL whose path starts with /checkout_redirect"
               }
             ]
           }
       ]
   }
}

curl -I https://example.com/.well-known/apple-app-site-association

Pour en savoir plus, consultez la page d’Apple relative aux domaines associés pris en charge.

Ajouter un droit de domaine associé à votre application

1. Ouvrez le volet Signatures et fonctionnalités de la cible de votre application.
2. Cliquez sur + Fonctionnalité, puis sélectionnez Domaines associés.
3. Ajoutez une entrée pour applinks:example.com à la liste Domaines associés.

Pour en savoir davantage sur les liens universels, consultez la documentation d’Apple sur les liens universels.

Bien qu’iOS intercepte les liens vers les URL définies dans votre fichier apple-app-site-association, il se peut que la redirection ne parvienne pas à ouvrir votre application.

Payment Links prend en charge les paiements par carte et Apple Pay par défaut. Vous pouvez activer d’autres moyens de paiement depuis le Dashboard.

Les paramètres d’URL vous permettent d’ajouter du contexte supplémentaire à votre page de paiement pour simplifier le processus de paiement. Vous pouvez utiliser des paramètres d’URL pour ajuster la langue de la page de paiement, saisir automatiquement une adresse e-mail ou un code promotionnel, ou joindre des métadonnées pertinentes pour faciliter le rapprochement.

Nous vous recommandons d’utiliser prefilled_email et client_reference_id pour simplifier le paiement et faciliter le rapprochement.

Voici un exemple de lien avec prefilled_email et client_reference_id :

https://buy.stripe.com/test_eVa3do41l4Ye6KkcMN?prefilled_email=jenny%40example.com&client_reference_id=id_123

Ajoutez un bouton de paiement à votre application. Ce bouton :

• Votre lien de paiement est prérempli avec prefilled_email et client_reference_id.
• Ouvre la page de paiement hébergée par Stripe dans Safari.

Une fois l’achat effectué, Stripe vous envoie un webhook checkout.session.completed. Dans la charge utile de l’événement webhook, vous trouverez le client_reference_id sous checkout.session object, que vous pouvez utiliser pour votre logique métier, par exemple pour associer le paiement à une commande ou à un utilisateur spécifique dans votre système.

Pour tester votre intégration, vous pouvez surveiller les événements dans le Dashboard ou utiliser l’interface de ligne de commande Stripe. En production, configurez un endpoint de webhook et abonnez-vous aux types d’événements pertinents. Si vous ne connaissez pas votre clé STRIPE_WEBHOOK_SECRET, cliquez sur le webhook dans le Dashboard pour l’afficher.

Tests

Pour tester le bon fonctionnement de votre bouton de paiement, procédez comme suit :

1. Cliquez sur le bouton de paiement qui vous redirige vers le formulaire de paiement Stripe Checkout.
2. Saisissez le numéro de carte de test 4242424242424242
   , un code CVC à trois chiffres, une date d’expiration et un code postal valide.
3. Appuyez sur Payer.
4. Le webhook checkout.session.completed s’active et Stripe notifie votre serveur de la transaction. Vous êtes redirigé(e) vers votre application.