Conta de inscrito

Como funciona

A conta de inscrito é um serviço que permite que os usuários vejam e gerenciam suas assinaturas configuradas no seu projeto Xsolla.

• a visualização dos dados da assinatura
• o gerenciamento da assinatura — cancelamento imediato, desativação de renovação automática, ou reativação (dependendo das configurações do projeto)
• a alteração do plano de assinatura
• a atualização do método de pagamento

• ao clicar no link nas notificações de e-mail relacionadas à assinatura
• a partir da página de pagamento dentro do jogo

• usando uma chamada de API do lado do servidor
• usando uma chamada de API do lado do cliente

Obtenção de um link de conta de assinante via API

Chamada do lado do servidor

A chamada permite que você implemente a geração de um link para a conta do assinante a partir do lado do servidor do seus aplicativos via solicitação HTTP POST.

Endereço URL:

https://subscriptions.xsolla.com​/api/user/v1/projects/{project_id}/subscriptions/user_account

Autorização:

A chamada usa a autenticação de acesso básica. Todas as solicitações à API devem conter o cabeçalho Authorization: Basic <your_authorization_basic_key>, onde <your_authorization_basic_key> é o par merchant_id:api_key codificado de acordo com o padrão Base64. Vá para a Conta de Distribuidor para localizar estes parâmetros:

• merchant_id é mostrado:
  • Na seção Company settings > Company.
  • No URL da barra de endereços do navegador em qualquer página Conta de Distribuidor. O URL tem o seguinte formato: https://publisher.xsolla.com/<merchant_id>.
• api_key é exibido na Conta de Distribuidor apenas uma vez quando é criada e deve ser armazenada do seu lado. Você pode criar uma nova chave na seguinte seção:
  • Company settings > API keys
  • Project settings > API keys

Parâmetros:

Como parâmetro de trajeto, especifique project_id — ID do Projeto, que é especificado na Conta de Distribuidor próximo ao nome do seu projeto ou na barra de endereço do navegador em qualquer página do projeto. O URL tem o seguinte formato: https://publisher.xsolla.com/<merchantId>/projects/<projectId>.

Parâmetros do corpo:

 1curl -v https://subscriptions.xsolla.com​/api/v1/projects/{projectId}/subscriptions/user_account \
 2-X POST \
 3-u your_merchant_id:merchant_api_key \
 4-H 'Content-Type:application/json' \
 5-H 'Accept: application/json' \
 6-d '
 7{
 8  "user_v1": "user123",
 9  "locale": "en"
10}'

Exemplo de resposta:

1{
2  "redirect_url": "https://subscriptions-user-account.xsolla.com/?token=<access_token>&projectId=<project_id>&merchantId=<merchant_id>&locale=<locale>"
3}

Chamada do lado do cliente

A chamada permite que você implemente a geração de um link à conta de assinante do lado do cliente dos seus aplicativos via solicitação HTTP GET se o Xsolla Login estiver configurado para o seu projeto.

Endereço URL:

https://subscriptions.xsolla.com​/api/user/v1/projects/{project_id}/subscriptions/user_account

Autorização:

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.

Parâmetros:

Como parâmetro de trajeto, especifique project_id — ID do Projeto, que é especificado na Conta de Distribuidor próximo ao nome do seu projeto ou na barra de endereço do navegador em qualquer página do projeto. O URL tem o seguinte formato: <code>https://publisher.xsolla.com/{merchantId}/projects/{projectId}</code>.

Como parâmetro de pesquisa, especifique locale — Idioma da interface em duas letras minúsculas, de acordo com o padrão ISO 639-1. Se este parâmetro não for passado, o idioma será determinado pelo endereço IP do usuário. Se a localização passada não estiver na lista da Xsolla, o idioma inglês será usado por padrão.

Exemplo de solicitação:

1curl -v https://subscriptions.xsolla.com​/api/user/v1/projects/{project_id}/subscriptions/user_account \
2-X GET \
3-u your_merchant_id:merchant_api_key \
4-H 'Content-Type:application/json' \
5-H 'Accept: application/json' \

Exemplo de resposta:

1{
2  "redirect_url": "https://subscriptions-user-account.xsolla.com/?token=<access_token>&projectId=<project_id>&merchantId=<merchant_id>&locale=<locale>"
3}