v1
latestOpenAPI 3.0.12026-07-261451591021.8 KBCriaTransacaoBoletoHibrido
Cria uma transação de boleto híbrido (pix + boleto)
Este método permite criar uma transação híbrida (boleto + pix), para a função de checkout transparente (implementado dentro do sistema web do comércio) de forma a permitir gerar um PDF contendo um boleto e o pix relacionado, além de receber a linha digitável, nosso número, o contéudo e URL do QRCode associado a transação. Notar que no momento da criação do boleto híbrido, a transação apresentará o estado “Pendente”. O sistema então verificará automaticamente pelo pagamento do referido boleto ou do crédito do pix relacionado, e quanto este ocorrer, invoca a URL de confirmação indicada pelo comércio, para notificar do pagamento, o qual deverá consultar o estado da transação neste momento e realizar a respectiva baixa no seu sistema. Notar que o boleto híbrido é suportado somente pelo provedor Arbi. <br />
O pix gerado nesta modalidade herdará as mesmas características do boleto, ou seja, informações como desconto, multa e juros também estarão presentes no pix no momento do pagamento pelo cliente final do comércio. <br />
Requisição
| Campo | Tipo | Descrição | Obrigatório |
|---|---|---|---|
| Valor | Numérico com 2 decimais | Valor da compra | Sim |
| DataVencimento | Data | Data de vencimento do boleto | Sim |
| URLConfirmacao | Texto | URL de confirmação do comércio para indicar que o pagamento está em estado final | Não |
| ClienteDescricao | Texto | Descrição da compra | Sim |
| ClienteIP | Texto | IP do cliente final da transação | Não |
| ClienteCPFCNPJ | Texto | CPF/CNPJ do cliente final da transação | Sim |
| ClienteNome | Texto | Nome do cliente final da transação | Sim |
| ClienteEMail | Texto | E-mail do cliente final da transação | Não |
| ClienteEndereco | Texto | Endereço do cliente final da transação | Sim |
| ClienteBairro | Texto | Bairro do cliente final da transação | Sim |
| ClienteCidade | Texto | Cidade do cliente final da transação | Sim |
| ClienteCEP | Texto | CEP do cliente final da transação | Sim |
| ClienteUF | Texto | UF do cliente final da transação | Sim |
| ClienteDDD | Texto | DDD do telefone do cliente final da transação | Não |
| ClienteNumeroCelular | Texto | Número do telefone do cliente final da transação | Não |
| NumeroPedido | Texto | Número do pedido para controles internos | Não |
| NumeroDocumento | Texto | Descritivo para localização futura do boleto | Não |
| Referencia | Texto | Referência para localização futura da transação | Não |
| DataLimitePagamento | Data | Data limite para pagamento do título.Após esta data, o mesmo é baixado junto a CIP | Não |
| TipoMulta | Texto | Tipo da multa a ser aplicada | Não |
| ValorMulta | Numérico | Valor da multa a ser aplicada | Não |
| TipoJuros | Texto | Tipo dos juros a serem aplicadas | Não |
| ValorJuros | Numérico | Valor do juros a ser aplicado | Não |
| TipoDesconto | Texto | Tipo do desconto a ser aplicado | Não |
| ValorDesconto | Numérico com 2 decimais | Valor do desconto a ser aplicado | Não |
| DataDesconto | Texto | Data do desconto | Não |
| ValorDesconto2 | Numérico com 2 decimais | Valor do desconto a ser aplicado | Não |
| DataDesconto2 | Texto | Data do desconto | Não |
| ValorDesconto3 | Numérico com 2 decimais | Valor do desconto a ser aplicado | Não |
| DataDesconto3 | Texto | Data do desconto | Não |
| Mensagem2 | Texto | Mensagem orientativa inserida no boleto | Não |
| Mensagem3 | Texto | Mensagem orientativa inserida no boleto | Não |
| Mensagem4 | Texto | Mensagem orientativa inserida no boleto | Não |
| Mensagem5 | Texto | Mensagem orientativa inserida no boleto | Não |
| RetornarBase64 | Booleano | Aceita os valores true ou false, informando para retornar PDF do boleto codificado em texto formato Base64 | Não |
| NotaFiscal | Texto | Número da nota fiscal | Não |
Resposta
| Campo | Tipo | Descrição |
|---|---|---|
| Retorno | Texto | Retorno da chamada, podendo possuir os valores OK ou ERRO |
| DetalhesErro | Texto | Detalhes do erro gerado, caso o retorno seja ERRO |
| Identificador | Texto | Identificador da transação |
| NossoNumero | Texto | Nosso número do boleto gerado |
| LinhaDigitavel | Texto | Linha digitável do boleto gerado |
| CodigoBarras | Texto | Código equivalente ao binário do código de barras do boleto gerado |
| BoletoPDF | Texto | PDF do boleto codificado em texto formato Base64 |
| QRCodeTexto | Texto | Texto do QRCode para realizar o pagamento via Pix |
| QRCodeImagem | Texto | URL que gera a imagem do QRCode relacionado a transação |
post/api/CriaTransacaoBoletoHibrido
Headers
Aeskeystring required
Request body
Example request
{
"Valor": 103.67,
"DataVencimento": "2026-06-05T09:47:50.9835317-03:00",
"URLConfirmacao": "https://www.meusite.com.br/webhook/confirmacao-transacao",
"ClienteDescricao": "Cliente Gold Nivel 25",
"ClienteIP": "127.0.0.1",
"ClienteCPFCNPJ": "48455151480",
"ClienteNome": "Renato Samuel Augusto Baptista",
"ClienteEmail": "renatosamuel@umdominio.com.br",
"ClienteEndereco": "Rua Canadá, 257",
"ClienteBairro": "Bacacheri",
"ClienteCidade": "Curitiba",
"ClienteCEP": "82510290",
"ClienteUF": "PR",
"ClienteDDD": "41",
"ClienteNumeroCelular": "999293802",
"NumeroPedido": "pedido.2026052109",
"NumeroDocumento": "1920123",
"Referencia": "00123",
"DataLimitePagamento": "2026-06-06T09:47:50.9835317-03:00",
"TipoMulta": "ValorFixo",
"ValorMulta": 3.22,
"TipoJuros": "TaxaMensal",
"ValorJuros": 2.75,
"TipoDesconto": "ValorFixoAteDataInformada",
"ValorDesconto": 9.99,
"DataDesconto": "2026-05-25T09:47:50.9835317-03:00",
"ValorDesconto2": 6.99,
"DataDesconto2": "2026-05-29T09:47:50.9835317-03:00",
"ValorDesconto3": 3.99,
"DataDesconto3": "2026-06-02T09:47:50.9835317-03:00",
"Mensagem2": "Nao receber depois de 05/06/2026",
"Mensagem3": "Aplicar multa de R$ 5,00 em caso de pagamento após a data de vencimento.",
"Mensagem4": "Desconto de 5% para pagamentos realizados até a data de vencimento.",
"Mensagem5": "Valor atualizado deverá incluir taxa de atraso de 0,033% ao dia.",
"RetornarBase64": false,
"NotaFiscal": "213829821029"
}Response
Método executado com sucesso