Boleto registrado continua sendo um dos meios de pagamento mais rentáveis do e-commerce brasileiro. Este guia mostra como a integração direta funciona — emissão, registro, baixa automática e conciliação — e o que exigir de um módulo profissional para Magento 2.

O PIX dominou as conversas sobre pagamentos, mas o boleto registrado segue movimentando uma fatia relevante do varejo brasileiro: ticket alto, compradores corporativos, departamentos financeiros que precisam de documento formal e clientes que simplesmente preferem pagar no banco, na lotérica ou pelo app. Se você vende para empresas ou produtos de valor elevado, ignorar o boleto é deixá-lo na mesa.

Neste guia, mostramos como a integração direta funciona no Magento 2 — sem intermediário e sem percentual por venda — usando as APIs oficiais de cobrança do Itaú e do C6 Bank, implementadas nos módulos HEX.

Por que boleto registrado ainda vende

• Ticket alto: compras acima de R$ 1.000 têm forte aderência ao boleto, onde o cartão estoura limite.
• B2B: empresas pagam por boleto como regra, não exceção — nota fiscal formal, fluxo de contas a pagar.
• Sem chargeback: diferente do cartão, não existe contestação posterior que devolva o valor.
• Custo previsível: tarifa fixa por título liquidado (no Itaú, em torno de R$ 7–8 por boleto na tabela geral; planos de serviços reduzem bastante — confira seu pacote PJ).

A palavra-chave é registrado: o título fica registrado na clearing do banco, vinculado ao pagador — compensação garantida e rastreabilidade total.

Como funciona o fluxo da API de cobrança registrada

1. Emissão síncrona: ao finalizar o pedido, o módulo registra o boleto na API do banco antes mesmo de concluir a compra — linha digitável e código de barras nascem imediatamente, e o cliente já sai da página de sucesso podendo pagar.
2. Linha digitável em todo lugar: exibida na página de sucesso com botão de copiar, nos dados do pagamento no admin, em "Meus Pedidos" e nos e-mails transacionais.
3. Conciliação automática: uma rotina agendada consulta os títulos pendentes na API. Pago? Fatura criada, e-mail disparado e pedido movido para processamento — zero intervenção humana.
4. Cancelamento automático: boleto que passou do vencimento sem liquidação cancela o pedido sozinho (no Itaú, com um dia de carência após o vencimento).

Checklist: o que exigir de um módulo profissional

• Registro automático na emissão — nunca boleto "comum" (sem registro não há compensação garantida).
• Emissão síncrona integrada ao checkout: erro do banco bloqueia o pedido em vez de gerar título fantasma.
• Conciliação automática com fatura, e-mail e mudança de estado nativa do Magento.
• Linha digitável disponível para o cliente recomprar o acesso depois (página do pedido).
• Cancelamento automático pós-vencimento, com política de carência configurada.
• Certificados mTLS armazenados com segurança e logs auditáveis sem expor credenciais.
• Guest checkout e Firecheckout funcionando sem gambiarras.

Integração direta com o Itaú

O módulo de boleto registrado Itaú para Magento 2 usa a API oficial Cash Management v2 do banco (/boletos) com autenticação OAuth 2.0 e certificado digital mTLS. A emissão acontece no fechamento do pedido com retorno imediato de linha digitável e código de barras; a conciliação roda por rotina horária criando fatura e enviando e-mail quando o título entra como pago. O PDF é gerado localmente pela própria loja (layout Itaú), protegido por URL assinada — funciona sempre, independente de endpoint de PDF do banco.

Integração direta com o C6 Bank

O módulo de boleto registrado C6 Bank para Magento 2 integra a API BaaS do C6 (bank_slips): mesma disciplina de emissão síncrona no checkout, com o diferencial de usar o PDF oficial emitido pelo próprio banco, arquivado na loja e disponibilizado ao cliente. O identificador externo do boleto é o número do pedido — amarração limpa entre banco e Magento. Tarifas do BaaS são negociadas por contrato; para volumes, costuma ser competitivo.

Itaú x C6 para boleto registrado

Critério	Itaú	C6 Bank
API oficial	Cash Management v2 (OAuth + mTLS)	BaaS bank_slips (OAuth + mTLS)
PDF do boleto	Gerado pela loja (layout Itaú)	Oficial do banco, arquivado na loja
Conciliação	Automática horária	Automática horária
Fatura + e-mail no pagamento	Sim	Sim
Cancelamento pós-vencimento	Automático (+1 dia de carência)	Automático
Custo típico	~R$ 7–8/título (tabela geral; planos reduzem)	Negociado via contrato BaaS

Instalação e configuração

Os dois módulos instalam via Composer, habilitam como método de pagamento nativo e pedem as credenciais da API do seu banco (client_id/secret + certificado digital). O prazo de vencimento do boleto é configurável em dias no admin. O fluxo de checkout é o padrão do Magento — guest ou logado, inclusive em one-step checkouts como Firecheckout. A homologação completa faz parte do nosso serviço de implantação.

Perguntas frequentes

O módulo cobra taxa por boleto emitido?

Não. Licença única, sem mensalidade nem percentual. Você paga apenas a tarifa padrão de cobrança registrada do seu banco.

Preciso de certificado digital?

Sim. As APIs do Itaú e do C6 exigem autenticação mTLS com certificado emitido para sua conta PJ — faz parte das credenciais configuradas no admin.

A fatura é criada sozinha quando o cliente paga?

Sim. A conciliação automática identifica a baixa do título, cria a fatura, envia o e-mail e move o pedido para processamento.

E se o boleto não for pago?

O cancelamento é automático após o vencimento (com carência de um dia no Itaú), liberando estoque e encerrando o ciclo sem trabalho manual.

Dá pra estornar um boleto pago?

Devoluções de boleto são feitas diretamente no internet banking do banco (devolução/baixa); o módulo mantém o rastreio do título e do pagamento no pedido para você documentar tudo.

Funciona com guest checkout e Firecheckout?

Sim. Os módulos são métodos nativos do Magento 2 e respeitam o fluxo de guest e logado em qualquer checkout.