Integre o SDK no lado do aplicativo

Lógica de compra geral

1. Implemente a lógica de obtenção de tokens de pagamento de uma das seguintes maneiras:
   • Usando a biblioteca Store (recomendado):
     • Para comprar um único item, chame o método createOrderByItemSku.
     • Para comprar os itens no carrinho:
       1. Depois que o usuário tiver preenchido o carrinho, chame o método fillCurrentCartWithItems.
       2. Chame o método createOrderFromCartById ou createOrderFromCurrentCart.

1. • Usando a IGS API.
   • Usando seus próprios métodos de servidor ou métodos de solução BaaS.

2. Implemente a lógica de abertura da interface de pagamento:

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

Opções de abertura de interface de pagamento

O SDK para Android fornece 3 maneiras de exibir a interface de pagamento dentro do aplicativo:

Configuração do método para abrir a interface de pagamento

Por padrão, o SDK utiliza Custom Tabs. Se Custom Tabs não estiverem disponíveis no dispositivo do usuário (por exemplo, se um navegador adequado não estiver instalado), o SDK trocará automaticamente para outros métodos para abrir a interface de pagamento: primeiro WebView e então no navegador externo instalado no dispositivo por padrão.

Você pode definir um método primário diferente para abrir a interface de pagamento usando o método setActivityType.

Exemplo:

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

Em caso do método primário não estiver disponível, o SDK troca para outros métodos na seguinte ordem: Trusted Web Activity > Custom Tabs > WebView > navegador externo instalado no dispositivo por padrão.

Configuração do botão de fechar a interface de pagamento

Recomendamos que você configure um botão de fechar para a interface de pagamento, já que a barra de endereços e os elementos de navegação padrões do navegador não ficam visíveis ao usuário na WebView e Trusted Web Activity. Para fazer isso, no objeto PaymentOptions no parâmetro ui.mobile, passe o objeto mobile = UiMobileProjectSettingHeader com o parâmetro closeButton=true.

Você pode selecionar o ícone que será exibido no botão. Para fazer isso, passe um dos seguintes valores no parâmetro closeButtonIcon:

• “arrow” — para exibir o ícone ←.
• “cross” — para exibir o ícone × (usado por padrão).

Exemplo de objeto 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"
                )
            )
        )

Exemplo de uso dos parâmetros closeButton e closeButtonIcon na WebView e Trusted Web Activity: