SDKs para Unity / Informações gerais
  Voltar aos Documentos

SDKs para Unity

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.

Aviso
Depois que o primeiro pagamento real é feito, uma política rigorosa de pagamento sandbox entra em vigor. Os pagamentos feitos no modo sandbox estão disponíveis apenas para usuários especificados na Conta de Distribuidor na seção Company settings > Users.

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 o ícone 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.

Exemplo de uso do parâmetro close_button na WebView:

Guias

Saiba mais sobre configurações avançadas em nossos guias.

Como configurar o redirecionamento de usuários para seu aplicativo após o pagamento

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 fecha a interface de pagamento ou 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
Aviso
Se os redirecionamentos estiverem configurados nas opções da Conta de Distribuidor e do SDK, os parâmetros especificados nas configurações do SDK serão usados.

Configure os redirecionamentos na Conta de Distribuidor

  1. Abra seu projeto na Conta de Distribuidor.
  2. Clique em Pay Station no menu lateral.
  3. Vá para a seção Settings > Redirect policy.
  1. No campo Return URL, insira o URL ou o caminho para o qual o usuário será redirecionado após fazer um pagamento.
Observação

Para redirecionar os usuários para um aplicativo móvel, o URL deve corresponder a um dos seguintes esquemas:

Você pode encontrar o valor <ANDROID_PACKAGE_NAME>/<BUNDLE_ID> nas configurações do projeto Unity (Edit > Project Settings > Player > Android (iOS) > Other Settings > Bundle Identifier).

  1. Para definir parâmetros de redirecionamento automático:
    1. 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.
    2. No campo Delay, insira um tempo limite de redirecionamento em segundos. Por padrão, um redirecionamento é ativado em 0 segundos.

  1. Para definir parâmetros de redirecionamento manual:
    1. 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.
    2. No campo Redirect button caption, insira o texto do botão que redireciona o usuário para o URL de retorno.
Aviso

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.

  1. Clique em Save.

Configure redirecionamentos nas configurações do SDK

  1. Abra seu projeto Unity.
  2. Clique em Window > Xsolla > Edit Settings no menu principal.
  3. Abra o painel Inspector e vá para a seção Pay Station > Redirect Policy.
  4. Vá para a seção correspondente à plataforma de compilação do seu aplicativo (Desktop, WebGL, Android, ou iOS) e especifique os parâmetros de redirecionamento:

    1. Desmarque a caixa Use setting from Publisher Account.
    2. No campo Return URL, insira o URL ou o caminho para o qual um usuário é redirecionado depois de fazer um pagamento.
Observação

Para redirecionar os usuários para um aplicativo móvel, o URL deve corresponder a um dos seguintes esquemas:

Você pode encontrar o valor <ANDROID_PACKAGE_NAME>/<BUNDLE_ID> nas configurações do projeto Unity (Edit > Project Settings > Player > Android (iOS) > Other Settings > Bundle Identifier).

    1. Para definir os parâmetros de redirecionamento automático:
      1. 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.
      2. No campo Redirect Timeout, Insira um tempo limite de redirecionamento em segundos.

    1. Para definir os parâmetros de redirecionamento manual:
      1. 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.
      2. No campo Redirect Button Caption, insira o texto do botão que redirecionará o usuário para o URL de retorno.
Aviso

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.

Este artigo foi útil?
Obrigado!
Podemos melhorar alguma coisa? Mensagem
Que pena ouvir isso
Explique porque este artigo não foi útil para você. Mensagem
Obrigado pelo seu feedback!
Avaliaremos sua mensagem e a usaremos para melhorar sua experiência.
Ocultar

Continuar lendo

Última atualização: 26 de Abril de 2024

Encontrou um erro de texto ou digitação? Selecione o texto e pressione Ctrl+Enter.

Relatar um problema
Nós sempre avaliamos nossos conteúdos. Seu feedback nos ajuda a melhorá-los.
Forneça um e-mail para que possamos responder
Obrigado pelo seu feedback!