SDKs para Android / Configure o redirecionamento do usuário
  Voltar aos Documentos

SDKs para Android

Configure o redirecionamento do usuário

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:

  • durante a criação do pedido - use esta opção se você planeja usar o projeto para vários aplicativos ou para vender itens no jogo através do site.
Aviso
Se os redirecionamentos estiverem configurados na Conta de Distribuidor e durante a criação do pedido, os parâmetros especificados durante a criação do pedido 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 Android, o URL deve corresponder ao seguinte esquema: app://xpayment.<ANDROID_PACKAGE_NAME>, onde <ANDROID_PACKAGE_NAME> é o nome do pacote do aplicativo Android.

  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 durante a criação do pedido

Crie um objeto PaymentOptions e passe-o para o método de criação do pedido (createOrderByItemSku, createOrderFromCartById ou createOrderFromCurrentCart). No objeto, defina as configurações de redirecionamento:

  1. No parâmetro settings.returnUrl, passe o endereço URL ou o caminho para o qual um usuário é redirecionado após fazer um pagamento.
Observação
Para redirecionar os usuários para um aplicativo Android, o URL deve corresponder ao seguinte esquema: app://xpayment.<ANDROID_PACKAGE_NAME>, onde <ANDROID_PACKAGE_NAME> é o nome do pacote do aplicativo Android.

  1. Para definir parâmetros de redirecionamento automático:
    1. No parâmetro settings.redirectPolicy.redirectConditions, passe condições quando um redirecionamento for ativado:
      • none — não redirecionar.
      • successful — redirecionar quando um pagamento for bem-sucedido.
      • successful_or_canceled — redirecionar quando um pagamento for bem-sucedido ou cancelado.
      • any — redirecionar para qualquer status de pagamento.
    2. No parâmetro delay, passe um tempo limite de redirecionamento em segundos.

  1. Para definir parâmetros de redirecionamento manual:
    1. No parâmetro settings.redirectPolicy.statusForManualRedirection, passe um status de pagamento quando o botão de redirecionamento aparecer:
      • none — não redirecionar.
      • successful — redirecionar quando um pagamento for bem-sucedido.
      • successful_or_canceled — redirecionar quando um pagamento for bem-sucedido ou cancelado.
      • any — redirecionar para qualquer status de pagamento.
    2. No parâmetro settings.redirectPolicy.redirectButtonCaption, passe 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.

Você pode usar um projeto de demonstração como um exemplo de configuração de redirecionamentos durante a criação de pedidos.
Seu progresso
Obrigado pelo seu feedback!
Última atualização: 6 de Março 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!