Crie a interface do catálogo

Há três maneiras de criar a interface do catálogo:

Usando a própria interface

Ao criar um diretório em sua própria interface, você pode usar:

  • Armazenamento de dados próprio e qualquer opção de autorização. Nesse caso, implemente a interface do catálogo do seu lado.
  • Sua própria autorização e o método de servidor Obter Planos. Implemente a interface do catálogo do seu lado depois de obter a lista de planos.
  • Xsolla Login e chamadas de API do lado do cliente.
Observação
Você também pode usar as bibliotecas SDK para implementar um catálogo em sua própria interface. Bibliotecas prontas facilitam a integração de produtos Xsolla em seu projeto, fornecendo estruturas de dados de uso pronto e métodos para trabalhar com a Xsolla API.

Xsolla Login e chamadas de API do lado do cliente

Para implementar um catálogo:
  1. Obtenha uma lista de planos de assinatura usando métodos de cliente:
  2. Implemente a exibição da lista de planos recebidos na interface.

Método do lado do cliente para obter os planos de assinatura por produtos

No lado do cliente do seu aplicativo, use uma solicitação HTTP get para implementar a obtenção da lista de planos: https://subscriptions.xsolla.com​/api/user/v1/projects/{project_id}/products/{​​productId}/plans.

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:

Especifique como os parâmetros de caminho:
  • projectId — ID do projeto. Você pode encontrar esse parâmetro em sua Conta de Distribuidor ao lado do nome do projeto.
  • productID — ID do produto baseado na assinatura. Para obtê-lo, entre em contato com seu Gerente de Sucesso do Cliente ou envie um e-mail para csm@xsolla.com.

Especifique como parâmetros de consulta:
ParâmetroTipoDescrição
plan_id
matriz de números inteirosID do plano.
plan_external_id
array of stringsID externo do plano. Pode ser encontrado na Conta de Distribuidor na seção Subscriptions > Subscription plans > your plan ou por meio da chamada de API Obter Planos.
limit
integerLimite para o número de elementos na página. 15 itens são exibidos por padrão.
offset
integerNúmero do elemento a partir do qual a lista é gerada. A contagem começa em 0 por padrão.
locale
stringIdioma de interface em duas letras minúsculas. Aceita valores ISO 639-1. Se esse parâmetro não for passado, o idioma será determinado pelo endereço IP.
Valores disponíveis:
  • en — Inglês
  • ar — Árabe
  • bg — Búlgaro
  • cn — Chinês (Simplificado)
  • cs — Tcheco
  • de — Alemão
  • es — Espanhol
  • fr — Francês
  • he — Hebreu
  • it — Italiano
  • ja — Japonês
  • ko — Coreano
  • pl — Polonês
  • pt — Português
  • ro — Romeno
  • ru — Russo
  • th — Tailandês
  • tr — Turco
  • tw — Chinês (Tradicional)
  • vi — Vietnamita
Se o idioma passado não estiver na lista da Xsolla, o idioma Inglês será usado.
country
stringA designação de duas letras ISO 3166-1 alpha-2 é usada para identificar o país do usuário. Esse parâmetro afeta a escolha da localidade e moeda. Se esse parâmetro não for passado, o país será determinado pelo endereço IP do usuário.
Copy
Full screen
Small screen
curl -X 'GET' \
'https://subscriptions.xsolla.com/api/user/v1/projects/{project_id}/products/{​​productId}/plans?country=RU  ' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer client_user_jwt'
Copy
Full screen
Small screen
{
  "items": [
    {
      "plan_id": 54321,
      "plan_external_id": "PlanExternalId",
      "plan_group_id": "TestGroupId",
      "plan_type": "all",
      "plan_name": "Localized plan name",
      "plan_description": "Localized plan description",
      "plan_start_date": "2021-04-11T13:51:02+03:00",
      "plan_end_date": "2031-04-11T13:51:02+03:00",
      "trial_period": 7,
      "period": {
        "value": 1,
        "unit": "month"
      },
      "charge": {
        "amount": 4.99,
        "setup_fee": 0.99,
        "currency": "USD"
      },
      "promotion": {
        "promotion_charge_amount": 3.99,
        "promotion_remaining_charges": 3
      }
    }
  ],
  "has_more": false
}

Método do lado do cliente para obter a lista de planos

No lado do cliente do seu aplicativo, use uma solicitação HTTP GET para implementar a obtenção da lista de planos: https://subscriptions.xsolla.com​/api/user/v1/projects/{project_id}/plans.

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:

Especifique a ID do projeto como o parâmetro de caminho projectId. Você pode encontrar esse parâmetro em sua Conta de Distribuidor ao lado do nome do projeto.

Especifique como parâmetros de consulta:

ParâmetroTipoDescrição
plan_id
matriz de números inteirosID do plano.
plan_external_id
array of stringsID externo do plano. Pode ser encontrado na Conta de Distribuidor na seção Subscriptions > Subscription plans > your plan ou por meio da chamada de API Obter Planos.
limit
integerLimite para o número de elementos na página. 15 itens são exibidos por padrão.
offset
integerNúmero do elemento a partir do qual a lista é gerada. A contagem começa em 0 por padrão.
locale
stringIdioma de interface em duas letras minúsculas. Aceita valores ISO 639-1. Se esse parâmetro não for passado, o idioma será determinado pelo endereço IP.
Valores disponíveis:
  • en — Inglês
  • ar — Árabe
  • bg — Búlgaro
  • cn — Chinês (Simplificado)
  • cs — Tcheco
  • de — Alemão
  • es — Espanhol
  • fr — Francês
  • he — Hebreu
  • it — Italiano
  • ja — Japonês
  • ko — Coreano
  • pl — Polonês
  • pt — Português
  • ro — Romeno
  • ru — Russo
  • th — Tailandês
  • tr — Turco
  • tw — Chinês (Tradicional)
  • vi — Vietnamita
Se o idioma passado não estiver na lista da Xsolla, o idioma Inglês será usado.
country
stringA designação de duas letras ISO 3166-1 alpha-2 é usada para identificar o país do usuário. Esse parâmetro afeta a escolha da localidade e moeda. Se esse parâmetro não for passado, o país será determinado pelo endereço IP do usuário.
Copy
Full screen
Small screen
curl -X 'GET' \
'https://subscriptions.xsolla.com/api/user/v1/projects/{project_id}/plans?country=RU  ' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer client_user_jwt'
Copy
Full screen
Small screen
{
  "items": [
    {
      "plan_id": 54321,
      "plan_external_id": "PlanExternalId",
      "plan_group_id": "TestGroupId",
      "plan_type": "all",
      "plan_name": "Localized plan name",
      "plan_description": "Localized plan description",
      "plan_start_date": "2021-04-11T13:51:02+03:00",
      "plan_end_date": "2031-04-11T13:51:02+03:00",
      "trial_period": 7,
      "period": {
        "value": 1,
        "unit": "month"
      },
      "charge": {
        "amount": 4.99,
        "setup_fee": 0.99,
        "currency": "USD"
      },
      "promotion": {
        "promotion_charge_amount": 3.99,
        "promotion_remaining_charges": 3
      }
    }
  ],
  "has_more": false
}

Usando a Xsolla Pay Station

  1. Implemente a obtenção do token por meio da chamada de API Criar token do lado do servidor. Passe os seguintes parâmetros na solicitação:
    • user.id — ID do usuário em seu sistema de autorização.
    • user.email — e-mail do usuário. Deve ser válido de acordo com o protocolo RFC 822.
    • settings.project_id — ID do projeto. Você pode encontrar esse parâmetro em sua Conta de Distribuidor ao lado do nome do projeto.
  2. Implemente a abertura da interface de pagamento de uma das seguintes maneiras:
Copy
Full screen
Small screen
{
    "user": {
        "name": {
            "value": "j.smith@email.com"
        },
        "id": {
            "value": "123a345b678c091d"
        }
    },
    "settings": {
        "project_id": 177226
    }
}

Um exemplo de exibição do catálogo de assinaturas na Xsolla Pay Station:

Usando o Xsolla Site Builder

O Xsolla Site Builder permite que você crie e configure seu site para vendas de assinaturas. Para fazer isso, use o modelo Web Shop para criar um site. Você pode ler mais sobre como configurar funções nas instruções Web Shop with user authentication.

Este artigo foi útil?
Obrigado!
Podemos melhorar alguma coisa? Mensagem
Que pena ouvir isso
Explique porque este artigo não foi útil para você. Mensagem
Obrigado pelo seu feedback!
Avaliaremos sua mensagem e a usaremos para melhorar sua experiência.
Última atualização: 31 de Julho 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!