Informações gerais
O SDK suporta a compra de itens do catálogo com um clique ou através do carrinho de compras.
Para testar o processo de compra, você pode usar o modo sandbox da interface de pagamento e cartões de teste. O modo sandbox apenas simula o comportamento de uma forma de pagamento; não há dinheiro real envolvido. Para experimentar o sandbox, você não precisa assinar nenhum contrato com a Xsolla ou pagar nenhuma taxa.
A interface de pagamento é baseada no produto Pay Station. A escolha dos métodos de pagamento disponíveis e outras configurações estão disponíveis na Conta de Distribuidor na seção Pay Station.
A maneira de abrir a interface de pagamento depende da plataforma para a qual seu aplicativo foi desenvolvido:
- Para aplicativos de desktop, o SDK permite que você abra a interface de pagamento no navegador integrado ou externo, dependendo das configurações do projeto.
- Em aplicativos móveis, a interface de pagamento é aberta em um navegador externo.
- Para WebGL, o widget da interface de pagamento é aberto em um iframe na mesma página do navegador.
Se você abrir a interface de pagamento em uma WebView no seu aplicativo móvel, adicione um botão para que o usuário possa fechar a interface de pagamento a qualquer momento da compra. Para isso, use o parâmetro close_button
em instâncias da classe PurchaseParams
ao chamar os métodos SDK XsollaCatalog.Purchase
ou XsollaCart.Purchase
.
Você pode selecionar o ícone que será exibido no botão. Para fazer isso, passe um dos seguintes valores no parâmetro close_button_icon
nas instâncias da classe PurchaseParams
:
“arrow”
— para exibir o ícone ← (usado por padrão).“cross”
— para exibir o ícone ×.
Exemplo de uso dos parâmetros close_button e close_button_icon na WebView:
Guias
Para redirecionar os usuários para outra página depois que eles concluírem o pagamento, você pode configurar dois tipos de redirecionamentos:
- automático — um redirecionamento com um atraso definido.
- manual — um redirecionamento depois que o usuário clica no botão de redirecionamento.
Você pode configurar um redirecionamento das seguintes maneiras:
- na Conta de Distribuidor — use essa opção se estiver configurando um projeto para um único aplicativo e não planeja criar compilações para plataformas diferentes.
- nas configurações do SDK — use esta opção se você planeja:
- usar o projeto para vários aplicativos
- criar compilações para diferentes plataformas
- vender itens no jogo através do site
Configure os redirecionamentos na Conta de Distribuidor
- Abra seu projeto na Conta de Distribuidor.
- Clique em Pay Station no menu lateral.
- Vá para a seção Settings > Redirect policy.
- No campo Return URL, insira o URL ou o caminho para o qual o usuário será redirecionado após fazer um pagamento.
Para redirecionar os usuários para um aplicativo móvel, o URL deve corresponder a um dos seguintes esquemas:
app://xpayment.<ANDROID_PACKAGE_NAME>
, onde<ANDROID_PACKAGE_NAME>
é o nome do pacote do aplicativo Android.app://xpayment.<BUNDLE_ID>
, onde<BUNDLE_ID>
é o identificador de aplicativo iOS.
Você pode encontrar o valor <ANDROID_PACKAGE_NAME>
/<BUNDLE_ID>
nas configurações do projeto Unity (
- Para definir parâmetros de redirecionamento automático:
- Na lista suspensa, escolha a Automatic redirect conditiono:
- None — do not redirect.
- Successful payment — redirecionar quando um pagamento for bem-sucedido.
- Successful or canceled payment — redirecionar quando um pagamento for bem-sucedido ou cancelado.
- Any payment — redirecionar para qualquer status de pagamento.
- No campo Delay, insira um tempo limite de redirecionamento em segundos. Por padrão, um redirecionamento é ativado em 0 segundos.
- Na lista suspensa, escolha a Automatic redirect conditiono:
- Para definir parâmetros de redirecionamento manual:
- Na lista suspensa, escolha a Manual redirect condition:
- None — do not redirect.
- Successful payment — o botão de redirecionamento aparece quando um pagamento é bem-sucedido.
- Successful or canceled paymen — o botão de redirecionamento aparece quando um pagamento é bem-sucedido ou cancelado.
- Any payment — o botão de redirecionamento aparece para qualquer status de pagamento.
- No campo Redirect button caption, insira o texto do botão que redireciona o usuário para o URL de retorno.
- Na lista suspensa, escolha a Manual redirect condition:
O texto do botão de redirecionamento é Voltar para o jogo por padrão. Ele está traduzido em todos os idiomas do Pay Station.
Se o seu projeto suporta vários idiomas, você pode inserir o texto do botão de redirecionamento para cada um deles nos respectivos campos.
Quando um usuário fecha a interface de pagamento, ele também é redirecionado para o URL de retorno especificada.
- Clique em Save.
Configure redirecionamentos nas configurações do SDK
- Abra seu projeto Unity.
- Clique em
Window > Xsolla > Edit Settings no menu principal. - Abra o painel
Inspector e vá para a seçãoPay Station > Redirect Policy . - Vá para a seção correspondente à plataforma de compilação do seu aplicativo (
Desktop ,WebGL ,Android , ouiOS ) e especifique os parâmetros de redirecionamento:
- Desmarque a caixa
Use setting from Publisher Account . - No campo
Return URL , insira o URL ou o caminho para o qual um usuário é redirecionado depois de fazer um pagamento.
- Desmarque a caixa
Para redirecionar os usuários para um aplicativo móvel, o URL deve corresponder a um dos seguintes esquemas:
app://xpayment.<ANDROID_PACKAGE_NAME>
, onde<ANDROID_PACKAGE_NAME>
é o nome do pacote do aplicativo Android.app://xpayment.<BUNDLE_ID>
, onde<BUNDLE_ID>
é o identificador de aplicativo iOS.
Você pode encontrar o valor <ANDROID_PACKAGE_NAME>
/<BUNDLE_ID>
nas configurações do projeto Unity (
- Para definir os parâmetros de redirecionamento automático:
- Na lista suspensa, escolha
Redirect Conditions :None — não redirecionar.Successful payment — redirecionar quando um pagamento for bem-sucedido.Successful or canceled payment — redirecionar quando um pagamento for bem-sucedido ou cancelado.Any payment — redirecionar para qualquer status de pagamento.
- No campo
Redirect Timeout , Insira um tempo limite de redirecionamento em segundos.
- Na lista suspensa, escolha
- Para definir os parâmetros de redirecionamento automático:
- Para definir os parâmetros de redirecionamento manual:
- Na lista suspensa, escolha
Status for Manual Redirection :None — não redirecionar.Successful payment — o botão de redirecionamento aparece quando um pagamento é bem-sucedido.Successful or canceled payment — o redirecionamento aparece quando um pagamento é bem-sucedido ou cancelado.Any payment — o botão de redirecionamento aparece para qualquer status de pagamento.
- No campo
Redirect Button Caption , insira o texto do botão que redirecionará o usuário para o URL de retorno.
- Na lista suspensa, escolha
- Para definir os parâmetros de redirecionamento manual:
O texto do botão de redirecionamento é Voltar para o jogo por padrão. Ele está traduzido em todos os idiomas do Pay Station.
Se o seu projeto suporta vários idiomas, você pode inserir o texto do botão de redirecionamento para cada um deles nos respectivos campos.
Quando um usuário fecha a interface de pagamento, ele também é redirecionado para o URL de retorno especificada.
Continuar lendo
Encontrou um erro de texto ou digitação? Selecione o texto e pressione Ctrl+Enter.