Simulador
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édito | Cenário |
---|---|
5363 8790 0785 3788 | Em análise -> Aprovado |
4473 6564 9854 2827 | Em 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 paraPAID
.
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 parastatus=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 parastatus=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ção | Cená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 parastatus=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ção | Cenário |
---|---|
Menor ou igual a R$ 100,00 | Pago instantaneamente |
Maior que R$ 100,00 e menor igual a R$ 200,00 | Pago com delay de 5 minutos |
Maior que R$ 200,00 e menor igual a R$ 300,00 | Aguardando Pagamento |
Maior que R$ 300 | Aguardando Pagamento |
Importante:
PIX realizados através da API PIX não estão contemplados no simulador.
Updated 10 months ago