Skip to main content
Este endpoint existe apenas no ambiente sandbox (apisandbox.delbank.com.br). Não está disponível em produção.
Durante o desenvolvimento, refazer um Pix real a cada teste é trabalhoso — exige dois apps de banco, saldo disponível e dependência de terceiros. A simulação resolve isso: com uma única chamada você dispara o pagamento de qualquer QR Code criado na sua conta, fazendo o sistema se comportar exatamente como se um pagador real tivesse escaneado e pago. O que acontece após a simulação é o mesmo que aconteceria com um pagamento real:
  • O evento PIX_RECEIVED é disparado para o seu webhook.
  • O valor é creditado no extrato da sua conta sandbox.
  • O status do QR Code passa para CONCLUDED.
  • O array payments da consulta passa a ter o pagamento registrado.

Como simular

Informe o transactionId ou correlationId do QR Code que você quer concluir:
Uma resposta 202 Accepted confirma que a simulação foi enfileirada. Os eventos de webhook e a atualização do extrato chegam em segundos.

Dados do pagador simulado

O ambiente sandbox usa um pagador fictício gerado automaticamente. Esses dados aparecerão no array payments da consulta e no payload do webhook:

Regras e comportamento

  • A simulação só funciona com QR Codes criados pela mesma conta que está fazendo a chamada.
  • O QR Code deve estar com status ACTIVE. Códigos expirados ou já cancelados retornam erro.
  • Se o QR Code tiver um amount definido, esse valor será usado na simulação.
  • Se o QR Code não tiver valor (caso comum na Cobrança Reutilizável com valor livre), o sandbox gera automaticamente um valor aleatório entre R1,00eR 1,00 e R 10,00.

Erros possíveis

Esse erro ocorre quando o transactionId ou correlationId não pertence à conta autenticada, ou o QR Code não existe.