Hubsoft integration with Santander

About Santander

Santander is a global banking group founded in 1857 in Santander, Cantabria, Spain. In Brazil, it serves all regions. For the ISP, it is a collection bank that brings bank slips, Pix, Pix Automático, and automatic debit together under the same agreement.

What the integration does

• Bank slips through API V2: registration, due date changes, settlement, and discounts sent to the bank through the API. Payments are identified by the bank slip verification routine in the Banking API.
• Bank slips through API V1: automatic registration only, for those still using the previous version.
• CNAB 240 and 400: file-based submissions and returns.
• Hybrid bank slip: in API V2, the Pix QR Code is generated when the bank slip is registered.
• Pix: QR Code and copy-and-paste code on the bank slip, in the Subscriber Center, and in the Customer App. Registration, paid payment checks, and cancellation are automatic, with verification every 8 minutes.
• Pix Automático: the subscriber authorizes recurring payments once, through a QR Code generated in their registration, and subsequent monthly payments are debited on the agreed date.
• Automatic debit: submissions and returns in the bank account debit format, for subscribers with a Santander account.

What you need

• A Santander account with a collection agreement.
• Registration in Santander's Developers Portal and an invitation from the account manager to generate the credentials for issuing bank slips and Pix.
• The company's A1 digital certificate, with the public key imported into Santander's registration. You can also use the partner certificate between Hubsoft and Santander.
• A Pix key, preferably a random one, for Pix and the hybrid bank slip.
• Hubsoft's Financial Module, included in the license.

How to activate

1. Under Settings > Finance > Collection Method, create the Santander collection method and validate it through submissions and returns.
2. Register in the Developers Portal and ask the account manager to complete the internal registration required to generate the credentials.
3. Under Settings > General > Digital Certificate, download the certificate's public key and import it into Santander's registration.
4. In the collection method's API tab, enable transmission and enter version v2, the certificate, and the credentials. For the hybrid bank slip, enable Pix and enter the key.
5. Add the Verify Collections routine in the Banking API under Settings > General > Routines.
6. For Pix and Pix Automático, add Santander under Settings > Integrations > PIX and link it to the collection method.

The step-by-step guide with screenshots is available in the Hubsoft wiki: Santander bank slip, Santander Pix and Santander automatic debit.

Limitations

• API V1 only handles registration. For settlement, due date changes, and returns through the API, use V2.
• When the digital certificate is renewed, the registered public key must be updated.
• Automatic debit only debits Santander accounts and works only through submissions and returns.
• Pix Automático does not apply a discount before the due date: the authorized amount is the invoice's full amount.

Frequently asked questions

What is the difference between separate Pix and a hybrid bank slip?

With separate Pix, the QR Code is not registered together with the bank slip, and the Pix payment must settle the bank slip with the bank. With the hybrid version, Pix is created when the bank slip is registered, and payment by any method settles the same title.

How long does it take for a paid Pix payment to appear in Hubsoft?

Hubsoft checks for paid Pix payments every 8 minutes.

Does Santander automatic debit debit an account at another bank?

No. To debit an account at any bank, use Pix Automático.

Reviewed on 10/10/2026.