Configure 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:
Para redirecionar usuários a outra página depois de concluírem o pagamento, você pode configurar redirecionamentos na conta ou via API. Para diferentes status de pagamento (pagamento bem-sucedido ou cancelado), você pode configurar os seguintes redirecionamentos:
- automático — 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.
Aviso
Limitações:
- As configurações de redirecionamento passados via API levam prioridade sobre as definições na Conta de Distribuidor.
- Configurações de redirecionamento automáticas levam prioridade sobre as definidas em redirecionamentos manuais. Por exemplo, se ambos redirecionamentos manuais e automáticos com um tempo limite de 0 segundos forem configurados para os pagamentos bem-sucedidos, o redirecionamento automático ocorrerá.
Limitações:
- As configurações de redirecionamento passadas via API têm prioridade sobre as definidas na conta.
- Configurações de redirecionamento automáticas têm prioridade sobre as definidas para redirecionamentos manuais. Por exemplo, se ambos os redirecionamentos manuais e automáticos com um tempo de atraso de 0 segundos forem configurados para pagamentos bem-sucedidos, o redirecionamento automático ocorrerá.
- Se você passar o parâmetro settings.ui.mode: “user_account” no token, o botão de redirecionamento não é exibido na interface de pagamento. Para redirecionar o usuário depois de salvar um método de pagamento, você deve configurar o redirecionamento automático.
GET são automaticamente adicionados ao URL onde um usuário é redirecionado para: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:
| Status de transação | Descrição |
|---|---|
done | O pagamento é bem-sucedido. |
invoice | O invoice para o pagamento foi gerado. |
delivering | O pagamento está sendo processado no lado Xsolla. |
troubled | Ocorreu um erro ao processar o pagamento ou durante o processo de reembolso. |
full_change | O pagamento foi feito com o saldo Xsolla. |
Observação
Começando a partir de 1º de junho de 2026, o ID de transação é passado no formato
int64. Isso significa que o valor máximo é de (2^63)-1. Se você usa um tipo de dado numérico, certifique-se de que ele suporte números inteiros de 64-bit. Caso contrário, utilize um tipo string.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.
Observação
Para especificar um URL para redirecionar os usuários quando fecham a interface de pagamento antes de concluíram o pagamento, passe o parâmetro settings.cancel_url ao criar um token.
Configuração de redirecionamentos automáticos
Você pode configurar redirecionamentos automáticos:
Observação
Se você deseja adicionar um temporizador de redirecionamento na página de status de pagamento, configure redirecionamentos via API.
Configurar redirecionamentos automáticos na Conta de Distribuidor
- Abra seu projeto na Conta de Distribuidor e acesse a seção Payments > Payment interface > General settings.
- Vá para a seção Payment redirect policy.
Configurar redirecionamentos automáticos na conta
- Abra seu projeto na conta e vá para a seção Payments > Payment interface > General settings.
- Vá para a seção Payment redirect policy.
Configurar redirecionamentos automáticos na conta
- Abra seu projeto na conta e vá para a seção Payments > Payment interface > General settings.
- Vá para a seção Payment redirect policy.
Configurar redirecionamentos automáticos na conta
- Abra seu projeto na conta e vá para a seção Payments > Payment interface > General settings.
- Vá para a seção Payment redirect policy.
- No campo Return URL, insira um endereço URL ou trajeto (um link profundo) para o qual um usuário é redirecionado depois de fazer um pagamento. Para melhorar a experiência do usuário quando o usuário abre a interface de pagamento em um aplicativo de jogo móvel, recomendamos especificar um link profundo como URL de retorno.
- Na lista suspensa, escolha a Automatic redirect condition:
- None — não redirecionar.
- Successful payment — redirecionar quando um pagamento é bem-sucedido.
- Successful or canceled payment — redirecionar quando um pagamento é 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, o redirecionado é ativado em 0 segundos.
- Se quiser configurar apenas o redirecionamento automático sem adicionar um botão de redirecionamento, na lista suspensa Manual redirect condition, escolha None — não redirecionar.
- Selecione Save changes.
Configuração de redirecionamentos automáticos via API
Observação
Se você quiser especificar URLs de redirecionamento diferentes, como para plataformas diferentes, você precisa criar um token dedicado em cada caso particular.
Para configurar os redirecionamentos, passe os seguintes dados na chamada API Criar token:
| Parâmetro | Descrição |
|---|---|
settings.return_url | Um endereço URL ou um trajeto (um link profundo) para o qual o usuário é redirecionado depois de fazer um pagamento. Para melhorar a experiência do usuário quando um usuário abre a interface de pagamento em um aplicativo de jogo móvel, recomendamos especificar um link profundo como URL de retorno. |
settings.cancel_url | URL da página para o qual o usuário é redirecionado ao fechar a interface de pagamento antes de concluir o pagamento. Só funciona se você usar os objetos settings.ui.desktop.header ou settings.ui.mobile para configurar o botão de fechar a interface de pagamento. Se o botão for configurado, mas o URL não for passado nesse parâmetro, será utilizado o URL passado no parâmetro settings.return_url. |
settings.redirect_policy.redirect_conditions | Condições de redirecionamento:
|
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. |
settings.redirect_policy.show_redirect_countdown | Passe true se você deseja exibir um temporizador de redirecionamento na página de status de pagamento. A duração do temporizador é determinada pelo valor passado no parâmetro settings.redirect_policy.delay. |
Configuração de redirecionamentos manuais
Você pode configurar redirecionamentos manuais:
Aviso
As configurações de redirecionamento passadas via API têm prioridade sobre as definidas na Conta de Distribuidor.
Configuração de redirecionamentos manuais na Conta de Distribuidor
- Abra seu projeto na Conta de Distribuidor e acesse a seção Payments > Payment interface > General settings.
- Vá para a seção Payment redirect policy.
Você pode configurar redirecionamentos manuais:
Aviso
As configurações de redirecionamento passadas via API têm prioridade sobre as definidas na conta.
Configurar redirecionamentos manuais na conta
- Abra seu projeto na conta e vá para a seção Payments > Payment interface > General settings.
- Vá para a seção Payment redirect policy.
Você pode configurar redirecionamentos manuais:
Aviso
As configurações de redirecionamento passadas via API têm prioridade sobre as definidas na conta.
Configurar redirecionamentos manuais na conta
- Abra seu projeto na conta e vá para a seção Payments > Payment interface > General settings.
- Vá para a seção Payment redirect policy.
Você pode configurar redirecionamentos manuais:
Aviso
As configurações de redirecionamento passadas via API têm prioridade sobre as definidas na conta.
Configurar redirecionamentos manuais na conta
- Abra seu projeto na conta e vá para a seção Payments > Payment interface > General settings.
- Vá para a seção Payment redirect policy.
- No campo Return URL, insira um endereço URL ou trajeto (um link profundo) para o qual um usuário é redirecionado depois de fazer um pagamento. Para melhorar a experiência do usuário quando o usuário abre a interface de pagamento em um aplicativo de jogo móvel, recomendamos especificar um link profundo como URL de retorno.
- Se quiser configurar apenas o redirecionamento manual, na lista suspensa Automatic redirect condition, escolha None — não redirecionar.
- Deixe o campo Delay vazio.
- Na lista suspensa Manual redirect condition, escolha um status de pagamento em que o botão de redirecionamento aparece:
- None — não redirecionar.
- Successful payment — redirecionar quando um pagamento é bem-sucedido.
- Successful or canceled payment — redirecionar quando um pagamento é bem-sucedido ou cancelado.
- Any payment — redirecionar para qualquer status de pagamento.
- No campo Redirect button caption, insira a cópia para o botão que redirecionará o usuário ao URL de retorno.
- Selecione Save changes.
Aviso
Por padrão, o texto do botão de redirecionamento é Voltar para o jogo. 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.
Configuração de redirecionamentos manuais via API
Observação
Se você quiser especificar URLs de redirecionamento diferentes, como para plataformas diferentes, você precisa criar um token dedicado em cada caso particular.
Para configurar os redirecionamentos, passe os seguintes dados na chamada API Criar token:
| Parâmetro | Descrição |
|---|---|
settings.return_url | Um endereço URL ou um trajeto (um link profundo) para o qual o usuário é redirecionado depois de fazer um pagamento. Para melhorar a experiência do usuário quando um usuário abre a interface de pagamento em um aplicativo de jogo móvel, recomendamos especificar um link profundo como URL de retorno. |
settings.cancel_url | URL da página para o qual o usuário é redirecionado ao fechar a interface de pagamento antes de concluir o pagamento. Só funciona se você usar os objetos settings.ui.desktop.header ou settings.ui.mobile para configurar o botão de fechar a interface de pagamento. Se o botão for configurado, mas o URL não for passado nesse parâmetro, será utilizado o URL passado no parâmetro settings.return_url. |
settings.redirect_policy.manual_redirection_action | O comportamento da interface de pagamento acionado pelo usuário pressionando o botão de fechar ou de retorno:
|
settings.redirect_policy.redirect_button_caption | Uma cópia para o botão que redirecionará o usuário ao URL de retorno. |
settings.redirect_policy.status_for_manual_redirection | Um status de pagamento quando o botão de redirecionamento aparece:
|
Aviso
Se a interface de pagamento for aberta em um iframe e o parâmetro
settings.ui.desktop.header.close_button estiver definido como true, somente o evento postmessage será enviado quando um usuário clicar no ícone de fechamento. Ele permite que você processe o evento e feche a interface de pagamento, e o usuário pode permanecer na página na qual o pagamento foi iniciado.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:
Na conta, você configurou redirecionamentos automáticos com um atraso de 3 segundos. Esse comportamento se aplica tanto à versão móvel quanto à versão desktop da interface de pagamento. As configurações feitas na conta 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:
| Parâmetro | Valor |
|---|---|
settings.return_url | Um link profundo que redirecionar um usuário ao aplicativo do jogo. |
settings.redirect_policy.redirect_conditions | any |
settings.redirect_policy.manual_redirection_action | redirect |
settings.redirect_policy.redirect_button_caption | O texto do botão de redirecionamento. |
Copy
- json
1{
2 "user": {
3 "country": {
4 "value": "US"
5 },
6 "id": {
7 "value": "1234abCd"
8 },
9 "name": {
10 "value": "John Smith"
11 }
12 },
13 "settings": {
14 "currency": "USD",
15 "project_id": 123456,
16 "language": "en",
17 "return_url": "myapp://payment/successful",
18 "ui": {
19 "desktop": {
20 "header": {
21 "visible_logo": true
22 }
23 }
24 },
25 "redirect_policy": {
26 "redirect_conditions": "any",
27 "redirect_button_caption": "Back to Store",
28 "manual_redirection_action": "redirect",
29 "status_for_manual_redirection": "any"
30 },
31 "external_id": "1a2b3c"
32 },
33 "custom_parameters": {
34 "timestamp": 1234512345123,
35 "sku": "testSKU",
36 "amount": "10"
37 },
38 "purchase": {
39 "virtual_items": {
40 "items": [
41 {
42 "sku": "testSKU",
43 "amount": 1
44 }
45 ]
46 }
47 }
48}
Este artigo foi útil?
Obrigado pelo seu feedback!
Avaliaremos sua mensagem e a usaremos para melhorar sua experiência.Encontrou um erro de texto ou digitação? Selecione o texto e pressione Ctrl+Enter.
