Como configurar redirecionamentos

Visão geral

Para redirecionar usuários a outra página depois de concluírem o pagamento, você pode configurar redirecionamentos na Conta de Distribuidor ou via API. Para status de pagamento diferentes (pagamentos bem-sucedidos ou cancelados) você pode configurar os seguintes redirecionamentos:

• automatic — um redirecionamento após um tempo específico.
• manual — um redirecionamento depois que o usuário clica no botão de redirecionamento.

Você pode configurar redirecionamentos automáticos e manuais simultaneamente. Um usuário ainda terá uma possibilidade de clicar no botão de redirecionamento para voltar ao aplicativo. Caso contrário, eles serão automaticamente redirecionados quando o tempo especificado for atingido.

• user_id — ID de usuário.
• foreigninvoice — ID de transação passado no parâmetro external_id.
• invoice_id — ID de transação.
• status — status de transação. Pode ter os seguintes valores:

Exemplo do URL onde um usuário é redirecionado para: {Return URL}?user_id=[value]&foreignInvoice=[value]&invoice_id=[value]&status=done

Se um usuário fecha a interface de pagamento antes de concluir o pagamento, ele é redirecionado ao URL de redirecionamento especificado com o formato: {Return URL}?user_id=[value]&invoice_id=. Se a interface de pagamento for aberta com o Pay Station Embed, o widget será fechado e o usuário retornará ao jogo quando a interface de pagamento for fechada.

Configuração de redirecionamentos automáticos

Você pode configurar redirecionamentos automáticos:

Configurar redirecionamentos automáticos na Conta de Distribuidor

1. Abra seu projeto na Conta de Distribuidor e vá para Pay Station > Settings > Redirect policy.

2. No campo Return URL, insira um endereço URL ou um trajeto (um link profundo) para redirecionar o usuário após concluir um pagamento. Para melhorar a experiência do usuário ao abrir a interface de pagamento em um aplicativo móvel, recomendamos especificar um link profundo como um URL de retorno.
3. Na lista suspensa, escolha Automatic redirect condition:
   • None — do not redirect.
   • Successful payment — redirecionar quando um pagamento for bem-sucedido.
   • Successful or canceled payment — redirecionar quando um pagamento é bem-sucedido ou cancelado.
   • Any payment — redirecionar em qualquer status de pagamento.
4. No campo Delay, insira um tempo limite de redirecionamento em segundos. Por padrão, um redirecionamento é ativado em 0 segundos.
5. Se você gostaria de configurar apenas o redirecionamento automático sem adicionar um botão de redirecionamento, na lista suspensa Manual redirect condition, escolha None — do not redirect.
6. Clique em Save.

Configuração de redirecionamentos automáticos via API

Para configurar os redirecionamentos, passe os seguintes dados na chamada API Criar token:

• settings.return_url — um endereço URL ou um trajeto (um link profundo) para redirecionar o usuário após concluir um pagamento. Para melhorar a experiência do usuário ao abrir a interface de pagamento em um aplicativo móvel, recomendamos especificar um link profundo como um URL de retorno.
• settings.redirect_policy.redirect_conditions — condições de redirecionamento:
  • none — não redirecionar.
  • successful — redirecionar quando um pagamento for bem-sucedido ou cancelado.
  • successful_or_canceled — redirecionar em qualquer status de pagamento.
  • any — redirecionar para qualquer status de pagamento.
• settings.redirect_policy.delay — um tempo limite, em segundos, quando um redirecionamento ao URL passado no parâmetro settings.return_url é ativado. Por padrão, um redirecionamento é ativado em 0 segundos.

Configuração de redirecionamentos manuais

Você pode configurar redirecionamentos manuais:

• na Conta de Distribuidor
• via API

Configuração de redirecionamentos manuais na Conta de Distribuidor

1. Abra seu projeto na Conta de Distribuidor e vá para Pay Station > Settings > Redirect policy.

1. No campo Return URL, insira um endereço URL ou um trajeto (um link profundo) usado para redirecionar o usuário após concluir um pagamento. Para melhorar a experiência do usuário ao abrir a interface de pagamento em um aplicativo móvel, recomendamos especificar um link profundo como um URL de retorno.
2. Se desejar configurar apenas o redirecionamento manual, na lista suspensa Automatic redirect condition, escolha None — do not redirect.
3. Deixe o campo Delay vazio.
4. Na lista suspensa Manual redirect condition, escolha um status de pagamento quando o botão de redirecionamento surgir:
   • None — do not redirect.
   • Successful payment — Redirecionar quando um pagamento é bem-sucedido.
   • Successful or canceled payment — redirecionar quando um pagamento é bem-sucedido ou cancelado.
   • Any payment — redirecionar em qualquer status de pagamento.
5. No campo Redirect button caption, insira o texto do botão que redirecionará o usuário ao URL de retorno.
6. Clique em Save.

Configuração de redirecionamentos manuais via API

Para configurar os redirecionamentos, passe os seguintes dados na chamada API Criar token:

• settings.return_url — um endereço URL ou um trajeto (um link profundo) usado para redirecionar o usuário após concluir um pagamento. Para melhorar a experiência do usuário ao abrir a interface de pagamento em um aplicativo móvel, recomendamos especificar um link profundo como um URL de retorno.
• settings.redirect_policy.manual_redirection_action — o comportamento da interface de pagamento acionado pelo usuário clicando no botão de fechar ou de retorno:
  • redirect (por padrão) — um usuário é redirecionado ao URL de retorno.
  • postmessage — clicar no ícone de fechar inicia o envio do evento close-widget, e clicar no botão de retorno — o evento return. Nesse caso, um usuário não é redirecionado ao URL de retorno. Você precisa configurar o processamento de eventos por fechar a interface de pagamento ou um redirecionamento. Essa configuração só está disponível ao usar a API.
• settings.redirect_policy.redirect_button_caption — o texto para o botão que redirecionará um usuário ao URL de retorno.
• settings.redirect_policy.status_for_manual_redirection — um status de pagamento para quando o botão de redirecionamento aparece:
  • none — não redirecionar.
  • successful — redirecionar quando um pagamento é bem-sucedido.
  • successful_or_canceled — redirecionar quando um pagamento é bem-sucedido ou cancelado.
  • any — redirecionar em qualquer status de pagamento.

Exemplo de configuração de redirecionamento

Na Conta de Distribuidor, você configurou redirecionamentos automáticos com um atraso de 3 segundos. Esse comportamento se aplica tanto à versão desktop quanto móvel do interface de pagamento. As configurações feitas na Conta de Distribuidor têm a seguinte aparência:

Se precisar atualizar as configurações para abrir a interface de pagamento no aplicativo móvel do seu jogo, nomeadamente para adicionar o botão de redirecionamento e especificar um link profundo como URL de retorno, você precisa atualizar as configurações passadas em um token:

{
    "user": {
        "country": {
            "value": "US"
        },
        "id": {
            "value": "1234abCd"
        },
        "name": {
            "value": "John Smith"
        }
    },
    "settings": {
        "currency": "USD",
        "project_id": 123456,
        "language": "en",
        "return_url": "myapp://payment/successful",
        "ui": {
            "desktop": {
                "header": {
                    "visible_logo": true
                }
            }
        },
        "redirect_policy": {
            "redirect_conditions": "any",
            "redirect_button_caption": "Back to Store",
            "manual_redirection_action": "redirect",
            "status_for_manual_redirection": "any"
        },
        "external_id": "1a2b3c"
    },
    "custom_parameters": {
        "timestamp": 1234512345123,
        "sku": "testSKU",
        "amount": "10"
    },
    "purchase": {
        "virtual_items": {
            "items": [
                {
                    "sku": "testSKU",
                    "amount": 1
                }
            ]
        }
    }
}