O boleto híbrido é uma combinação entre boleto e PIX referente a mesma cobrança, em outra palavras, é possível fornecer aos clientes um tipo de cobrança que pode ser quitada através do código de barras de um boleto ou via QRCode do PIX. 

Vale ressaltar que para realizar a utilização do boleto híbrido conforme a listagem dos bancos disponíveis abaixo, é necessário possuir o Web Service ativo, e também ter a funcionalidade liberada no banco, processo este, que pode ser visualizado como funciona para algumas instituições financeiras neste link, dentro dos tópicos das docs de liberação do WS.

Bancos disponíveis

* As funcionalidades foram recentemente criadas e testadas, seguindo a documentação que está sujeita a alterações no início do uso direto com o banco.

Para utilização desse recurso basta seguir as instruções seguintes.

Emitindo o boleto híbrido VIA API

POST

Produção:

http://plugboleto.com.br/api/v1/boletos

Headers

Body

No body você poderá utilizar os campos de inclusão de um boleto de acordo com a documentação: campos utilizados para inclusão de um boleto e, acrescentar o campo "hibrido": true no JSON de emissão:

{
  ...
  ...
  "TituloNossoNumero":"123",
  "TituloValor":"100,00",
  "hibrido": true
}

Resposta

Sucesso:

{
  "_status": "sucesso",
  "_dados": {
    "idintegracao": "ABCDEFGH",
    "situacao": "SALVO",
    "TituloNumeroDocumento": "0000000123",
    "TituloNossoNumero": "123",
    "CedenteContaCodigoBanco": "001",
    "CedenteContaNumero": "1234",
    "CedenteConvenioNumero": "1234",
    "TituloCodigoReferencia": null
  }
}

Consultando o boleto híbrido

GET

Produção:

http://plugboleto.com.br/api/v1/boletos

Resposta

A resposta será composta por diversos campos de acordo com a documentação: consultando um boleto. Contudo serão acrescidos os campos referentes ao boleto híbrido de acordo com o exemplo abaixo.

Sucesso:

{
"hibrido": true,
"UrlPix": "http://plugboleto.com.br/api/v1/boletos/impressao/HRKCVJXVV/pix",
"Emv": "00020101021226930014BR.GOV.BCB.PIX2551pix.exemplo.com.br/qr/123e4567-e89b-12d3-a456-4266141740005204000053039865802BR5921EMPRESA FICTICIA LTDA6009CURITIBA62070503***6304A1B2"
}

Impressão do boleto híbrido

Para saber mais sobre os tipos de impressão, acesse a documentação referente aos exemplos de impressão.

Exemplo de boleto híbrido:

Referência:

Link 01: https://atendimento.tecnospeed.com.br/hc/pt-br/articles/360014943693-Campos-utilizados-para-inclus%C3%A3o

Link 02: https://atendimento.tecnospeed.com.br/hc/pt-br/articles/360022352434-Consultando-um-Boleto

Link 03: https://atendimento.tecnospeed.com.br/hc/pt-br/articles/360015834554-Exemplos-de-impress%C3%A3o

Emitindo o boleto híbrido VIA OCX

POST

Produção:

Headers

Body

No body você poderá utilizar os campos de inclusão de um boleto de acordo com a documentação: campos utilizados para inclusão de um boleto e, acrescentar o campo HIBRIDO=TRUE no TXT de emissão:

{
  ...
  ...
  TituloNossoNumero=2469
  TituloNumeroDocumento=00015
  TituloDataVencimento=29/01/2019
  TituloDataEmissao=14/01/2019
  HIBRIDO=TRUE
}

Resposta

Sucesso:

.:: Incluir Boleto ::.

Mensagem: Boleto(s) processado(s) com sucesso.
Status: SUCESSO
Item: 1
IdIntegracao: H1F1EW-fX
Situacao: SALVO
NossoNumero: 1482 341
Banco: 341 12345
Conta: 12345
Convenio: 1234123456
Erro: 'boleto': Boleto com Nosso Número 1483 já existe para este convênio.
ErroClasse: VALIDACAO

Consultando o boleto híbrido

GET

Produção:

TspdBoletoX.Consultar(WideString)

Resposta

A resposta será composta por diversos campos de acordo com a documentação: Consultando o boleto. Contudo serão acrescidos os campos referentes ao boleto híbrido de acordo com o exemplo abaixo.

Sucesso:

{
  HIBRIDO=TRUE,
  URLPI=http://plugboleto.com.br/api/v1/boletos/impressao/HRKCVJXVV/pix",
}

Impressão do boleto híbrido

Para saber mais sobre os tipos de impressão, acesse a documentação referente aos exemplos de impressão.

Exemplo de boleto híbrido: