Dans ce tutoriel, nous allons voir comment intégrer l'iTunes Store iOS au marché de brainCloud. Ainsi, les utilisateurs iOS pourront acheter des produits iTunes iOS. Le backend brainCloud vérifiera l'achat directement auprès d'iTunes, sécurisant ainsi la transaction pour votre application.
Notez que les applications doivent toujours effectuer l'achat directement sur iTunes. Pour plus d'informations sur ce processus, consultez le Guide de programmation des achats intégrés pour les développeurs Apple.
Flux d'achat
En termes généraux, le flux de transaction d’un achat est le suivant:
L'application demande l'inventaire des produits "iTunes" à brainCloud qui retourne une liste de produits, leurs prix de référence (tels que configurés dans le portail brainCloud) et leurs identifiants iTunes.
Pour les produits iTunes retournés par brainCloud, l'application demande leurs prix réels (dans la devise de l'utilisateur) à iTunes.
L'utilisateur sélectionne un article à acheter.
L'application envoie une requête à iTunes pour ajouter un paiement, ce qui ouvre les boîtes de dialogue d'achat iTunes. iTunes retourne un reçu si l'utilisateur finalise l'achat.
L'application demande à brainCloud de vérifier le reçu iTunes reçu de l'iTunes Store. S'il s'agit d'un reçu valide, brainCloud attribuera les monnaies virtuelles associées à ce produit.
L'application termine la transaction avec iTunes pour signifier que le produit a été attribué.
Configuration du portail
Voici les étapes pour configurer brainCloud pour les achats iTunes.
Prérequis
Vous devriez avoir configuré vos produits sur le marché brainCloud. Veuillez consulter le guide de configuration du marché.
Vous devez avoir créé les produits iTunes In-App conformément à la documentation du développeur Apple
Associer les produits iTunes aux produits brainCloud
Après avoir configuré vos produits sur la marché brainCloud, vous devrez associer les identifiants de produits iTunes. Plus précisément, nous récupérerons les identifiants de produits iTunes et les saisirons dans les produits brainCloud correspondants.
Connectez-vous à iTunes Connect
Sélectionnez votre application dans la liste et accédez à l'onglet "Achats intégrés"
Sélectionnez votre IAP et récupérez l'identifiant du produit Apple
Connectez-vous au portail brainCloud
Accédez à la page "Marketplace | Products" dans l'onglet Design
Sélectionnez le produit que vous souhaitez associer.
Cliquez sur le bouton "+ Modifier le produit"
Trouvez votre prix (ou créez-en un) et cliquez sur l'icône Modifier
Dans la boîte de dialogue Modifier le prix, cliquez sur l'icône + pour ajouter une entrée pour Apple
Saisissez l'identifiant de votre produit iTunes pour ce prix – dans notre cas "com.braincloud.mygame.goldsack1". Vous pouvez saisir des identifiants iPhone/iPad distincts si votre application n'est pas un binaire universel (ou utilise deux identifiants différents pour une autre raison).
À ce stade, vous pouvez sélectionner votre prix comme prix par défaut, s'il n'est pas déjà sélectionné. Vous pouvez le faire depuis la page "Modifier le produit".
Vous pouvez désormais vérifier que votre produit est bien renvoyé avec le bon identifiant iTunes. Voici le résultat de l'appel "Product.GetInventory" de l'API Explorer.
Abonnements renouvelables automatiquement
Si vous utilisez des abonnements à renouvellement automatique, vous devrez ajouter votre secret partagé iTunes IAP à brainCloud.
Connectez-vous à iTunes Connect
Sélectionnez votre application dans la liste et accédez à l'onglet "Achats intégrés"
Cliquez sur le lien "Afficher ou générer un secret partagé" en bas de la liste des IAP
Récupérez le secret partagé sur la page (ou générez-en un nouveau s'il n'en existe pas)
Connectez-vous au portail brainCloud
Accédez à la page "Info de base de l'app > IDs de l'application" dans l'onglet Conception de votre application.
Cliquez sur le bouton Apple
Entrez le secret partagé d'iTunes
