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.
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.
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.
- Abra a interface de pagamento no modo sandbox.
- Escolha o método de pagamento Cartão do banco.
- 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.
- Clique em Pay.
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.
Para ver informações detalhadas, incluindo taxas, sobre as transações feitas no modo sandbox:
- Abra sua Conta de Distribuidor.
- Vá para Accounting > Transaction registry.
- 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.
Encontrou um erro de texto ou digitação? Selecione o texto e pressione Ctrl+Enter.