{"metadata":{"image":[],"title":"","description":""},"api":{"url":"","auth":"required","settings":"","examples":{"codes":[]},"params":[],"results":{"codes":[]}},"next":{"description":"","pages":[]},"title":"Introdução","type":"basic","slug":"pagar-boleto-introducao","excerpt":"Você está em: *\"Pagar com Boleto > Introdução\"*","body":"A geração de um boleto não envolve transmissão de dados sensíveis como número de cartão de crédito. Por isso, basta consumir o endpoint de pagamento para gerar o boleto registrado.\n\nPara gerar um boleto bancário via integração, é bem simples e requer apenas dois passos:\n\n1. **Crie a transação**, informando o item/produto/serviço, valor, quantidade, etc;\n\n2. **Associe à forma de pagamento via boleto**, informando o <code>charge_id</code> da transação criada e os dados do cliente.\n\nCada transação possui um <code>charge_id</code>, que é um identificador próprio e é usado para associar à forma de pagamento via boleto bancário. O status da cobrança será alterado conforme sua situação, por exemplo:\n\n- Ao gerar uma cobrança (também chamada de transação), esta possui o status inicial de <code>new</code> (<a href=\"https://gerencianet.com.br/wp-content/uploads/2018/07/exemplo-null-para-new.png\" alt=\"Exemplo de status new\" target=\"_blank\">exemplo</a>), ou seja, a cobrança foi gerada e está aguardando a definição da forma de pagamento;\n\n- Assim que essa transação tem sua forma de pagamento definida, seu status é alterado de <code>new</code> para <code>waiting</code> (<a href=\"https://gerencianet.com.br/wp-content/uploads/2018/07/exemplo-new-para-waiting.png\" target=\"_blank\" alt=\"Exemplo de new para waiting\">exemplo</a>), ou seja, a forma de pagamento foi selecionada e está aguardando a confirmação do pagamento;\n\n- Quando a transação tem o pagamento confirmado, o status é alterado de <code>waiting</code> para <code>paid</code> (<a href=\"https://gerencianet.com.br/wp-content/uploads/2018/07/exemplo-waiting-para-paid.png\" alt=\"Exemplo de waiting para paid\" target=\"_blank\">exemplo</a>), ou seja, o pagamento da transação foi confirmado;\n\n- Caso o boleto não tenha seu pagamento confirmado, em 1 (um) dia corrido após sua data de vencimento seu status será alterado de <code>waiting</code> para <code>unpaid</code> (<a href=\"https://gerencianet.com.br/wp-content/uploads/2018/07/exemplo-waiting-para-unpaid.png\" alt=\"Exemplo de waiting para unpaid\" target=\"_blank\">exemplo</a>);\n\n- Se o boleto tiver o pagamento confirmado posteriormente à notificação enviada de <code>unpaid</code>, enviaremos uma nova notificação com tal confirmação, ou seja, alterado do status <code>unpaid</code> para <code>paid</code> (<a href=\"https://gerencianet.com.br/wp-content/uploads/2018/07/exemplo-unpaid-para-paid.png\" alt=\"Exemplo de unpaid para paid\" target=\"_blank\">exemplo</a>);\n\n- Caso o integrador confirme manualmente o pagamento de uma transação pelo painel de sua conta Gerencianet, enviaremos uma notificação pela API com o status <code>settled</code> (<a href=\"https://gerencianet.com.br/wp-content/uploads/2018/07/exemplo-waiting-para-settled.png\" alt=\"Exemplo de status waiting para settled\" target=\"_blank\">exemplo</a>).\n\n# Próximos Passos\n\nAgora que você conhece sobre o processo de pagamento com boleto bancário, [que tal criar seu primeiro boleto](https://dev.gerencianet.com.br/docs/gerar-boleto)?","updates":[],"order":0,"isReference":false,"hidden":true,"sync_unique":"","link_url":"","link_external":false,"_id":"606f2ca7c5ba91007878345d","__v":20,"project":"575aeffae12cf20e002f306c","category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"Pagar com Boleto","slug":"pagar-com-boleto","order":6,"from_sync":false,"reference":false,"_id":"606f2ca6c5ba910078783432","createdAt":"2016-07-11T19:49:54.838Z","__v":0,"project":"575aeffae12cf20e002f306c","version":"606f2ca7c5ba9100787834c6"},"createdAt":"2016-07-12T15:07:12.675Z","githubsync":"","user":"57601a13af3e090e00108059","parentDoc":null,"version":{"version":"1.1.0","version_clean":"1.1.0","codename":"2021","is_stable":true,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["606f2ca6c5ba91007878342b","575af039a083950e004487f7","575af5c7ba4ed70e000ca288","606f2ca6c5ba91007878342c","606f2ca6c5ba91007878342d","606f2ca6c5ba91007878342e","606f2ca6c5ba91007878342f","5761a63d207db7170022fc14","5761b9a2b65324200072d79e","576832939f0bf4190014ffdf","576832c09f0bf4190014ffe1","576832cba151c10e004316f0","576832d5bb15f40e00a288ec","576832e107b1f30e0039c645","606f2ca6c5ba910078783430","606f2ca6c5ba910078783431","5783f78c5cbce30e0074e2b7","606f2ca6c5ba910078783432","606f2ca6c5ba910078783433","606f2ca6c5ba910078783434","606f2ca6c5ba910078783435","606f2ca6c5ba910078783436","606f2ca6c5ba910078783437","578529f887c9280e0090394b","606f2ca6c5ba910078783438","606f2ca6c5ba910078783439","606f2ca6c5ba91007878343a","606f2ca6c5ba91007878343b","606f2ca6c5ba91007878343c","606f2ca6c5ba91007878343d","606f2ca6c5ba91007878343e","606f2ca6c5ba91007878343f","606f2ca6c5ba910078783440","606f2ca6c5ba910078783441"],"_id":"606f2ca7c5ba9100787834c6","project":"575aeffae12cf20e002f306c","createdAt":"2016-06-10T16:51:06.080Z","releaseDate":"2016-06-10T16:51:06.080Z","__v":0,"forked_from":"575aeffae12cf20e002f306f"}}

Introdução

Você está em: *"Pagar com Boleto > Introdução"*

A geração de um boleto não envolve transmissão de dados sensíveis como número de cartão de crédito. Por isso, basta consumir o endpoint de pagamento para gerar o boleto registrado. Para gerar um boleto bancário via integração, é bem simples e requer apenas dois passos: 1. **Crie a transação**, informando o item/produto/serviço, valor, quantidade, etc; 2. **Associe à forma de pagamento via boleto**, informando o <code>charge_id</code> da transação criada e os dados do cliente. Cada transação possui um <code>charge_id</code>, que é um identificador próprio e é usado para associar à forma de pagamento via boleto bancário. O status da cobrança será alterado conforme sua situação, por exemplo: - Ao gerar uma cobrança (também chamada de transação), esta possui o status inicial de <code>new</code> (<a href="https://gerencianet.com.br/wp-content/uploads/2018/07/exemplo-null-para-new.png" alt="Exemplo de status new" target="_blank">exemplo</a>), ou seja, a cobrança foi gerada e está aguardando a definição da forma de pagamento; - Assim que essa transação tem sua forma de pagamento definida, seu status é alterado de <code>new</code> para <code>waiting</code> (<a href="https://gerencianet.com.br/wp-content/uploads/2018/07/exemplo-new-para-waiting.png" target="_blank" alt="Exemplo de new para waiting">exemplo</a>), ou seja, a forma de pagamento foi selecionada e está aguardando a confirmação do pagamento; - Quando a transação tem o pagamento confirmado, o status é alterado de <code>waiting</code> para <code>paid</code> (<a href="https://gerencianet.com.br/wp-content/uploads/2018/07/exemplo-waiting-para-paid.png" alt="Exemplo de waiting para paid" target="_blank">exemplo</a>), ou seja, o pagamento da transação foi confirmado; - Caso o boleto não tenha seu pagamento confirmado, em 1 (um) dia corrido após sua data de vencimento seu status será alterado de <code>waiting</code> para <code>unpaid</code> (<a href="https://gerencianet.com.br/wp-content/uploads/2018/07/exemplo-waiting-para-unpaid.png" alt="Exemplo de waiting para unpaid" target="_blank">exemplo</a>); - Se o boleto tiver o pagamento confirmado posteriormente à notificação enviada de <code>unpaid</code>, enviaremos uma nova notificação com tal confirmação, ou seja, alterado do status <code>unpaid</code> para <code>paid</code> (<a href="https://gerencianet.com.br/wp-content/uploads/2018/07/exemplo-unpaid-para-paid.png" alt="Exemplo de unpaid para paid" target="_blank">exemplo</a>); - Caso o integrador confirme manualmente o pagamento de uma transação pelo painel de sua conta Gerencianet, enviaremos uma notificação pela API com o status <code>settled</code> (<a href="https://gerencianet.com.br/wp-content/uploads/2018/07/exemplo-waiting-para-settled.png" alt="Exemplo de status waiting para settled" target="_blank">exemplo</a>). # Próximos Passos Agora que você conhece sobre o processo de pagamento com boleto bancário, [que tal criar seu primeiro boleto](https://dev.gerencianet.com.br/docs/gerar-boleto)?