Personalizar Layout do Boleto

Como Criar um Boleto Personalizado

Você pode personalizar seus boletos com logotipo, cores e informações adicionais para reforçar a identidade visual da sua empresa.

Opções de Personalização

Logotipo da empresa no boleto
Instruções personalizadas
Mensagens para o pagador
Informações adicionais no corpo do boleto

Exemplo de Requisição com Personalização

curl -X POST "https://sandbox.boletocloud.com/api/v1/boletos" \
  -u "api-key_SUA-API-KEY:token" \
  -d "boleto.conta.token=TOKEN_DA_CONTA" \
  -d "boleto.emissao=2024-01-15" \
  -d "boleto.vencimento=2024-01-30" \
  -d "boleto.documento=PERS-001" \
  -d "boleto.titulo=DM" \
  -d "boleto.valor=450.00" \
  -d "boleto.instrucao1=Não receber após 30 dias do vencimento" \
  -d "boleto.instrucao2=Multa de 2% após o vencimento" \
  -d "boleto.instrucao3=Juros de 1% ao mês" \
  -d "boleto.informacao1=Pedido: #12345" \
  -d "boleto.informacao2=Cliente desde: 2020" \
  -d "boleto.informacao3=Central de atendimento: 0800-123-4567" \
  -d "boleto.pagador.nome=Carlos Oliveira" \
  -d "boleto.pagador.cprf=000.000.000-00" \
  -d "boleto.pagador.endereco.cep=00000-000" \
  -d "boleto.pagador.endereco.uf=MG" \
  -d "boleto.pagador.endereco.localidade=Belo Horizonte" \
  -d "boleto.pagador.endereco.bairro=Savassi" \
  -d "boleto.pagador.endereco.logradouro=Rua da Bahia" \
  -d "boleto.pagador.endereco.numero=1000" \
  -o boleto-personalizado.pdf

Response response = ClientBuilder.newClient()
    .target("https://sandbox.boletocloud.com/api/v1/boletos")
    .register(HttpAuthenticationFeature.basic("api-key_SUA-API-KEY", "token"))
    .request(WILDCARD)
    .post(Entity.form(new Form()
        .param("boleto.conta.token", "TOKEN_DA_CONTA")
        .param("boleto.emissao", "2024-01-15")
        .param("boleto.vencimento", "2024-01-30")
        .param("boleto.documento", "PERS-001")
        .param("boleto.titulo", "DM")
        .param("boleto.valor", "450.00")
        .param("boleto.instrucao1", "Não receber após 30 dias do vencimento")
        .param("boleto.instrucao2", "Multa de 2% após o vencimento")
        .param("boleto.instrucao3", "Juros de 1% ao mês")
        .param("boleto.informacao1", "Pedido: #12345")
        .param("boleto.informacao2", "Cliente desde: 2020")
        .param("boleto.informacao3", "Central de atendimento: 0800-123-4567")
        .param("boleto.pagador.nome", "Carlos Oliveira")
        .param("boleto.pagador.cprf", "000.000.000-00")
        .param("boleto.pagador.endereco.cep", "00000-000")
        .param("boleto.pagador.endereco.uf", "MG")
        .param("boleto.pagador.endereco.localidade", "Belo Horizonte")
        .param("boleto.pagador.endereco.bairro", "Savassi")
        .param("boleto.pagador.endereco.logradouro", "Rua da Bahia")
        .param("boleto.pagador.endereco.numero", "1000")));

import requests
from requests.auth import HTTPBasicAuth

response = requests.post(
    'https://sandbox.boletocloud.com/api/v1/boletos',
    auth=HTTPBasicAuth('api-key_SUA-API-KEY', 'token'),
    data={
        'boleto.conta.token': 'TOKEN_DA_CONTA',
        'boleto.emissao': '2024-01-15',
        'boleto.vencimento': '2024-01-30',
        'boleto.documento': 'PERS-001',
        'boleto.titulo': 'DM',
        'boleto.valor': '450.00',
        'boleto.instrucao1': 'Não receber após 30 dias do vencimento',
        'boleto.instrucao2': 'Multa de 2% após o vencimento',
        'boleto.instrucao3': 'Juros de 1% ao mês',
        'boleto.informacao1': 'Pedido: #12345',
        'boleto.informacao2': 'Cliente desde: 2020',
        'boleto.informacao3': 'Central de atendimento: 0800-123-4567',
        'boleto.pagador.nome': 'Carlos Oliveira',
        'boleto.pagador.cprf': '000.000.000-00',
        'boleto.pagador.endereco.cep': '00000-000',
        'boleto.pagador.endereco.uf': 'MG',
        'boleto.pagador.endereco.localidade': 'Belo Horizonte',
        'boleto.pagador.endereco.bairro': 'Savassi',
        'boleto.pagador.endereco.logradouro': 'Rua da Bahia',
        'boleto.pagador.endereco.numero': '1000'
    }
)

if response.status_code == 201:
    with open('boleto-personalizado.pdf', 'wb') as f:
        f.write(response.content)

Campos de Personalização

Campo	Descrição
`boleto.instrucao1` a `boleto.instrucao5`	Instruções exibidas no campo “Instruções” do boleto
`boleto.informacao1` a `boleto.informacao8`	Informações adicionais no corpo do boleto

Veja Também

Sobrescrever Mensagens - Como alterar mensagens padrão
Criar Boleto - Referência completa de criação de boletos
Campos do Boleto - Todos os campos disponíveis
Instruções de Cobrança - Configurar instruções no boleto