Acessando a página Boletos
Para abrir a página Boletos, clique em Pagamentos → Boletos no menu lateral esquerdo. A página mostra os boletos em uma tabela de dados, com as seguintes colunas:
- ID: o identificador do boleto.
- Tipo: o tipo do boleto.
- Valor: o valor do boleto.
- Data de vencimento: a data de vencimento do boleto.
- Status: o estado atual do ciclo de vida (veja Estados).
- Criado em: a data em que você emitiu o boleto.
- Ações: a ação de cancelar, quando o estado permite.
Emitindo um boleto
1
Na página Boletos, clique em Emitir novo boleto. Um painel lateral abre.
2
Preencha os campos:
- Valor (obrigatório): o valor do boleto (R$).
- Data de vencimento (obrigatório): a data em que o pagador deve pagar o boleto. Ela não pode estar no passado.
- Ledger: o ledger selecionado no cabeçalho do Console. Você não pode alterá-lo no painel.
- Conta (obrigatório): a conta do Midaz a associar ao boleto. Digite o alias exato ou o ID completo dela e selecione-a nos resultados.
- Tipo (obrigatório): Tradicional, o único tipo que o serviço aceita.
- CPF / CNPJ (obrigatório): o documento fiscal do pagador.
- Nome completo (obrigatório): o nome completo do pagador.
- Rua (obrigatório): o logradouro do pagador.
- Número (obrigatório): o número do endereço.
- Complemento (opcional): apartamento, sala ou informação adicional do endereço.
- Bairro (obrigatório): o bairro do pagador.
- Cidade (obrigatório): a cidade do pagador.
- UF (obrigatório): o estado do pagador.
- CEP (obrigatório): o CEP do pagador.
- Instruções (opcional): instruções de pagamento do boleto.
3
Clique em Emitir boleto.
4
A página de detalhes do boleto abre. Quando o provedor devolve a linha digitável e o código de barras, o card Dados de pagamento mostra os dois.
Estados do boleto
Um boleto passa pelos seguintes estados:
- Pendente: o provedor ainda não confirmou o boleto.
- Criado: o provedor registrou o boleto e o pagador pode pagá-lo.
- Liquidado: o pagador pagou o boleto.
- Cancelado: o boleto foi cancelado antes do pagamento.
- Inativado: o provedor inativou o boleto. O pagador não pode mais pagá-lo.
- Com falha: a emissão do boleto não foi concluída (veja Tratamento de erros).
Cancelando um boleto
Você pode cancelar um boleto no estado Criado. Clique no ícone de cancelar na coluna Ações, ou em Cancelar boleto na página de detalhes. Informe um Motivo e clique em Cancelar boleto para confirmar.
Tratamento de erros
O formulário verifica cada campo antes de enviar a requisição. Se o serviço recusa a requisição, aparece uma mensagem de erro. Um boleto cuja emissão não foi concluída mostra o estado Com falha. A página de detalhes dele mostra os Detalhes da falha no Histórico de status. Se um envio não recebe resposta, o painel mostra um aviso. Confira a lista Boletos antes de enviar o formulário de novo. Se você alterou o formulário ou o ledger do cabeçalho depois desse envio, Emitir boleto fica desabilitado. Para emitir o boleto como um novo, clique em Enviar como novo, confirme e depois clique em Emitir boleto. Se o último envio foi processado, o novo envio pode emitir um segundo boleto.