Intégrer le SDK côté application

Logique générale d'achat

1. Implémentez la logique d'obtention de jetons de paiement de l'une des manières suivantes :
   • En utilisant la bibliothèque Store (recommandé) :
     • Pour l'achat d'un seul objet, appelez la méthode createOrderByItemSku.
     • Pour l'achat des objets du panier :
       1. Après que l'utilisateur a rempli le panier, appelez la méthode fillCurrentCartWithItems ;
       2. Appelez la méthode createOrderFromCartById ou createOrderFromCurrentCart.

1. • En utilisant IGS API.
   • En utilisant vos propres méthodes serveur ou les méthodes de la solution BaaS.

2. Implémentez la logique d'ouverture de l'interface UI :

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()

Options d'ouverture de l'interface de paiement

Le SDK pour Android propose trois méthodes d’intégration de l’interface de paiement dans l’application :

Configurer le mode d'ouverture de l'interface de paiement

Par défaut, le SDK utilise les onglets personnalisés. Si les onglets personnalisés ne sont pas disponibles sur l’appareil de l’utilisateur, par exemple en l’absence d’un navigateur approprié, le SDK basculera automatiquement vers d’autres modes : d’abord WebView, puis le navigateur externe par défaut installé sur l’appareil.

Pour définir un autre mode principal d’ouverture de l’interface de paiement, utilisez la méthode setActivityType.

Exemple :

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

Si le mode principal n’est pas disponible, le SDK passe à d’autres modes dans l’ordre suivant : Trusted Web Activity > Onglets personnalisés > WebView > navigateur externe par défaut installé sur l’appareil.

Configurer le bouton de fermeture de l'interface de paiement

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 WebView et Trusted Web Activity. Pour ce faire, dans l’objet PaymentOptions, dans le paramètre ui.mobile, passez l’objet mobile = UiMobileProjectSettingHeader 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 :

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

Exemple d’objet PaymentOptions :

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"
                )
            )
        )

Exemple d’utilisation des paramètres closeButton et closeButtonIcon dans WebView et Trusted Web Activity :