Como implementar a venda da moeda virtual do Metaframe na sua interface

Você pode vender moedas virtuais sem usar o widget Metaframe. Por exemplo, se você quiser implementar sua própria interface de loja ou usar um serviço de autorização diferente. Para fazer isso, você precisa implementar a lógica de compra, recarga automática de moedas virtuais e a exibição de saldo do usuário usando a API Metaframe.

Pré-requisitos

Antes de você começar, crie as configurações de projeto necessárias:

1. Crie um projeto.
2. Crie pacotes de moedas virtuais na Conta de Distribuidor.
3. Obtenha os IDs e chave secreta necessários. Para fazer isso, contate seus Gerentes de Sucesso do Cliente, envie um e-mail para csm@xsolla.com ou integration@xsolla.com. Forneça as seguintes informações da Conta de Distribuidor:

• ID de Comerciante que pode ser encontrado:
  • Próximo ao nome da sua empresa.
  • Na seção Company settings > Company.
  • No URL na barra de endereços do navegador em qualquer página da Conta de Distribuidor. O URL tem o seguinte formato: https:​//publisher.xsolla.com/ID de Comerciante/seção em sua Conta de Distribuidor.

• ID de Projeto que pode ser encontrado próximo ao nome do projeto.

• Uma chave secreta para assinar webhooks do projeto que pode ser encontrada na seção Project settings > Webhooks.

• Chave de API que é exibida na Conta de Distribuidor apenas uma vez quando é criada e deve ser armazenada do seu lado. Você pode criar uma nova chave nas seções a seguir:
  • Company settings > API keys.
  • Project settings > API keys.

A equipe Xsolla fornece a você as seguintes informações necessárias para futuras configurações:

• Host ID
• ID de cliente OAuth 2.0 da conta Xsolla
• Chave secreta de cliente OAuth 2.0 da conta Xsolla

Obter token de servidor

O token de servidor é necessário para obter o token de acesso do usuário e para a recarga automática.

No back-end do seu aplicativo, implemente um método para obter o JSON Web Token (JWT) do servidor usando a chamada de API Generate JWT. A solicitação deve conter os seguintes parâmetros:

• grant_type é o tipo de JWT, passe o valor client_credentials.
• client_secret é a chave secreta que é recebida da Xsolla.
• client_id é o ID de cliente recebido da Xsolla.

Obtenha o token de acesso do usuário

O token de autorização do usuário é obrigado a gerar um token de pagamento e solicitar o saldo de moedas virtuais do usuário.

Se você estiver usando seu próprio sistema de autorização, você pode obter um token de autorização adequado usando:

• token de acesso de rede social
• ID personalizado — ID de usuário gerado no seu servidor

Obter token durante login social

1. Configure a autorização via rede social na sua Conta de Distribuidor:

1. 1. Abra seu projeto na Conta de Distribuidor.
   2. Clique em Login no menu lateral.
   3. Clique em Create Login project.
   4. Selecione Standard Login project e clique em Create and set up. Quando seu novo projeto Login for criado, você poderá ver a página com as configurações do projeto Login.
   5. No bloco Login methods, selecione Social login e clique em Configure.
   6. Conecte redes sociais que você usa para fazer o login social no seu aplicativo.
   7. Clique no nome do seu projeto Login na trilha de migalhas para retornar à página do projeto Login.
   8. Vá para Security block e selecione a seção JWT signature.
   9. Selecione RS256 como o algoritmo de geração de assinatura e clique em Save changes.

2. No lado do cliente do aplicativo, implemente o recebimento e atualização de um token usando a chamada de API Auth via access token of social network.

Obtenha o token com o ID personalizado

No back-end do seu aplicativo, implemente um método para obter e atualizar o token usando a chamada de API Auth by custom ID. A solicitação deve conter o cabeçalho X-Server-Authorization: <server_JWT>, onde <server_JWT> é o JWT do servidor obtido na etapa anterior.

Gerencie moedas virtuais com chamadas de API