Sobre o produto
Antes de falar sobre o produto boleto, vale resaltar que devido as novas regulamentações da Febraban para emissão de boletos registrados, é necessário o envio dos dados completos do pagador (customer) e do vendedor (seller). É necessário enviar obrigatoriamente o CPF/CNPJ, Nome Completo, Endereço, Bairro, Cidade, Estado, CEP e País.
Clique aqui e saiba mais sobre a nova plataforma de cobrança.
O boleto bancário da Zoop é um web service que disponibiliza operações de venda através de boleto registrado com base nos dados do comprador, de maneira totalmente segura e escalável. Ele foi criado para facilitar aos parceiros recebimento de pagamentos em dinheiro através da emissão de títulos de cobrança em aplicativos e no e-commerce.
Para usar o serviço de pagamentos através de boleto da Zoop, você precisa:
-
Criar um novo comprador informando os dados de cobrança necessários a emissão do boleto.
-
Criar uma nova transação de boleto através do serviço de pagamentos associando o comprador e o vendedor da sua plataforma, encaminhando o boleto gerado para o comprador realizar o pagamento dentro do prazo determinado.
-
Após o pagamento e posterior conciliação bancária pelo serviço da Zoop, seu sistema é notificado, seguindo o fluxo de cobrança para liberação do produto ou serviço.
Recursos
Início imediato
Emita boletos registrados aderentes à regulamentação do BACEN, imediatamente e sem a necessidade de se cadastrar em nenhum banco.
Integração com a CIP
Com a nossa solução seu boleto é disponibilizado on-line na CIP, ficando disponível para pagamento imediato na rede bancária.
Conciliação automática
Nosso sistema identifica automaticamente os boletos pagos, sem a necessidade da sua empresa ter esforço manual.
Boleto customizável
Você deixa o boleto com a cara do seu negócio. Suportamos a personalização das informações, descrição, logomarca, prazo de vencimento, etc.
Split de pagamento
É possível dividir automaticamente entre diversas contas as vendas com Boleto, permitindo novos modelos de comissionamento entre recebedores.
Disponibilização
Geração de boleto e visualização em HTML, possibilidade de download e impressão, além de envio por e-mail.
API Rest
É possível através da API fazer a gestão das transações do tipo boleto. Integrado com o ecossistema de APIs Zoop.
Notificações e eventos
Notificação através de webhooks.
Como funciona uma transação
Estados de uma transação
Durante o fluxo de compra uma transação tem diferentes estados de acordo com as atualizações aplicadas.
Você pode verificar o estado atual através do campo status
, sempre retornado no objeto da transação. Também é possível verificar o histórico de uma transação através do campo history
.
new
: Uma nova transação foi criada e as informações foram recebidas com sucesso para processamento.
pending
: A transação foi processada pela Zoop, o boleto foi gerado, e está pendente para pagamento.
succeeded
: O pagamento do boleto foi identificado e compensado pela Zoop.
failed
: Ocorreu uma falha ao processar a transação.
canceled
: O pagamento foi cancelado/anulado pelo vendedor. As taxas cobradas originalmente também são anuladas.
refunded
: A transação foi estornada e o saldo disponível foi liberado.
{
"id": "eb5b0e986645401ca97309dbba56f4a9",
"resource": "transaction",
"status": "succeeded",
...
"history": [
{
"id": "432a62c2d0384eb8b09b5661774f12e9",
"transaction": "eb5b0e986645401ca97309dbba56f4a9",
"amount": "336.75",
"operation_type": "created",
"status": "succeeded",
"response_code": null,
"response_message": null,
"authorization_code": null,
"authorizer_id": null,
"authorization_nsu": null,
"created_at": "2018-10-23 15:18:50"
},
{
"id": "9df4d81b1e344e38849af95e4394a8e6",
"transaction": "eb5b0e986645401ca97309dbba56f4a9",
"amount": "0.00",
"operation_type": "paid",
"status": "succeeded",
"response_code": null,
"response_message": null,
"authorization_code": null,
"authorizer_id": null,
"authorization_nsu": null,
"created_at": "2018-11-09 13:27:32"
}
]
}
Prazos, horários e conciliação
Prazos de emissão
Os boletos são emitidos online e ficam disponíveis imediatamente na CIP (Câmara Interbancária de pagamentos). Isso significa que assim que gerado o mesmo já está disponível para pagamento em toda rede bancária conveniada.
Prazos de pagamento
Por padrão os boletos bancários são configurados com vencimento de D+3, podendo ser pagos até a data de vencimento sem ônus de multas e juros. O meio de pagamento através de boletos bancários permite que os mesmos sejam aceitos após o vencimento. Também é possível configurar multas e juros após o vencimento.
Caso deseje aumentar a data de expiração do boleto deve se utilizar o campo expiration_date
. É possível também estipular uma data máxima para pagamento utilizando o campo payment_limit_date
.
Prazos de compensação / conciliação
Assim que os bancos nos notificam dos pagamentos, executamos um processo de conciliação dos pagamentos processados com os pagamentos recebidos.
Esse processo ocorre diariamente em dias úteis no período da manhã. Aos sábados acontece o processo de compensação, mas os pagamentos são efetuado no próximo dia útil.
O prazo da conciliação de boletos é de 1-3 dias úteis, na grande maioria dos casos os boletos são conciliados em 1 dia útil.
Na prática: os boletos bancários emitidos em uma segunda-feira, e pagos no mesmo dia, serão conciliados no próximo dia útil, nesse exemplo, terça-feira.
Em alguns raros casos por falhas de comunicação ou atrasos de repasses é necessário o processamento em uma janela secundária, que ocorre de 12h até as 17h do mesmo dia.
Prazos de recebimento
Assim que os bancos nos notificam dos pagamentos, executamos um processo de conciliação dos pagamentos processados com os pagamentos recebidos. Não temos boletos emitidos e pagos no mesmo dia, por conta do processo de compensação, só recebemos essa confirmação a partir de D+1
O saldo fica disponível logo após o processo de conciliação, e é possível realizar um saque ou fazer uma transferência dos valores desde que sejam respeitadas as janelas desses serviços.
Anatomia do layout


Tipos de integração
Existem dois modelos de integração, você pode utilizar o boleto com o layout fornecido pela Zoop de acordo com as especificações do banco, ou você pode montar o layout internamente na sua aplicação caso precise de um boleto ainda mais personalizado.
Layout Zoop
Esse é o modelo padrão, utilizado pela maioria dos clientes. Você realiza uma venda, nós retornamos um url pública no atributo payment_method.url
você pode fornecer diretamente na sua aplicação ou para o seu usuário.
Nesse modelo a responsabilidade de montar e exibir o layout do boleto bancário é da Zoop.
Layout do Boleto
O layout do boleto pode ser atualizado a qualquer momento sem a necessidade de qualquer aviso prévio. Poderão ocorrer modificações no html de conteúdo, cores, tamanhos, disposição dos elementos e formatações para atender novas exigências regulatórias ou melhorias na experiência do produto.
Layout Próprio
A venda é realizada normalmente, os dados, códigos de barras e demais informações enviados na resposta da integração, são coletados e exibidos através do layout de preferencia.
Nesse modelo a responsabilidade de montar e exibir o layout do boleto bancário é do integrador.
Updated 2 months ago
Mais informações:
Gerando um boleto |
Multa, juros e descontos |
Perguntas e respostas |