Open Finance Connectors

At Pluggy, apart from our usual Connectors, we now also support obtaining data from the Brazilian Open Finance Network with Open Finance Connectors.

Open Finance Connectors follow Pluggy's data model like any other Connector (Items, Accounts, Transactions, etc.), so there is no breaking change when obtaining data from Open Finance. However, they are some differences in the products they retrieve, the institutions they support and the way the user connects their account. In this guide we will discuss those differences so you can choose which connector type is best suited for your use case.

📘

Premium feature

If you are interested in using Open Finance Connectors, please contact our sales team to enable it for your plan

Products supported by Open Finance

Right now, Open Finance supports the following products:

• ACCOUNTS
• CREDIT_CARDS
• TRANSACTIONS
• IDENTITY
• LOANS
• INVESTMENTS & INVESTMENT_TRANSACTIONS& BROKERAGE_NOTES
• EXCHANGE_OPERATIONS

Institutions supported by Open Finance

Here is a comparison of support of brazilian institutions from Open Finance and Direct connectors:

Investment Connectors that were not mentioned here and other types like Digital Economy and Payment Processors are not currently supported by Open Finance but have Direct Connectors available.

Check out the Connectors Coverage docs for all supported Direct Connectors.

📘

Keeping up to date with the institutions

Our API offers the /connectors?isOpenFinance=true endpoint that describe all the Financial Institutions supported for Regulated Open Finance connections.
Each connector may support different products, validate each one using the products list returned by the institution.
New connectors will appear automatically in this endpoint so information will be most updated on our API.

Using Open Finance Connectors in my Application

Once you have Open Finance enabled for your plan, to add an Open Finance Connector, follow these steps:

Open Finance connectors will have an Open Finance tag, and appear as "[OF]" in the selected connectors list.

Now, users will be able to choose those institutions in Pluggy Connect (they look just like any usual connector):

Open Finance Rate Limits

The Brazilian Open Finance Network imposes rate limits on how many times per month anyone using Open Finance can fetch each product. These limits apply per combination of CPF/CNPJ and institution:

Under normal usage of Open Finance Connectors (one CPF and institution on only one item), you usually won't have to worry about Rate Limits, since you would never reach them even if you had automatic updates enabled on all your items.

However, keep in mind that if you connect the same CPF/CNPJ to the same institution by creating multiple items, you will trigger a Rate Limit, and affected products on those items will no longer update for that month.

When a rate limit is reached, you will see the Item in status PARTIAL_SUCCESS and inside the status detail, a warning about the failing product:

{
  "id": "44534b0e-717e-497d-890f-08c2faa468c1",
  "status": "PARTIAL_SUCCESS",
  "statusDetail": {
    "accounts": {
      "warnings": [
        {
          "code": "423",
          "message": "Open Finance monthly rate limit reached on product 'accounts' for this CPF/CNPJ and institution. The product could not be updated."
        }
      ],
      "isUpdated": false,
      "lastUpdatedAt": "2023-10-19T19:19:58.188Z"
    },
  },
  ...
}