---
title: "Simulador de Boleto Bancário (legado)"
url: "https://devcenter.stone.com.br/legacy-simulador-boleto"
image: "https://devcenter.stone.com.br/_og/d/c_Ocean.takumi,title_~U2ltdWxhZG9yIGRlIEJvbGV0byBCYW5jw6FyaW8gKGxlZ2Fkbyk,props_eyJ0aGVtZSI6eyJtb2RlIjoibGlnaHQiLCJjb2xvcnMiOnsicHJpbWFyeSI6IiMzMEE2NkQifX19,p_Ii9sZWdhY3ktc2ltdWxhZG9yLWJvbGV0byI,s_bZKbL11BZF3gaMcS.png"
---

# Simulador de Boleto Bancário

Cenários de boleto controlados por CEP do comprador no ambiente de testes.

Documentação legada do Pagar.me v5

Esta página descreve um conceito da **Pagar.me v5** (versão clássica). Para projetos novos, explore o **[API Catalog](https://devcenter.stone.com.br/catalog)**.

O Pagar.me oferece chaves transacionais de teste para validar funcionalidades de pagamento. Para simular transações de **boleto**, regras específicas devem ser seguidas onde diferentes CEPs do comprador acionam respostas distintas da API.

Escopo do simulador

As orientações abaixo só são válidas para o **simulador gateway** (`simulator`).

## [Cenários de teste](#cenários-de-teste)

O simulador suporta quatro resultados distintos baseados no CEP do endereço do comprador:

| CEP                | Cenário                                    |
| :----------------- | :----------------------------------------- |
| 01046010           | Boleto reconciliado como pagamento a menor |
| 57400000           | Boleto reconciliado como pagamento a maior |
| 70070300           | Boleto não reconciliado                    |
| Qualquer outro CEP | Boleto reconciliado com pagamento integral |

## [Requisitos](#requisitos)

Para testar cada cenário, você deve:

-   Usar o meio de pagamento `boleto`
-   Incluir um dos CEPs especificados no endereço do cliente
-   Fornecer todos os dados obrigatórios da API para criação de boleto

As operações disponíveis no simulador correspondem à API em produção — detalhes adicionais em [Boleto](https://devcenter.stone.com.br/legacy-boleto).

---

**Jornada: [Simuladores](https://devcenter.stone.com.br/legacy-overview-simulador)**  
Etapa 5 de 7

[**Etapa anterior**Simulador: Voucher](https://devcenter.stone.com.br/legacy-simulador-voucher)[**Próxima etapa**Simulador: Pix](https://devcenter.stone.com.br/legacy-simulador-pix)

Siga a Stone nas redes sociais

[](https://www.facebook.com/stonepagamentos/)[](https://x.com/sejastone/)[](https://www.instagram.com/stone/)[](https://br.linkedin.com/company/stone-co)[](https://www.youtube.com/channel/UCk4L4JykgoDkN8YeuxkNqIQ)

© Stone Instituição de Pagamento S.A. CNPJ 16.501.555/0001-57

Av. Rebouças, 2880, 4º andar, Pinheiros, CEP 05.402-500 – São Paulo/SP

Instituição de pagamento autorizada pelo Banco Central do Brasil, nas modalidades de credenciadora e emissora de moeda eletrônica.