Intégrer le SDK côté application

Pour le bon fonctionnement du SDK, un jeton est nécessaire. Un jeton de paiement est une chaîne utilisée pour lancer le processus de paiement.

Pour obtenir un jeton, utilisez les méthodes createOrder, createOrderByItemSku, createOrderFromCartById ou createOrderFromCurrentCart de la bibliothèque Store. Vous pouvez également utiliser le jeton obtenu sur votre serveur d’application à l’aide de l’appel API Créer un jeton de paiement pour un achat.

Pour ouvrir l’interface de paiement dans l’application, le SDK utilise WKWebView. Cela rend le processus d’achat in-app transparent, évitant toute transition visible entre l’application et la page Web pour l’utilisateur.

Nous recommandons de configurer un bouton de fermeture pour l’interface de paiement, étant donné que la barre de navigation et les éléments de navigation standard ne sont pas visibles à l’utilisateur dans WKWebView. Pour ce faire, dans la structure StorePaymentProjectSettings, dans le paramètre ui.mobilePlatformSettings, passez l’objet header = StorePaymentProjectSettings.UISettings.PlatformSettings.Header avec le paramètre closeButton: true.

Sélectionnez l’icône qui s’affichera sur le bouton. Pour ce faire, passez l’une des valeurs suivantes dans le paramètre closeButtonIcon des instances de la classe PurchaseParams :

• “arrow” — pour afficher l’icône ← (utilisé par défaut) ;
• “cross” — pour afficher l’icône ×.

let mobileHeaderSettings = StorePaymentProjectSettings.UISettings.PlatformSettings.Header(closeButton: true, closeButtonIcon: "arrow")

        let mobilePlatformSettings = StorePaymentProjectSettings.UISettings.PlatformSettings(header: mobileHeaderSettings)

        let uiSettings = StorePaymentProjectSettings.UISettings(theme: "63295aab2e47fab76f7708e3", size: StorePaymentProjectSettings.UISettings.Size.medium, mobilePlatformSettings: mobilePlatformSettings)

        let redirectPolicy = StorePaymentProjectSettings.RedirectPolicy(redirectConditions: .any, delay: 5, statusForManualRedirection: .any,  redirectButtonCaption: "Back to the game")

 let paymentProjectSettings = StorePaymentProjectSettings(ui: uiSettings, returnUrl: "xsollasdk123456://xsollaconfirm/payment", redirectPolicy: redirectPolicy)

Exemple de configuration d’un bouton de fermeture pour l’interface de paiement :