O Simulador é um conjunto de regras do ambiente de testes do PagBank na qual você pode simular cenários que podem ocorrer no ambiente Produção. Dessa forma, você pode construir uma solução completa sem abrir mão da segurança e praticidade de um ambiente de testes. Atualmente, o Simulador cobre os cenários relacionados à:

  • Transações com cartão de crédito com status "Em análise"
  • Pagamento com Boleto
  • Pagamento com PIX

Transações com cartão de crédito com status "Em análise"

Para simular transações de cartão de crédito com análise de risco, definimos algumas regras que devem ser utilizadas. Cada uma dessas regras implica em uma resposta específica da API. Dessa forma, você pode testar os cenários de maneira completa, verificando como tratar as respostas da nossa API e entendendo totalmente o funcionamento dela.

De forma a testar cada cenário apresentado na tabela abaixo é preciso considerar os seguintes requerimentos para o envio da solicitação:

  • Número de cartão com uma data de expiração futura.
  • Método de pagamento credit_card .
  • Demais dados obrigatórios para a criação de um pedido, cobrança ou assinatura.
Número do cartão de créditoCenário
5363 8790 0785 3788Em análise -> Aprovado
4473 6564 9854 2827Em análise -> Negado

O código de segurança (CVV) e a data de expiração do cartão podem ser escolhidos por você. No entanto, é necessário que o código de segurança contenha três dígitos e a data de expiração seja maior que a data no momento da solicitação.

📘

Transações pré-autorizadas.

Caso seja feita uma transação de pré-autorização e ela seja aprovada, o status da transação mudará para AUTHORIZED. Dessa forma, ainda é necessário realizar a captura do pagamento para que o status seja atualizado para PAID.

Pagamentos com Boleto

Os pagamento com Boleto podem resultar em dois status distintos. O primeiro é relacionado com o cenário onde o Boleto é pago corretamente. Já no segundo, o Boleto não é pago e acaba expirando. Essas duas situações são cobertas pelo Simulador e descritas com mais detalhes abaixo:

  • Cenário de sucesso: A transação é criada com status= waiting. Por se tratar de um ambiente de simulação, segundos após a criação do pedido, ele é automaticamente considerado pago ou pago com delay de cinco minutos, conforme gatilho escolhido da tabela abaixo. Dessa forma, o status do pedido será alterado para status=paid.
  • Cenário de cancelamento: A transação é criada e com status= waiting, igual no cenário anterior. Por se tratar de um ambiente de simulação, segundos após a criação do pedido, ele é automaticamente cancelado ou cancelado com delay de cinco minutos, conforme gatilho escolhido da tabela abaixo. Dessa forma, o status do pedido será alterado para status=canceled.

A identificação pelo Simulador do cenário desejado é baseado no valor da transação enviada. A tabela abaixo descreve os valores que devem ser utilizados para cada um dos cenários de teste disponível.

Valor da transaçãoCenário
Menor ou igual a R$ 100,00.Pago instantaneamente.
Maior que R$ 100,00 e menor ou igual a R$ 200,00.Pago com delay de 5 minutos.
Maior que R$ 200,00 e menor ou igual a R$ 300,00.Cancelado por expiração com delay de 5 minutos.
Maior que R$ 300,00 e menor ou igual a R$ 400,00.Cancelado por expiração instantaneamente.

Pagamentos com PIX

Os pagamentos com PIX podem resultar em dois status distintos, sendo: paid ou waiting. Essas duas situações são cobertas pelo Simulador e descritas com mais detalhes abaixo:

  • Cenário de sucesso: A transação é criada com status= waiting. Por se tratar de um ambiente de simulação, segundos após a criação do pedido, ele é automaticamente considerado pago ou pago com delay de cinco minutos, conforme gatilho escolhido da tabela abaixo. Dessa forma, o status do pedido será alterado para status=paid.

A identificação pelo Simulador do cenário desejado é baseado no valor da transação enviada. A tabela abaixo descreve os valores que devem ser utilizados para cada um dos cenários de teste disponível.

Valor da transaçãoCenário
Menor ou igual a R$ 100,00Pago instantaneamente
Maior que R$ 100,00 e menor igual a R$ 200,00Pago com delay de 5 minutos
Maior que R$ 200,00 e menor igual a R$ 300,00Aguardando Pagamento
Maior que R$ 300Aguardando Pagamento

❗️

Importante:

PIX realizados através da API PIX não estão contemplados no simulador.