SDK aufseiten der Anwendung integrieren

Allgemeine Kauflogik

1. Implementieren Sie die Logik für den Abruf eines Zahlungstokens auf eine der folgenden Weisen:
   • Mithilfe der Store-Bibliothek (empfohlen):
     • Um einen einzelnen Artikel zu kaufen, rufen Sie die Methode createOrderByItemSku auf.
     • Um die Artikel im Warenkorb zu kaufen:
       1. Nachdem der Kunde die gewünschten Artikel in den Warenkorb gelegt hat, rufen Sie die Methode fillCurrentCartWithItems auf.
       2. Rufen Sie entweder die Methode createOrderFromCartById oder createOrderFromCurrentCart auf.

1. • Mithilfe von IGS API.
   • Mithilfe Ihrer eigenen Servermethoden oder BaaS-Lösungen.

2. Implementieren Sie die Logik des Zahlungsportals:

val intent = XPayments.createIntentBuilder(this)
               .accessToken(<accessToken>)
               .isSandbox(<isSandbox>)
           	.setStatusReceivedCallback(object : StatusReceivedCallback {
               	override fun onSuccess(data: InvoicesDataResponse) {
                   		Log.d(TAG, "StatusReceivedCallback is fired. Result data = $data")
               	}
           	})
           	.build()

Öffnungsmöglichkeiten für das Zahlungsportal

Die Android SDKs bieten drei Möglichkeiten für die Anzeige der Zahlungsschnittstelle innerhalb der Anwendung an:

Methode für die Öffnung des Zahlungsportals einrichten

SDK nutzt standardmäßig Custom Tabs. Wenn Custom Tabs nicht verfügbar ist, z.B. kein passender Browser installiert ist, wechselt das SDK automatisch auf andere Methoden, die das Zahlungsportal öffnen: standardmäßig zuerst WebView und dann im auf dem Gerät installierten Browser.

Sie können mit der MethodesetActivityType eine andere primäre Methode zum Öffnen des Zahlungsportals festlegen.

Beispiel:

XPayments.createIntentBuilder(this)
  .accessToken(AccessToken(token))
  .isSandbox(BuildConfig.IS_SANDBOX)
  .setActivityType(ActivityType.TRUSTED_WEB_ACTIVITY)
  .build()

Im Falle, dass die primäre Methode nicht verfügbar ist, wechselt das SDK automatisch auf andere Methoden in folgender Reihenfolge: Trusted Web Activity > Custom Tabs > WebView > auf dem Gerät standardmäßig installierter externer Browser.

Einrichten der Schließen-Schaltfläche für das Zahlungsportal

Wir empfehlen Ihnen, eine Schließen-Schaltfläche für das Zahlungsportal einzurichten, da die Browser-Leiste und die standardmäßigen Navigationsleisten im WebView und Trusted Web Activity nicht sichtbar sind. Übermitteln Sie dazu in den Parameter ui.mobile im Objekt PaymentOptions das Objekt mobile = UiMobileProjectSettingHeader mit dem Parameter closeButton=truecloseButton=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:

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

Beispielhaftes PaymentOptions-Objekt:

val paymentOptions = PaymentOptions(
            isSandbox = isSandbox,
            settings = PaymentProjectSettings(
                ui = UiProjectSetting(mobile = MobileSettings(header = UiMobileProjectSettingHeader(closeButton = true, closeButtonIcon = "arrow"))),
                returnUrl = "app://xpayment.${getApplication<Application>().packageName}",
                redirectPolicy = SettingsRedirectPolicy(
                    redirectConditions = "any",
                    delay = 5,
                    statusForManualRedirection = "any",
                    redirectButtonCaption = "Back to the Game"
                )
            )
        )

Nutzung der beiden Parameter closeButton und closeButtonIcon in WebView und Trusted Web Activity: