Pular para o conteúdo

Cenários · Pix

Confrapix

Cenários de Pix acionados no playground e no detalhe da cobrança.

Onde acionar: Playground → criar Pix → detalhe da cobrança (simular resultado / aplicar cenário).

Cenários disponíveis

  • Aprovação (approved → succeeded)

    Como acionar: No detalhe da cobrança Pix, escolha o cenário Aprovação e confirme o pagamento simulado (ou use o seletor no QR).

    Resultado esperado: transaction.status = succeeded, confirmed = true, payed_in preenchido, scenario = approved.

  • Recusa (declined)

    Como acionar: Selecione Recusa no seletor de cenário antes de simular o Pix.

    Resultado esperado: transaction.status = declined, confirmed = true, payed_in = null.

  • Expiração (expired)

    Como acionar: Selecione Expiração no seletor de cenário.

    Resultado esperado: transaction.status = expired, confirmed = true, expired_in atualizado.

  • Estorno (refunded)

    Como acionar: Só após a cobrança estar paga (succeeded). No detalhe, aplique o cenário Estorno.

    Resultado esperado: transaction.status = refunded, confirmed = true. Falha se a cobrança ainda não estiver paga.

Cartões e valores mágicos

  • Valor de exemplo

    12,00

    Qualquer valor > 0 cria a cobrança; o resultado depende do cenário escolhido, não do valor.

  • Documento de teste

    123.123.123-00

    CPF/CNPJ válidos em formato; não há documento mágico que mude o status no Pix.

Limitações conhecidas

  • A simulação de resultado é local no portal; não altera o host sandbox.confrapix.com.br.
  • Não há cartão no fluxo Pix — só cenários no seletor.
  • Estorno exige cobrança já succeeded; não dá para estornar processing.
  • Callbacks só disparam se callback_url foi informado na criação.

← Voltar ao guia de cenários