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 API Shop Builder.
   • 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:

1val intent = XPayments.createIntentBuilder(this)
2               .accessToken(<accessToken>)
3               .isSandbox(<isSandbox>)
4           	.setStatusReceivedCallback(object : StatusReceivedCallback {
5               	override fun onSuccess(data: InvoicesDataResponse) {
6                   		Log.d(TAG, "StatusReceivedCallback is fired. Result data = $data")
7               	}
8           	})
9           	.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:

1XPayments.createIntentBuilder(this)
2  .accessToken(AccessToken(token))
3  .isSandbox(BuildConfig.IS_SANDBOX)
4  .setActivityType(ActivityType.TRUSTED_WEB_ACTIVITY)
5  .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:

 1val paymentOptions = PaymentOptions(
 2            isSandbox = isSandbox,
 3            settings = PaymentProjectSettings(
 4                ui = UiProjectSetting(mobile = MobileSettings(header = UiMobileProjectSettingHeader(closeButton = true, closeButtonIcon = "arrow"))),
 5                returnUrl = "app://xpayment.${getApplication<Application>().packageName}",
 6                redirectPolicy = SettingsRedirectPolicy(
 7                    redirectConditions = "any",
 8                    delay = 5,
 9                    statusForManualRedirection = "any",
10                    redirectButtonCaption = "Back to the Game"
11                )
12            )
13        )

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