Como permitir que um usuário altere um plano de assinatura

Como funciona

• Ao escolher um novo plano, é feito um reembolso no saldo do usuário pelo período não utilizado da assinatura atual.
• O pagamento do novo plano de assinatura é feito inteiramente a partir do saldo do usuário. Se o saldo for insuficiente, um pagamento adicional é feito por qualquer um dos métodos de pagamento permitidos no projeto.
• Ao alterar o plano, os fundos são debitados imediatamente após a confirmação do pagamento, mesmo que o projeto esteja configurado para alterar o plano a partir do próximo período de cobrança.

• Se a moeda do novo plano for diferente da moeda do plano atual, a compra do novo plano será feita com uma conversão de moeda.

• o usuário já tem uma assinatura ativa com o plano para o qual o plano atual está sendo alterado
• a assinatura que o usuário deseja alterar não está no status Active
• o plano de assinatura que o usuário deseja alterar é do tipo Plano Vitalício: tal assinatura só pode ser cancelada dentro do período de reembolso especificado

Como obtê-lo

1. Abra seu projeto na Conta de Distribuidor e acesse a seção Items catalog > Subscriptions > Settings.
2. Na seção Changing plan, defina a opção Ability to choose a different plan como On.
3. As alterações de plano são permitidas a partir do próximo período por padrão. Para permitir a alteração do plano no período atual, selecione Now. Se você selecionar essa opção, o plano será alterado imediatamente após a confirmação do pagamento.
4. Para permitir alterações de plano mais de uma vez por dia, defina a opção Ability to choose a different plan several times on the same day como On.
5. Ao abrir a interface de pagamento, use:
   • chamada de API Criar token do lado do servidor
   • para obter um link para abrir uma interface de pagamento se você usar o Xsolla Login em seu projeto

Abrindo a interface de pagamento por meio da chamada de API Criar token do lado do servidor

1. Obtenha um token para abrir a interface de pagamento passando o seguinte ao método:
   • change_plan valor no parâmetro purchase.subscription.operation.
   • ID do novo plano no parâmetro purchase.subscription.plan_id.
   • ID do produto baseado em assinatura no parâmetro purchase.subscription.product_id se você estiver usando produtos baseados em assinatura. Para obtê-lo, entre em contato com seu Gerente de Sucesso do Cliente ou envie um e-mail para csm@xsolla.com.
2. Abra a interface de pagamento de uma das seguintes maneiras:
   • Script Pay Station Embed
   • Iframe
   • Nova janela

Abrindo a interface de pagamento na página de gerenciamento de assinaturas usando a chamada de API do lado do cliente

Se o Xsolla Login estiver configurado em seu projeto, você poderá usar a chamada de API do lado do cliente para obter um link para abrir a interface de pagamento. O link retornado na resposta permite que você abra a interface de pagamento na página de gerenciamento de assinaturas, onde os usuários podem selecionar uma assinatura ativa e alterá-la.

Para fazer isso, no lado do cliente do seu aplicativo, implemente um link à interface de pagamento usando uma solicitação HTTP POST: https://subscriptions.xsolla.com​/api/user/v1/projects/{project_id}/subscriptions/manage. A solicitação deve conter um cabeçalho Authorization: Bearer <client_user_jwt>, onde <client_user_jwt> é o JSON Web Token (JWT) do usuário — um token exclusivo codificado em Base64. Para obter o token:

• Use Register new user e Auth by username, e as chamadas de API de senha se seu aplicativo usar autorização de login e senha.
• Use a chamada de API Auth via social network se seu aplicativo usar autorização por meio de redes sociais.

Passe parâmetros adicionais para personalização, se necessário.

Parâmetros do corpo da solicitação:

 1curl -X 'POST' \
 2'https://subscriptions.xsolla.com/api/user/v1/projects/{project_id}/subscriptions/manage?country=RU  ' \
 3  -H 'accept: application/json' \
 4  -H 'Authorization: Bearer client_user_jwt'
 5{
 6  "settings": {
 7    "ui": {
 8      "size": "large",
 9      "theme": "string",
10      "version": "desktop",
11      "desktop": {
12        "header": {
13          "is_visible": true,
14          "visible_logo": true,
15          "visible_name": true,
16          "type": "compact",
17          "close_button": true
18        }
19      },
20      "mobile": {
21        "mode": "saved_accounts",
22        "footer": {
23          "is_visible": true
24        },
25        "header": {
26          "close_button": true
27        }
28      },
29      "license_url": "string",
30      "mode": "user_account",
31      "user_account": {
32        "history": {
33          "enable": true,
34          "order": 1
35        },
36        "payment_accounts": {
37          "enable": true,
38          "order": 1
39        },
40        "info": {
41          "enable": true,
42          "order": 1
43        },
44        "subscriptions": {
45          "enable": true,
46          "order": 1
47        }
48      }
49    },
50    "currency": "str",
51    "locale": "st",
52    "external_id": "string",
53    "payment_method": 1,
54    "return_url": "string",
55    "redirect_policy": {
56      "redirect_conditions": "none",
57      "delay": 0,
58      "status_for_manual_redirection": "none",
59      "redirect_button_caption": "string"
60    }
61  }
62}

Exemplo de resposta:

1{
2  "link_to_ps": "https://secure.xsolla.com/paystation2/?access_token=<access_token>"
3}