Configure a compra de itens

Criar pedidos no lado do servidor do aplicativo

Para criar um pedido com o usuário e os dados de itens no lado da Xsolla, use a chamada API Criar token de pagamento para compra. O método retornará um token de pagamento, que é necessário para abrir uma interface de pagamento e realizar um pagamento. Para usar o modo sandbox, passe o parâmetro “sandbox”: true no corpo da solicitação para obter um token.

Limitações:

• Você precisa passar o país do usuário, ou o seu endereço IP, ao solicitar o token de pagamento. Usando esses dados, o sistema determinará a moeda de compra, o idioma a ser usado na interface de pagamento e calculará as taxas.
• Se você não passar a moeda no token, ela será determinada pelo país do usuário.
• Se você passar a moeda no token, o usuário pagará nessa moeda.
• No parâmetro user_id, você precisa passar o ID do usuário do seu sistema de autenticação. Esse ID é usado para validar o usuário antes de fazer uma compra. Ao fazer testes, você pode passar qualquer símbolo nesse parâmetro.

Abertura da interface de pagamento

<script>
   var options = {
       access_token: 'ACCESS_TOKEN', //TODO use access token, received on previous step
       sandbox: true //TODO please do not forget to remove this setting when going live
   };
   var s = document.createElement('script');
   s.type = "text/javascript";
   s.async = true;
   s.src = "https://static.xsolla.com/embed/paystation/1.0.7/widget.min.js";
   s.addEventListener('load', function (e) {
       XPayStationWidget.init(options);
   }, false);
   var head = document.getElementsByTagName('head')[0];
   head.appendChild(s);
</script>

<button data-xpaystation-widget-open>Buy Credits</button>

<iframe
  src="https://sandbox-secure.xsolla.com/paystation4/?token=TOKEN"
  width="800"
  height="700"
  allow="clipboard-read; clipboard-write; payment"
></iframe>

Pagamentos de teste

Para testar o processo de pagamento, você pode usar o modo sandbox. O modo sandbox é um ambiente autônomo que oferece suporte a todos os recursos de um ambiente de verdade, exceto pagamentos reais e recusados. Você pode acessar o modo sandbox enviando “sandbox”: true ao criar um pedido.

1. Abra a interface de pagamento no modo sandbox.
2. Escolha o método de pagamento Cartão do banco.
3. Insira os dados do cartão bancário. Nos outros campos (ex.: nome ou endereço), você pode inserir qualquer dado. Você também pode especificar detalhes incorretos (número do cartão ou data de validade) para testar se um erro é gerado.
4. Clique em Pay.

Lista de cartões de teste

Veja a lista de cartões bancários de teste.

Para ver informações detalhadas, incluindo taxas, sobre as transações feitas no modo sandbox:

1. Abra sua Conta de Distribuidor.
2. Vá para Accounting > Transaction registry.
3. Marque a caixa Show test transactions.

Adicionalmente, você pode ver os detalhes das transações e solicitar reembolsos na Conta de Distribuidor na seção Support > Transaction search.