Criar um pedido no lado do cliente do aplicativo

Para criar um pedido com o usuário e os dados de itens no lado da Xsolla, use a chamada API Criar pedido com item especificado. 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.

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.

Crie um pedido e abra a interface de pagamento

Para criar um pedido com os dados do usuário e do produto no lado da Xsolla, chame o método SDK XsollaCatalog.Purchase, passando os seguintes parâmetros a ele:

• itemSku — o SKU do item que o usuário deseja comprar.
• onSuccess — o retorno de chamada de compra bem-sucedida, acionado quando o pedido transita para o status done.
• onError — o retorno de chamada de erro de solicitação.
• onBrowseClosed — o retorno de chamada de fechamento do navegador (opcional). O evento é rastreado apenas ao abrir a interface de pagamento do usuário no navegador integrado. Eventos de navegadores externos não são rastreados.
• purchaseParams — parâmetros de compra e configurações de interface de pagamento do usuário, tais como a localização e moeda (opcional).
• customHeaders — cabeçalhos de solicitação da web personalizados (opcional).

O método XsollaCatalog.Purchase inicia o processo de compra para o item especificado, incluindo a criação de pedido, abrindo a interface de pagamento do usuário e rastreando o status do pedido. No parâmetro onSuccess, passe a função que é chamada quando o pedido transita para o status done.

Pagamentos de teste

Para testar o processo de pagamento, você pode usar o modo sandbox. O modo sandbox é um ambiente autônomo que suporta todos os recursos de um ambiente ativo, exceto pagamentos reais e recusados. Para ter acesso ao modo sandbox, você deve ter a caixa Test Payments Mode marcada no Unity Editor no painel Inspector (marcado por padrão).

1. Execute seu aplicativo ou cena no Unity Editor.
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.

Crie um pedido e abra a interface de pagamento

1. Para criar um pedido com os dados do usuário e do item no lado da Xsolla, chame o método createOrderByItemSku da biblioteca Store, passando os seguintes parâmetros a ele:

1. • callback — o retorno de chamada de criação de pedido bem-sucedido. Ele recebe o token de pagamento necessário para abrir a interface e fazer o pagamento.

1. • itemSku — o SKU do item que o usuário deseja comprar.

1. • options — parâmetros de pagamento (opcional).

1. • quantity — a quantidade de itens que o usuário deseja comprar (opcional). Se a quantidade não for especificada, o valor padrão será definido como 1.

2. Implemente a lógica de abertura da interface de pagamento:

val intent = XPayments.createIntentBuilder(activity)
    .accessToken(AccessToken(<payment token>))
    .isSandbox(<isSandbox>)
    .build()
startActivityForResult(intent, RC_PAYSTATION)

3. Implemente o tratamento de resultados de pagamento:

override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
    super.onActivityResult(requestCode, resultCode, data)
    if (requestCode == RC_PAYSTATION) {
        val (status, _) = XPayments.Result.fromResultIntent(data)
        when (status) {
            XPayments.Status.COMPLETED -> Log.d("MainActivity", "Payment completed")
            XPayments.Status.CANCELLED -> Log.d("MainActivity", "Payment cancelled")
            XPayments.Status.UNKNOWN -> Log.d("MainActivity", "Status unknown")
        }
    }
}

Pagamentos de teste

Para testar o processo de pagamento, você pode usar o modo sandbox. O modo sandbox é um ambiente autônomo que suporta todos os recursos de um ambiente ativo, exceto pagamentos reais e recusados. Para ter acesso ao modo sandbox, você deve chamar o método isSandbox e passar true como argumento, ao criar um objeto IntentBuilder.

1. Execute seu aplicativo.
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.

Crie um pedido e abra a interface de pagamento

1. Para criar um pedido com os dados do usuário e do item no lado da Xsolla, chame o método SDK FetchPaymentToken, passando os seguintes parâmetros a ele:

1. • AuthToken — o token de autenticação do usuário, obtido durante a autenticação usando o Xsolla Login.

1. • 1. • — o SKU do item que o usuário quer comprar.ItemSKU
          1. • SuccessCallback - o retorno de chamada acionado ao receber o token de pagamento com sucesso.
          1. • ErrorCallback — o retorno de chamada de erro de solicitação.
          1. • PurchaseParams — parâmetros de compra e da interface de pagamento do usuário, tal como a localização e a moeda (opcional).
          Observação

          Por padrão, o tempo de vida do token é de 24 horas. Se quiser alterar esse valor, contate seu Gerente de Sucesso do Cliente ou envie um e-mail para csm@xsolla.com. O novo valor será habilitado para todos os projetos da empresa criados na Conta de Distribuidor.
          2. Implemente a abertura da interface de pagamento. Para fazer isso, chame o método SDK LaunchPaymentConsole, passando os seguintes parâmetros a ele:
          1. • WorldContextObject — o objeto de contexto global (para chamadas C++).
          1. • OrderId — o ID do pedido.
          1. • AccessToken — o token de pagamento.
          1. • SuccessCallback — o retorno de chamada acionado ao receber o token de pagamento com sucesso.
          1. • ErrorCallback — o retorno de chamada de erro de solicitação.
          1. • BrowserClosedCallback — o retorno de chamada de fechamento do navegador. O evento é rastreado apenas ao abrir a interface de pagamento do usuário no navegador integrado. Os eventos de navegadores externos não são rastreados.
          1. • PayStationVersion — a versão Pay Station. Por padrão, a versão 4 é usada.

          Pagamentos de teste

          Para testar o processo de pagamento, você pode usar o modo sandbox. O modo sandbox é um ambiente autônomo que suporta todos os recursos de um ambiente ativo, exceto pagamentos reais e recusados. Para ter acesso ao modo sandbox, você deve ter a caixa Enable Sandbox marcada no Unreal Editor na seção Settings > Project Settings > Plugins > Xsolla Settings > Purchases (marcado por padrão).

          Observação

          Antes de assinar um contrato com a Xsolla, o teste do processo de pagamento só fica disponível no modo sandbox.

          O teste não requer o saque de dinheiro de contas bancárias reais.

          1. Execute seu aplicativo ou mapa no Unreal Editor.
          2. Escolha o método de pagamento Cartão bancário.
          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.
          Observação

          Além dos detalhes do cartão, você precisa especificar o CEP se pelo menos uma das seguintes condições for verdadeira:

          • O país do usuário for os EUA ou Canadá.
          • O Número de Identificação Bancária (BIN) indica que um cartão foi emitido nos EUA.

          Você pode especificar qualquer CEP válido (por exemplo, 12345). Isso determina a taxa de imposto sobre vendas e não afeta o andamento do pagamento do teste.
          Os pagamentos com cartão bancário no modo sandbox podem ser feitos nas seguintes moedas: USD, EUR, RUB, GBP, AED, ALL, AMD, ARS, AUD, AZN, BGN, BRL, BYN, CAD, CHF, CLP, CNY, COP, CZK, DKK, DZD, EGP, GEL, HKD, HRK, HUF, IDR, ILS, INR, ISK, JPY, KES, KGS, KRW, KZT, MAD, MDL, MKD, MNT, MXN, MYR, NGN, PEN, PHP, PKR, PLN, RON, RSD, SAR, SEK, SGD, THB, TRY, TWD, UAH, UYU, UZS, VEF, VND, ZAR.

          Aviso

          No modo sandbox, você pode testar um pagamento único e um pagamento com métodos de pagamento salvos usando cartões bancários e o PayPal.

          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.