Como obter o token de pagamento

Para abrir a interface de pagamento, você precisa obter um token. Um token é uma cadeia de caracteres que inclui dados criptografados sobre um jogo e um usuário. Você precisa implementar a obtenção de um token para identificar o usuário para permitir a compra.

Para obter um token de pagamento:

1. Obtenha um token de autorização do usuário.
2. Crie um pedido.

Obter token de autorização do usuário

O tempo de vida do token é de 24 horas após a última chamada para a Xsolla API. Implemente a lógica de receber um novo token após sua expiração. É recomendável que você obtenha um novo token em segundo plano, para que o usuário não precise fazer login no aplicativo novamente.

No back-end do seu aplicativo, implemente a obtenção de um token de autenticação de usuário. Para fazer isso, use uma solicitação HTTP POST que inclua autenticação HTTP básica e passe os parâmetros necessários no corpo da solicitação.

Referência da API

Veja a lista completa de parâmetros.

Autenticação HTTP básica

A Xsolla API usa 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 ID de comerciante:chave API, codificado de acordo com o padrão Base64. Vá para Conta de Distribuidor para encontrar estes parâmetros:

• O Merchant ID é exibido:
  • 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/<merchant ID>/<Publisher Account section>.

• A API key é mostrada na Conta de Distribuidor apenas uma vez, durante a criação, e deve ser armazenada por você. Você pode criar uma nova chave na seguinte seção:
  • Company settings > API keys
  • Project settings > API keys

Corpo do pedido

No corpo da solicitação, passe os seguintes parâmetros necessários:

Para melhorar a experiência do usuário, você também pode passar os seguintes parâmetros:

curl -i -X POST \
  -u 2340:ZHgbSDVP6LtAJVWu \
  https://api.xsolla.com/merchant/v2/merchants/<merchant_id>/token \
  -H 'Content-Type: application/json' \
  -d '{
    "settings": {
      "currency": "USD",
      "language": "en",
      "project_id": <project_id>
      }
    },
    "user": {
      "email": {
        "value": "<user_email>"
      },
      "id": {
        "value": "<user_id>"
      },
      "name": {
        "value": "<user_name>"
      }
    }
  }'

Exemplo de um token de autenticação de usuário recebido em resposta

{
    "token": "1230OWrp0KF6uqvmN8jWuzLyoXMzxTyK_lc_en"
}

Obter token de pagamento

Na resposta, você receberá os dados necessários para trabalhos mais avançados:

• token — ficha de pagamento