SDK aufseiten der Anwendung integrieren

Damit das SDK ordnungsgemäß funktioniert, benötigen Sie einen Token. Ein Zahlungstoken ist ein String, mit dem der Zahlungsvorgang initiiert wird.

Einen Token abzurufen, ist mit der Methode createOrder, createOrderByItemSku, createOrderFromCartById oder createOrderFromCurrentCart aus der Store-Bibliothek möglich. Sie können auch einen Token verwenden, den Sie auf Ihrem Anwendungsserver über den API-Aufruf Zahlungstoken für den Kauf erstellen erhalten haben.

Das SDK nutzt WKWebView, um das Zahlungsportal innerhalb der Anwendung zu öffnen. Der In-App-Kaufvorgang wird dadurch nahtlos, da die Nutzer keinen Wechsel von der Anwendung zur Website bemerken.

Wir empfehlen Ihnen, eine Schließen-Schaltfläche für das Zahlungsportal einzurichten, da die Browser-Leiste und die standardmäßigen Navigationselemente im WKWebView nicht sichtbar sind. Übermitteln Sie dazu in der Struktur StorePaymentProjectSettings im Parameter ui.mobilePlatformSettings das Objekt header = StorePaymentProjectSettings.UISettings.PlatformSettings.Header mit dem Parameter closeButton: true.

Sie können das Symbol auswählen, das auf der Schaltfläche angezeigt werden soll. Übermitteln Sie dazu einen der folgenden Werte im Parameter closeButtonIcon bei Instanzen der Klasse PurchaseParams:

• “arrow” – für das Symbol ← (voreingestellt)
• “cross” – für das Symbol ×

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)

Schließen-Schaltfläche für das Zahlungsportal einrichten (Beispiel):