Boletos
O que são boletos registrados?
O boleto registrado é um dos meios de pagamentos disponibilizados no E-commerce com o objetivo de mitigar fraudes.
O banco emissor tem conhecimento da emissão do boleto desde sua geração até sua liquidação diferente dos antigos boletos não registrados. A loja tem a opção de negativar o comprador que gerou e não pagou uma cobrança registrada.
Esta modalidade de cobrança permite que o comprador efetue o pagamento do boleto em qualquer agência bancária mesmo depois do vencimento.
Datas estabelecidas pela Febraban (Federação Brasileira de Bancos) para que boletos registrados possam ser utilizados.
Bradesco
Como funciona
API Cielo E-commerce
- O comprador, após escolher o produto na loja, seleciona a forma de pagamento Boleto Bradesco;
- A loja envia para a Cielo uma requisição chamando o meio de pagamento correspondente;
- A Cielo se comunica com a aplicação do Banco Bradesco solicitando o registro do boleto;
- Caso o registro seja realizado com sucesso, o Banco responde à solicitação devolvendo os dados de cobrança (código de barras, linha digitável, etc) e a URL do Boleto;
- A Cielo envia no response o link para que a loja possa abrir um pop-up exibindo o boleto;
- O cliente acessa a URL do boleto (renderização) e então pode realizar o pagamento;
- A conciliação do boleto é feita via serviço de consulta da Cielo ao sistema do Bradesco.
- Para receber as notificações de pagamento, a loja deve ter cadastrada a URL de Notificação ou utilizar o serviço de consulta.
Checkout Cielo
- O comprador, após escolher o produto na loja, seleciona a forma de pagamento Boleto Bradesco;
- O Checkout exibirá a URL do Boleto
- O cliente acessa a URL do boleto (renderização) e então pode realizar o pagamento;
- A conciliação do boleto é feita via serviço de consulta da Cielo ao sistema do Bradesco.
- No Backoffice do Checkout, o status do Boleto será atualizado.
- Para receber as notificações de pagamento, a loja deve ter cadastrada a URL de Notificação ou utilizar o serviço de consulta.
Configurando o Boleto
Ambiente Bradesco
O lojista precisará realizar configurações dentro do ambiente bancário.
Painel de controle
O lojista deverá contatar o gerente de relacionamento do Banco Bradesco para solicitar a contratação do Boleto Registrado via Gerenciador API/Painel de controle A equipe técnica do Banco enviará para o e-mail do solicitante os dados de acesso ao Gerenciador API/Painel de controle.
PAINEL DE CONTROLE BRADESCO: https://meiosdepagamentobradesco.com.br/gerenciadorapi/login.jsp
Configurando o boleto
No painel do Bradesco, o lojista deverá acessar a aba “Configurações” e escolher a opção “Meios de Pagamento” e modifique as sequintes configurações.
- Habilitar “frase” do boleto: Inativo
- Habilitar “referência” do boleto: Ativo
- Apresentar Agência e Conta: Inativo
- Vencimento: 5 dias
- URL de notificação: https://www.pagador.com.br/post/BoletoBradescoSps/ReceivePost
- No campo Chave de Segurança clique em “Gerar chave de segurança”
- Endereço de IP da loja (numérico)
- Para os campos de URL de resposta, URL de falha e URL de redirecionamento, inserir o seguinte link:
https://www.pagador.com.br/post/BoletoBradescoSps/ReceivePost
Em cada um dos três Paramêtros a seguir, preencher com o Parâmetro de Comunicação abaixo:
| Parâmetros | Dados |
|---|---|
| Notificação | numOrder=[%lid_m%]&merchantid=[%merchantid%]&cod=[%errorcod%]&cctype=[%cctype%]&ccname=[%ccname%]&ccemail=[%ccemail%]&numparc=[%numparc%]&valparc=[%valparc%]&valtotal=[%valtotal%]&prazo=[%prazo%]&comb=[%comb%]&assinatura=[%assinatura%]& |
| Confirmação | numOrder=[%lid_m%]&merchantid=[%merchantid%]&cod=[%errorcod%]&cctype=[%cctype%]&ccname=[%ccname%]&ccemail=[%ccemail%]&numparc=[%numparc%]&valparc=[%valparc%]&valtotal=[%valtotal%]&prazo=[%prazo%]&comb=[%comb%]&assinatura=[%assinatura%]& |
| Falha | numOrder=[%lid_m%]&merchantid=[%merchantid%]&cod=[%errorcod%]&cctype=[%cctype%]&ccname=[%ccname%]&ccemail=[%ccemail%]&numparc=[%numparc%]&valparc=[%valparc%]&valtotal=[%valtotal%]&prazo=[%prazo%]&comb=[%comb%]&assinatura=[%assinatura%]& |
| Comunicação | numOrder=[%lid_m%]&merchantid=[%merchantid%]&cod=[%errorcod%]&cctype=[%cctype%]&ccname=[%ccname%]&ccemail=[%ccemail%]&numparc=[%numparc%]&valparc=[%valparc%]&valtotal=[%valtotal%]&prazo=[%prazo%]&comb=[%comb%]&assinatura=[%assinatura%]& |
Clique em “Gravar todas as configurações realizadas”
Configurando credenciais
- No painel do Bradesco, o lojista deverá acessar a aba “Configurações” e escolher a opção “Meios de Pagamento”
- O campo “Palavra-secreta” deve ser preenchido com uma senha. A operação é confirmada clicando em “Gerar nova chave de segurança”
- Ainda no Painel do Bradesco, o cliente deve criar um Usuário de Consulta para atualizações de status.
Suporte Bradesco
Para obter ajuda com os passos acima, entre em contato com o suporte Bradesco:
- kit@scopus.com.br
- homologacao@scopus.com.br
- com.eletronico@bradesco.com.br
- comerciobradesco@scopus.com.br
Ambiente Cielo
Dados de cadastro
O Lojista precisará informar ao suporte Cielo os sequintes dados:
| Dados | Descrição | Formato | OBS |
|---|---|---|---|
| Agência | Código agência | 4 dígitos | com ou sem hífen |
| Conta: | Conta corrente | 7 dígitos | com hífen |
| Carteira: | Não é necessário boleto Registrado | 2 dígitos | N/A |
| Conciliação | Número do convênio de cobrança | 7 dígitos | Informado dentro do Painel do Bradesco |
| Convênio | Convênio de comércio eletrônico | 6 dígitos | Validar com o banco se é necessario preenchimento para a carteira |
| Nosso Numero | Contador incremental | 5 dígitos | Opcional - Número de controle que a cada emissão dp boleto aumenta em +1 |
| Vencimento | Prazo de validade do boleto | 6 dígitos | É o valor padrão, se nenhum outro valor for enviado via API |
| Assinatura de Afiliação | Chave de segurança do Bradesco | 50 dígitos | Informado dentro do Painel do Bradesco |
Serão necessárias as credenciais do Bradesco:
Essas credenciais são usadas para que a Cielo possa consultar o status do Boleto.
| Credenciais | Descrição | Exemplo |
|---|---|---|
| Usuário | E-mail usado no acesso do Painel do Bradesco | cielo@cielo.com |
| Senha/Chave de Segurança | Chave de segurança criada dentro do Painel do Bradesco. Não é a senha de acesso ao Painel Bradesco |
qcnmFA-Y2rGm4meWLzrEzSpdPARBsmblZSqfKLwq7DM |
Suporte Cielo
Em caso de dúvidas em qualquer etapa ou outras informações técnicas, entre em contato com o Suporte Web do Cielo e-Commerce nos seguintes canais:
- E-mail: cieloeCommerce@cielo.com.br
- Capitais: 4002-9700
- Demais Cidades: 0800 570 1700
- *Horário de atendimento: 24h por dia, 7 dias por semana.
Atualização de Status
Para o meio de pagamento Boleto Registrado Bradesco a atualização de status é feita via sondagem em lote:
- Essa sondagem ocorre pela manhã: 4h, 6h, 8h, 10h e 12h.
Para receber as notificações de pagamento, a loja deve ter cadastrada a URL de Notificação em conjunto com a realização de GETs
OBS: Hoje, a sonda considera transações que estejam com a data de vencimento dentro do intervalo de 30 dias anteriores e 30 dias posteriores à data de Sondagem.
Conciliação Manual de Boletos
Para conciliar o boleto de forma manual, basta localizar o pedido no site Cielo e dentro dos Detalhes da Transação localizar o botão “Conciliar”. Desta forma o pedido terá o status alterado de “Não Pago” para “Pago”.
Banco do Brasil
Como funciona
API Cielo E-commerce
- O comprador, após escolher o produto na loja, seleciona a forma de pagamento Boleto Registrado Banco do Brasil.
- A loja envia para a Cielo uma requisição chamando o meio de pagamento correspondente.
- A cielo retornará uma URL contendo a imagem do Boleto.
Checkout Cielo
- O comprador, após escolher o produto na loja, seleciona a forma de pagamento Boleto Banco do Brasil;
- O Checkout exibirá a URL do Boleto
- O cliente acessa a URL do boleto (renderização) e então pode realizar o pagamento;
- A conciliação de status não está disponivel para Checkout Cielo.
- O Lojista precisará conciliar manualment o pagamento do Boleto
Configurando o boleto
Ambiente BB
O lojista deverá contatar o gerente de relacionamento do Banco do Brasil para solicitar a habilitação do produto Boleto Registrado. O formulário a seguir deve ser preenchido e entregue ao gerente.
| Dado | Formato |
|---|---|
| URL (site) retorno à loja | https://www.pagador.com.br |
| Formato arquivo Retorno | (X) CBR643 |
| Meio de retorno | {X) Mainframe – para empresa com sistema próprio, que não usam o GFN. |
Ao final do credenciamento, o lojista receberá um documento com como o que segue abaixo
Ambiente Cielo
Dados de cadastro
O Lojista precisará informar ao suporte Cielo os sequintes dados:
| Dados | Descrição | Formato | OBS |
|---|---|---|---|
| Agência | Código agência | 5 Dígitos | Hífen obrigátório - não pode haver espaços antes ou depois da agência |
| Conta: | Conta corrente | 7 Dígitos | Hífen obrigátório |
| Carteira: | Não é necessário boleto Registrado | 2 dígitos | N/A |
| Conciliação | Número do convênio de cobrança | 7 Dígitos | Inserir o Convênio de cobrança fornecido pelo banco |
| Convênio | Convênio de comércio eletrônico | 6 Dígitos | Inserir o Convênio de Comercio Eletrônico fornecido pelo banco |
| Nosso Numero | Contador incremental | 5 Dígitos | Inserir “10000” - A cada emissão de boleto esse numero aumenta em +1 |
| Vencimento | Prazo de validade do boleto | 6 Dígitos | É o valor padrão, se nenhum outro valor for enviado via API |
| Instruções | Informações exibidas no boleto | 50 Dígitos | Somente números e letras de A-Z, não pode haver caracteres especiais ou mais de um espaçamento entre cada palavra |
OBS: A loja deverá obrigatoriamente enviar no contrato da API os dados (nome do comprador, CPF e endereço completo).
Conciliação de boletos
NO MOMENTO, O BOLETO REGISTRADO BANCO DO BRASIL NÃO REALIZA ATUALIZAÇÃO DE STATUS AUTOMÁTICA
