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 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.
Seu progresso
Obrigado pelo seu feedback!
Última atualização: 4 de Setembro 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!