Testes no Sandbox

Simule o ciclo completo de todos os métodos sem movimentar dinheiro real.

Sandbox é sempre simulado

No Sandbox, PIX, SPEI, MB WAY, boleto, transferências bancárias, PSE, Nequi, Bre-B, cartão e os demais métodos nunca acionam adquirentes, bancos ou liquidantes reais. Use exclusivamente https://sandbox.api.leonapay.com.br e uma chave Sandbox.

Método	Como testar
`PIX`	`Crie a cobrança e simule PAID, FAILED ou EXPIRED pelo ID`
`Boleto`	`Crie o boleto e simule PAID, FAILED ou EXPIRED pelo ID`
`SPEI`	`Crie a transferência e simule PAID, FAILED ou EXPIRED pelo ID`
`MB WAY`	`Crie a autorização e simule PAID, FAILED ou EXPIRED pelo ID`
`BANK_TRANSFER, PSE, NEQUI e BREB`	`Crie a operação local e simule PAID, FAILED ou EXPIRED pelo ID`
`Crédito e débito`	`Use um dos cartões de teste documentados na página do cartão`

Passo a passo para PIX e outros métodos

Primeiro crie o pagamento normalmente no Sandbox e guarde data.id. Depois envie esse ID ao simulador com o status desejado. Por fim, confira o webhook e consulte a transação para validar a integração.

curl --request POST \
+  --url https://sandbox.api.leonapay.com.br/api/v2/payments \
+  --header 'Accept: application/json' \
+  --header 'Content-Type: application/json' \
+  --header 'x-api-key: {your_api_key}' \
+  --header 'idempotency-key: {unique_uuid_per_payment}' \
  --data '{"method":"PIX","amount":10.00,"currency":"BRL","reference":"teste-sandbox-001","payer":{"name":"Cliente Teste","taxId":"12345678909"}}'

Como simular o resultado no Sandbox

Crie o pagamento usando a chave e a Base URL do Sandbox. PIX, boleto, SPEI, MB WAY, transferências bancárias, PSE, Nequi e Bre-B permanecem aguardando até você enviar o resultado desejado ao endpoint de simulação. Use o ID retornado na criação do pagamento.

Troque PAID por FAILED ou EXPIRED para testar os outros cenários. A simulação aceita somente pagamentos da mesma empresa e do ambiente Sandbox.

Status	Resultado simulado
`PAID`	`Pagamento confirmado e webhook payment.paid emitido`
`FAILED`	`Pagamento recusado e webhook payment.failed emitido`
`EXPIRED`	`Cobrança expirada e webhook payment.expired emitido`

curl --request POST \
  --url https://sandbox.api.leonapay.com.br/api/v2/simulations/payments/{paymentId} \
  --header 'x-api-key: {sandbox_api_key}' \
  --header 'Content-Type: application/json' \
  --data '{"status":"PAID"}'

O que validar após a simulação

Confirme que a consulta retorna o novo status, que o webhook correspondente chegou uma única vez e que a referência do seu pedido foi conciliada. Repita o teste com PAID, FAILED e EXPIRED.

Nunca use uma chave de Produção nesses testes. O endpoint de simulação não possui fallback para Produção.