# Hubsoft integration with Caixa

> Caixa Econômica Federal serves customers nationwide. In Hubsoft, the ISP registers bank slips through Caixa’s API, enables bank slips with PIX QR Codes.

Fonte: https://hubsoft.io/en/integrations/caixa/

![Logo Caixa](/_astro/parceiro-caixa-recortado-mv13cxkq_2mzInG.webp) 

[Bank Slip (Boleto)](/en/integrations/category/boleto-bancario/) 

# Hubsoft integration with Caixa

Hubsoft, the ERP for internet service providers (ISPs), integrates with Caixa for bank slips (boletos), hybrid bank slips, and automatic debit. The bank slip is registered through Caixa’s WebService or via CNAB, and the payment is returned to settle the invoice.

Caixa Econômica Federal serves customers nationwide. In Hubsoft, the ISP registers bank slips through Caixa’s API, enables bank slips with PIX QR Codes, and sets up automatic debit for Caixa account holders.

[ Request a Demo ](/en/request-a-demo/) [Partner website](https://www.caixa.gov.br/) 

## About Caixa

Caixa Econômica Federal is a financial institution structured as a public company, headquartered in Brasília and present throughout the country. It plays a central role in public policies, housing, and social programs. For ISPs, it is a collection bank that reaches virtually every municipality.

## What the integration does

* **API registration:** with the WebService enabled, Hubsoft transmits the bank slip without a remittance file. Registration takes up to 5 minutes. For large billing runs, transmission occurs in batches and may take longer.
* **CNAB 240 and 400:** remittance and return files for registration and settlement.
* **Hybrid bank slip:** in API v2, each registered bank slip receives a PIX QR Code. The subscriber pays using the barcode or PIX.
* **Payment recognition:** for hybrid bank slips, Caixa sends a webhook when the bank slip or PIX payment is made, and the payment routine queries the TotalBank platform for confirmation.
* **Automatic debit:** remittance and return in version 4, for subscribers with Caixa accounts.

## What you need

* A Caixa account with a collection agreement. The manager provides the agreement, branch, account, and portfolio details.
* For the API: WebService mode enabled in the collection portfolio, under the same agreement.
* For hybrid bank slips: version v2 credentials and the API key provided by Caixa, plus TotalBank access to query payments.
* For automatic debit: a version 4 account debit agreement.
* Hubsoft Financial Module, included in the license.

## How to activate

1. In Settings > Finance > Billing Method, create a billing method with bank 104 - Caixa Econômica Federal and validate it using remittance and return files.
2. Ask the bank to enable WebService for the portfolio.
3. Edit the billing method, enable the API in the API tab, and fill in the parameters.
4. For hybrid bank slips, enter version v2, the credentials, TotalBank access details, and the PIX parameter under Extra Parameters.
5. Generate a test bank slip and check whether it was registered within 5 minutes.
6. For automatic debit, create another billing method with agreement type V4 and validate it with a test customer.

The step-by-step guide with screenshots is available in the Hubsoft wiki: [Caixa bank slip](https://wiki.hubsoft.com.br/pt-br/modulos/configuracao/financeiro/forma%5Fcobranca/boleto/caixa) and [Caixa automatic debit](https://wiki.hubsoft.com.br/pt-br/modulos/configuracao/financeiro/forma%5Fcobranca/debito/caixa).

## Limitations

* Without TotalBank access details, Hubsoft cannot query payments for hybrid bank slips.
* Caixa’s webhook is configured by the bank itself.
* Automatic debit only debits Caixa accounts and works exclusively through remittance and return files. The remittance file must be sent at least 5 days before the due date.

## Frequently asked questions

### Can Caixa automatic debit debit an account at another bank?

No. A bank can only debit its own accounts. For subscribers with accounts at another bank, use the bank slip.

### Why wasn’t the bank slip registered through the API?

Errors are usually specific to customer data or communication with the bank. Hubsoft Support will analyze the case.

### Do I need to send a remittance file when using the API?

No, not for registration. Hubsoft transmits the bank slip through Caixa’s WebService.

Reviewed on 10/10/2026.

## Similar integrations

* ![Logo Ailos](/_astro/parceiro-ailos-recortado-mv13cpub_ZQOkAl.webp)  
### [Ailos](/en/integrations/ailos/)  
Bank Slip (Boleto)
* ![Logo BRB](/_astro/parceiro-brb-recortado-mv13crjt_Z6GpvP.webp)  
### [BRB](/en/integrations/brb/)  
Bank Slip (Boleto)
* ![Logo Banco ABC](/_astro/parceiro-banco-abc-recortado-mv13cs5s_Z2tMcE6.webp)  
### [Banco ABC](/en/integrations/banco-abc/)  
Bank Slip (Boleto)
* ![Logo Banco do Brasil](/_astro/logo%20-%20banco%20do%20brasil-recortado-mv13ct2f_u4bHd.webp)  
### [Banco do Brasil](/en/integrations/banco-do-brasil/)  
Bank Slip (Boleto) · PIX · Automatic PIX
* ![Logo Banco do Nordeste](/_astro/parceiro-banco-do-nordeste-recortado-mv13ctbn_2j2inW.webp)  
### [Banco do Nordeste](/en/integrations/banco-do-nordeste/)  
Bank Slip (Boleto)

![Illuminated fiber optic cables converging into a connection hub](/_astro/site-cta04_TkBg7.webp) 

## Want to use this integration with your internet service provider (ISP)?

[ Request a Demo ](/en/request-a-demo/)
