Boleto Híbrido com Pix

Como Criar um Boleto com Pix

O boleto híbrido (também conhecido como Boleto + Pix) permite que o pagador escolha entre pagar via código de barras tradicional ou via QR Code Pix, oferecendo mais conveniência e agilidade no pagamento.

Vantagens do Boleto com Pix

Pagamento instantâneo - Pix é processado em segundos, 24/7
Maior conversão - Oferece duas opções de pagamento
Reconciliação automática - Mesmo token para ambos os métodos
QR Code no boleto - Integrado visualmente ao PDF

Pré-requisitos

Conta bancária com Pix habilitado
Chave Pix cadastrada na conta

Exemplo de Requisiçã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=PIX-001" \
  -d "boleto.titulo=DM" \
  -d "boleto.valor=199.90" \
  -d "boleto.pix=true" \
  -d "boleto.pagador.nome=Ana Paula" \
  -d "boleto.pagador.cprf=000.000.000-00" \
  -d "boleto.pagador.endereco.cep=00000-000" \
  -d "boleto.pagador.endereco.uf=PR" \
  -d "boleto.pagador.endereco.localidade=Curitiba" \
  -d "boleto.pagador.endereco.bairro=Batel" \
  -d "boleto.pagador.endereco.logradouro=Av. Batel" \
  -d "boleto.pagador.endereco.numero=1500" \
  -o boleto-pix.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", "PIX-001")
        .param("boleto.titulo", "DM")
        .param("boleto.valor", "199.90")
        .param("boleto.pix", "true")
        .param("boleto.pagador.nome", "Ana Paula")
        .param("boleto.pagador.cprf", "000.000.000-00")
        .param("boleto.pagador.endereco.cep", "00000-000")
        .param("boleto.pagador.endereco.uf", "PR")
        .param("boleto.pagador.endereco.localidade", "Curitiba")
        .param("boleto.pagador.endereco.bairro", "Batel")
        .param("boleto.pagador.endereco.logradouro", "Av. Batel")
        .param("boleto.pagador.endereco.numero", "1500")));

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': 'PIX-001',
        'boleto.titulo': 'DM',
        'boleto.valor': '199.90',
        'boleto.pix': 'true',
        'boleto.pagador.nome': 'Ana Paula',
        'boleto.pagador.cprf': '000.000.000-00',
        'boleto.pagador.endereco.cep': '00000-000',
        'boleto.pagador.endereco.uf': 'PR',
        'boleto.pagador.endereco.localidade': 'Curitiba',
        'boleto.pagador.endereco.bairro': 'Batel',
        'boleto.pagador.endereco.logradouro': 'Av. Batel',
        'boleto.pagador.endereco.numero': '1500'
    }
)

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

Parâmetro Principal

Campo	Valor	Descrição
`boleto.pix`	`true`	Habilita o QR Code Pix no boleto

Veja Também

Bancos Suportados - Verifique quais bancos suportam Pix
Criar Boleto - Referência completa de criação de boletos
Campos do Boleto - Todos os campos disponíveis
Conta Bancária - Configurar a conta bancária