Testar PayPal 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 seguro, você pode testar os seguintes cenários de interação da interface de pagamento para o PayPal:

• fazer pagamento de teste
• fazer reembolso
• fazer reembolso parcial
• estorno
• salvar conta
• excluir conta salva
• cobrar conta salva
• obter lista de contas salvas

Criar conta PayPal de teste

Para testar o processo de pagamento, você precisa criar uma conta para o modo sandbox do PayPal:

1. Abra o site Portal do Desenvolvedor PayPal.
2. Faça login na sua conta ou crie uma nova.
3. Vá para a aba Sandbox accounts.
4. Na página Sandbox test accounts, clique em Create account.
5. Selecione o tipo de conta Personal (Buyer Account) e escolha o país.
6. Clique em Create.

A conta criada é exibida na lista de contas sandbox.

Você também pode usar informações de contas sandbox existentes:

Testar compra única

Pagamentos de teste

1. Abra a interface do usuário de pagamento no modo sandbox.
2. Escolha o método de pagamento PayPal.
3. No campo Mock Response Code, digite 0 ou deixe o campo vazio.
4. No campo CEP, insira 5 dígitos quaisquer.

5. Clique em Pagar. Você será redirecionado para uma janela para fazer login em sua conta PayPal.
6. Insira as informações da sua conta sandbox: Email ID como o endereço de e-mail e System Generated Password como a senha. Para encontrar essas informações:
   1. Faça login na sua conta no site Portal do Desenvolvedor PayPal.
   2. Vá para a aba Sandbox accounts.
   3. Na página Sandbox test accounts, escolha uma conta sandbox.
   4. Clique em ••• e selecione Visualizar/Editar conta na lista suspensa. Você verá os dados na janela modal que for aberta.
7. Conclua o pagamento de teste.

O ID da transação é exibido na página após a conclusão do pagamento:

Depois de concluir um pagamento de teste bem-sucedido, sua conta PayPal é salva na lista de métodos de pagamento.

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.

Reembolso

1. Configure o webhook Reembolso.
2. Faça um pagamento de teste bem-sucedido.
3. 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

1. Configure o webhook Reembolso parcial.
2. Faça um pagamento de teste bem-sucedido.
3. 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.

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:

1. Configure o webhook Reembolso.
2. Faça um pagamento de teste bem-sucedido.
3. Chame o método da API Solicitar estorno.

Você receberá um webhook Refund com o seguinte código:

Testar conta salva

Salvar conta

Você pode testar salvar uma conta na interface de pagamento:

• ao fazer um pagamento de teste
• de uma conta de usuário

Salvar conta ao fazer o pagamento de teste

1. Configure o webhook Adicionar conta de pagamento.
2. Abra a interface de pagamento no modo sandbox.
3. Escolha PayPal como método de pagamento.
4. No campo Mock Response Code, digite 0 ou deixe o campo vazio.
5. No campo CEP, insira 5 dígitos quaisquer.
6. Marque a caixa Não perguntar novamente.
7. Clique em Pagar. Você será redirecionado para uma janela para fazer login em sua conta PayPal.
8. Insira as informações sobre sua conta sandbox.
9. Conclua o pagamento de teste.

Uma notificação sobre a adição de uma nova conta é enviada para o URL do webhook.

A conta salva é exibida na seção Métodos salvos.

Salvar conta na interface de pagamento

1. Configure o webhook Adicionar conta de pagamento.
2. Abra a interface de pagamento no modo sandbox.
3. Vá para Salvas.
4. Clique no ícone de lápis e escolha Adicionar novo método.
5. Escolha PayPal.
6. No campo Mock Response Code, digite 0 ou deixe o campo vazio.
7. No campo CEP, digite 5 dígitos quaisquer.
8. Clique em Salvar. Você será redirecionado para uma janela para fazer login em sua conta PayPal.
9. Para concluir as configurações, insira as informações sobre sua conta sandbox.
10. Clique em Save and Continue.

Uma notificação sobre a adição de uma nova conta é enviada para o URL do webhook.

A conta salva é exibida na seção Métodos salvos.

Excluir conta salva

Você pode testar a exclusão de uma conta salva:

• via API
• na interface de pagamento

Excluir conta salva via API

1. Configure o webhook Remover conta de pagamento.
2. Chame o método da API Excluir conta salva.

Uma notificação sobre a exclusão de uma conta é enviada para o URL do webhook.

Excluir conta salva na interface de pagamento

1. Configure o webhook Remover conta de pagamento.
2. Abra a interface de pagamento no modo sandbox.
3. Vá para Salvas.
4. Clique no ícone de lápis.
5. Clique em Editar métodos.
6. Escolha uma conta e clique no ícone da lixeira.

Uma notificação sobre a exclusão de uma conta é enviada para o URL do webhook.

Cobrar com saldo da conta salva

Você pode testar um pagamento com uma conta salva:

• via API
• na interface de pagamento

Cobrar saldo da conta salva via API

1. Configure o webhook Pagamento.
2. Salve a conta no modo sandbox.
3. Chame o método da API Cobrar com conta salva.

Uma notificação sobre o pagamento bem-sucedido é enviada para o URL do webhook.

Cobrar saldo da conta salva na interface de pagamento

1. Configure o webhook Pagamento.
2. Salve a conta no modo sandbox.
3. Abra a interface de pagamento no modo sandbox.
4. Selecione a conta na lista de contas de pagamento salvas.
5. Clique em Pagar.

Uma notificação sobre o pagamento bem-sucedido é enviada para o URL do webhook.

Obter lista de contas salvas

1. Salvar contas no modo sandbox.
2. Chame o método da API Obtém contas salvas.

Você receberá dados mascarados na resposta.

Gerar erros

1. Abra a interface de pagamento no modo sandbox.
2. Escolha o método de pagamento PayPal.
3. No campo Mock Response Code, insira um código de erro da lista que você deseja testar, ou deixe o campo vazio.
4. No campo CEP, insira 5 dígitos quaisquer.
5. Clique em Pagar. Você será redirecionado para sua conta PayPal para concluir o pagamento.

A mensagem de erro aparecerá na interface de pagamento.

Códigos de erro:

Última atualização: 12 de Setembro de 2024