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 Create payment token for purchase. 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.
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.

Abertura da interface de pagamento

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.

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. 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.
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.

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: 3 de Outubro 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!