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):
     1. Um einen einzelnen Artikel zu kaufen, rufen Sie die Methode createOrderByItemSku auf.
     2. Um die Artikel im Warenkorb zu kaufen:
        1. Nachdem der Kunde den Warenkorb gefüllt hat, rufen Sie die Methode fillCurrentCartWithItems auf.
        2. Rufen Sie entweder die Methode createOrderFromCartById oder createOrderFromCurrentCart auf.

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

2. Implementieren Sie die Logik des Zahlungsportals:

vmPurchase.paymentToken.observe(this) { token ->
    val intent = XPayments.createIntentBuilder(this)
        .accessToken(AccessToken(token))
        .isSandbox(BuildConfig.IS_SANDBOX)
        .useWebview(true)
        .build()
    startActivityForResult(intent, RC_PAYSTATION)
}

3. Implementieren Sie die Handhabung der Zahlungsergebnisse:

override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
    super.onActivityResult(requestCode, resultCode, data)
    if (requestCode == RC_PAYSTATION) {
        val (status, _) = XPayments.Result.fromResultIntent(data)
        when (status) {
            XPayments.Status.COMPLETED -> showSnack(getString(R.string.payment_completed))
            XPayments.Status.CANCELLED -> showSnack(getString(R.string.payment_cancelled))
            XPayments.Status.UNKNOWN -> showSnack(getString(R.string.payment_unknown))
        }
    }
}

Öffnungsmöglichkeiten für das Zahlungsportal

Je nachdem, welche Parameter an die Methode XPayments.createIntentBuilder übermittelt werden, wird das Zahlungsportal in WebView oder in einem benutzerdefinierten Tab geöffnet.

Wird der Parameter useWebview(true) übermittelt, wird das Zahlungsportal immer in WebView geöffnet.

Ein benutzerdefinierter Tab wird verwendet, wenn die folgenden Bedingungen erfüllt sind:

• Beim Aufruf von XPayments.createIntentBuilder wird der Parameter useWebview nicht übermittelt oder es wird useWebview(false) übermittelt.
• Das Gerät des Nutzers verwendet standardmäßig einen der folgenden Browser:
  • Google Chrome
  • Samsung Internet Browser
  • Huawei Browser

Wird ein anderer Browser verwendet, wird das Zahlungsportal in WebView geöffnet, unabhängig von den Parametern der Methode XPayments.createIntentBuilder.

In WebView werden dem Nutzer weder die Browserleiste noch die Standardnavigationselemente angezeigt. Dadurch wirkt der In-App-Kauf übersichtlicher. Sie müssen jedoch die Anwendung anpassen und um ein Pfeilsymbol (←) ergänzen, damit der Nutzer das Zahlungsportal in jeder Phase des Kaufvorgangs schließen kann. Ein Beispiel für die Anpassung finden Sie in der Demo-Anwendung.

Im benutzerdefinierten Tab kann der Nutzer das Zahlungsportal durch einen Klick auf das Symbol ✖ schließen.

Nutzung von WebView (Beispiel):

Nutzung eines benutzerdefinierten Tabs (Beispiel):