Layout boleto
Anatomia do layout
| # | Campo | Campo Json | Obs |
|---|---|---|---|
| 1 | Pagador/CPF/CNPJ/Endereço | customer | Representa o buyer ou seller que irá pagar o boleto |
| 2 | Data de Vencimento | payment_method.expiration_date | Caso não seja enviada uma data, o padrão é D+3. |
| 3 | Valor do Documento | amount | Enviar valor em centavos. |
| 4 | Sacador/Avalista | on_behalf_of | Informações do estabelecimento emissor do boleto |
| 5 | Informações de Responsabilidade do Beneficiário | body_instructions | Informações de instruções de pagamento para o caixa (é responsabilidade do caixa acatar). |
| 6 | Nome do Beneficiário | Representa as informações do beneficiário do boleto, sempre será Zoop. | |
| 7 | Inclusão de logo no boleto | logo | Campo onde é possível inserir um logo personalizado. |
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. Onde poderá ser realizada uma venda, e nós retornamos uma URL pública no atributo "payment_method.url" que pode ser fornecida 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 Próprio
Nesse modelo a responsabilidade de montar e exibir o layout do boleto bancário é do parceiro, desde que o mantenha as informações do boleto original.
A venda será realizada normalmente, os dados, códigos de barras e demais informações enviados na resposta da integração, devem ser coletados e exibidos através do layout de preferencia.
- Personalizado
É possível personalizar o seu logo no boleto, os formatos aceitos são gif, jpg, svg, e png, sendo a dimensão ideal da imagem em 218 pixels de largura por 68 pixels de altura. Caso a imagem enviada tenha valores maiores ou menores, a imagem será redimensionada não possuindo limitações para o tamanho em byte dos arquivos enviados.
Importante.
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.
Updated 7 months ago