Skip to main content
Utilisez Checkout.ApplePayButton pour accepter des paiements ponctuels pour des biens physiques ou des services réels avec Apple Pay. Whop traite les paiements à 2,7 % + 0,30 $ au lieu des frais d’achat intégré de 15 à 30 % d’Apple.
Pour les ventes sur le web, utilisez les liens de checkout ou l’élément Checkout pour bénéficier de plus de 100 moyens de paiement dans 195 pays.
Apple Pay n’est pas destiné au contenu numérique. N’utilisez Checkout.ApplePayButton que si votre app vend des biens physiques (merch, nourriture, matériel) ou des services réels (billets d’événements, livraisons). Les apps qui vendent du contenu numérique (fonctionnalités premium, abonnements, monnaie intégrée, déblocage de contenu) doivent utiliser StoreKit. Consultez la section Éligibilité à Apple Pay pour plus de détails.

Ce que vous allez créer

  • Un écran de détail produit avec un bouton Apple Pay natif
  • Un parcours d’achat qui gère la réussite, l’échec et l’annulation
  • La configuration des variantes dans le tableau de bord Whop pour vos biens physiques

Prérequis

Étape 1 : configurer le SDK

Initialisez le SDK au lancement de l’app. Pour des biens physiques ponctuels, vous n’avez pas besoin de la propriété de compatibilité planMappings : elle ne sert qu’au repli sur StoreKit pour les abonnements.
Consultez le guide d’installation pour la configuration complète et les remarques de sécurité concernant la clé API.

Étape 2 : ajouter le bouton Apple Pay

Placez Checkout.ApplePayButton dans la vue de votre produit. Le composant affiche le bouton Apple Pay officiel d’Apple, conforme aux Human Interface Guidelines : vous ne pouvez pas le remplacer par un bouton au style personnalisé.
Lorsque l’utilisateur appuie dessus, la feuille Apple Pay native s’affiche. Face ID ou un double-clic confirme, et le paiement transite par Whop.
onCompletion n’est pas appelé lorsque l’utilisateur annule : la feuille se ferme simplement. Aucun nettoyage n’est nécessaire.

Étape 3 : choisir un libellé de bouton

Le paramètre label contrôle le texte du bouton. Choisissez celui qui correspond à l’action : La liste complète provient de PayWithApplePayButtonLabel d’Apple : consultez la documentation d’Apple pour connaître toutes les options.

Étape 4 : gérer le résultat de l’achat

onCompletion reçoit un Result<CheckoutPurchaseResult, Error>. En cas de réussite, vous récupérez : Utilisez-le pour afficher un écran de confirmation, lancer l’expédition ou conserver le reçu dans vos propres registres.

Étape 5 : configurer votre variante

Chaque article achetable nécessite une variante dans votre tableau de bord Whop :
1

Créer une variante

Accédez à votre tableau de bord > Products > sélectionnez votre produit > Variants > Create variant.
2

La définir comme ponctuelle

Choisissez One-time payment et définissez le prix.
3

(Facultatif) Définir des limites de stock

Pour les éditions limitées, définissez un plafond de stock. Le checkout l’applique automatiquement : lorsque le stock est épuisé, les achats s’arrêtent.
4

Copier l'ID de la variante

L’ID conserve le préfixe plan_. Transmettez-le via le paramètre de compatibilité Checkout.ApplePayButton(planId:).

Gérer le traitement des commandes avec les webhooks

Pour les biens physiques, vous aurez besoin d’un webhook côté serveur pour déclencher l’expédition après un achat réussi. Écoutez l’événement payment.succeeded :
Le callback onCompletion côté client confirme le paiement à l’utilisateur, mais c’est votre serveur qui doit traiter la commande via les webhooks : ne vous fiez pas uniquement au client. Consultez le guide des webhooks complet pour la configuration.

Exemple complet

Une vue minimale de détail d’article avec sélection de taille et Apple Pay :

Prochaines étapes

Webhooks

Gérez les événements de paiement et déclenchez le traitement des commandes

Éligibilité à Apple Pay

Vérifiez que votre app est éligible selon les App Store Review Guidelines

Créer un paywall

Vendez des abonnements plutôt que des achats ponctuels

Référence de l'API

Documentation complète du SDK