Cartões de teste no 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 “mode”:“sandbox”
ao obter o token.
Para abrir a interface de pagamento, use este link e especifique o token obtido lá: https://sandbox-secure.xsolla.com/paystation4/?token={token}
.
No modo sandbox, você pode testar os seguintes cenários de interação da interface de pagamento ao fazer um pagamento com um cartão bancário:
- fazer um pagamento de teste
- reembolso
- reembolso parcial
- bloqueio de transações fraudulentas
- estorno
- salvamento de cartões
- exclusão de cartões salvos
- cobrança de cartões salvos
- obter a lista de cartões salvos
Testar compra única
Fazer um pagamento de teste
- 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.
Reembolso
- Configure o webhook Reembolso.
- Faça um pagamento de teste bem-sucedido.
- Chame o método da API Solicitar reembolso.
Uma notificação sobre o reembolso do pagamento será enviada para o URL do webhook.
Reembolso parcial
- Configure o webhook Reembolso parcial.
- Faça um pagamento de teste bem-sucedido.
- Chame o método da API Solicitar reembolso parcial.
Uma notificação sobre o reembolso parcial do pagamento será enviada para o URL do webhook.
Bloqueio de transações fraudulentas
- Configure o webhook Transação rejeitada pelo AFS.
- Faça um pagamento de teste com este cartão:
Cartão | País | 3-D Secure |
---|---|---|
Número do cartão: 5159084825528450 Data de validade: 12/40 CVV2: 3 dígitos quaisquer Bandeira do cartão: Mastercard | EUA | Não |
Estorno
Desenvolvemos uma chamada de API separada para o modo sandbox para testar esse cenário sem qualquer participação de um banco.
Para testar o estorno:
- Configure o webhook Reembolso.
- Faça um pagamento de teste bem-sucedido.
- Chame o método da API Solicitar estorno.
Você receberá um webhook Refund com o seguinte código:
Código | Motivo | Descrição |
---|---|---|
2 | Chargeback | Estorno de transação solicitado. |
Testar cartões salvos
Como salvar cartões
Você pode testar o salvamento de um cartão de duas maneiras:Salvamento de cartões ao fazer pagamentos de teste
- Configure o webhook Adicionar conta de pagamento.
- Abra a interface de pagamento no modo sandbox.
- Escolha o método de pagamento Cartão bancário.
- Insira os dados do cartão bancário. Você também pode especificar dados incorretos (número do cartão ou data de validade) para testar se um erro é gerado.
- Marque a caixa Salvar este cartão para pagamentos futuros.
- Clique em Pagar agora.
Uma notificação sobre a adição de um novo cartão será enviada para o URL do webhook.
O cartão salvo será exibido na seção Métodos salvos.
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.
Salvamento de cartões a partir da conta de usuário
- Configure o webhook Adicionar conta de pagamento.
- Abra a interface de pagamento no modo sandbox.
- Vá para Salvos.
- Clique no ícone de lápis e escolha Adicionar novo método.
- Clique em Cartão do banco.
- Insira os dados do cartão bancário. Você também pode especificar dados incorretos (número do cartão ou data de validade) para testar se um erro é gerado.
- Clique em Salvar.
Uma notificação sobre a adição de um novo cartão será enviada para o URL do webhook.
O cartão salvo será exibido na seção Métodos salvos.
Exclusão de cartões salvos
Você pode testar a exclusão de um cartão salvo de duas maneiras:Exclusão de cartões salvos via API
- Configure o webhook Remover conta de pagamento.
- Chame o método da API Excluir conta salva.
Uma notificação sobre a exclusão de um cartão será enviada para o URL do webhook.
Exclusão de cartões salvos na interface de pagamento
- Configure o webhook Remover conta de pagamento.
- Abra a interface de pagamento no modo sandbox.
- Vá para Salvos.
- Clique no ícone de lápis.
- Clique em Editar métodos.
- Escolha um cartão e clique no ícone da lixeira.
Uma notificação sobre a exclusão de um cartão será enviada para o URL do webhook.
Cobrança de cartões salvos
Você pode testar um pagamento com um cartão salvo das seguintes maneiras:- uma cobrança única (por exemplo, compra com um cartão salvo)
- cobranças regulares (por exemplo, pagamento de assinaturas)
Cobrança de cartões salvos via API
- Configure o webhook Pagamento.
- Salve o cartão no modo sandbox.
- Chame o método da API Cobrar com conta salva.
Uma notificação sobre um pagamento bem-sucedido será enviada para o URL do webhook.
Cobrança de cartão salvo na interface de pagamento
- Configure o webhook Pagamento.
- Salve o cartão no modo sandbox.
- Abra a interface de pagamento no modo sandbox.
- Selecione o cartão na lista de contas de pagamento salvas.
- Clique em Pagar.
Uma notificação sobre um pagamento bem-sucedido será enviada para o URL do webhook.
Obter lista de cartões salvos
- Salve cartões no modo sandbox.
- Chame o método da API Obtém contas salvas.
Você receberá dados mascarados na resposta.
Encontrou um erro de texto ou digitação? Selecione o texto e pressione Ctrl+Enter.