Overzicht
Voor iedereen die is ingelogd bij Liquify (Free, Pro of Ultra) en Braziliaanse banken wil koppelen met eigen Pluggy-sleutels. Dit is een setup in ontwikkelaarsstijl—niet achter Ultra. Liquify ziet nooit je bankgegevens om in te loggen—je autoriseert de bank in Meu Pluggy en deelt alleen versleutelde API-sleutels plus een Item ID. Zie Banksynchronisatie voor limieten en hoe synchronisatie werkt.
Voordat je begint
- Een Liquify-account met login (Free, Pro of Ultra)
- Een Braziliaanse bank met Open Finance
- Ongeveer 15 minuten voor een eenmalige setup (herhaal Demo OAuth één keer per bank)
- Meu Pluggy kan een proefperiode tonen — negeer die; voor persoonlijk gebruik blijft het voor altijd gratis tot 5 bankkoppelingen
Pluggy-links — haal de portalen niet door elkaar
meu.pluggy.ai
Consumentenapp waar je elke Braziliaanse bank via Open Finance koppelt.
dashboard.pluggy.ai
Developer-portal waar je een app maakt, Meu Pluggy inschakelt en Client ID, Client Secret en Item ID kopieert.
Bankdekking
Bekijk welke Braziliaanse banken Pluggy via Open Finance ondersteunt voordat je koppelt.
Meu Pluggy-gids
Pluggy’s eigen walkthrough als er iets misgaat aan hun kant bij koppelen of autoriseren.
1. Koppel je banken in Meu Pluggy
Registreer je op meu.pluggy.ai. Tik op het welkomstscherm op de hoofdknop om een bank te koppelen.
Meu Pluggy-start — tik op de hoofdknop om een bank te koppelen.
Zoek je bank, selecteer die en rond de Open Finance-flow van de bank af (CPF, filiaal, wachtwoord of sms — afhankelijk van de bank).
Kies je bank uit de lijst.
Voer je CPF in en rond de banklogin af.
Als het lukt, verschijnt de bank onder gekoppelde rekeningen. Herhaal dit voor elke Braziliaanse bank die je in Liquify wilt (tot 5 per persoon).
Gekoppelde banken verschijnen hier.
2. Maak een Pluggy Developer-account
Meld je aan op dashboard.pluggy.ai. Pluggy kan een korte dashboardproef starten — negeer die voor deze setup. Meu Pluggy blijft gratis voor persoonlijke banksync; Liquify vereist geen Ultra voor dit Pluggy (Brazilië)-pad.
3. Schakel de Meu Pluggy-connector in
Open in het Pluggy-dashboard Customization → Connector list. Meu Pluggy is makkelijk te missen — schakel het in voordat je verdergaat.
Customization → Connector list.
Na het inschakelen moet Meu Pluggy in je connectorlijst staan. Zonder deze stap toont Demo-OAuth Meu Pluggy later niet.
Meu Pluggy ingeschakeld in de connectorlijst.
4. Maak een Development Application en kopieer je keys
Maak op de Application-pagina een Development Application. Je krijgt een Client ID en Client Secret om in Liquify te plakken.
Maak een Development Application.
Kopieer beide waarden. Bewaar het Client Secret meteen — Pluggy toont het mogelijk maar één keer.
Kopieer Client ID en Client Secret.
5. Autoriseer Meu Pluggy in Pluggy Demo (één keer per bank)
Open Pluggy Demo vanaf het dashboard, start een verbinding en kies Meu Pluggy om OAuth te beginnen.
Start Meu Pluggy-OAuth in Pluggy Demo.
Sta toegang toe en kies welke Meu Pluggy-bank je deelt. Eén keer per bank, niet per rekening.
Kies de bank en sta toegang toe.
Na geslaagde autorisatie toont de Demo het gekoppelde Meu Pluggy-item. Elke bank wordt een eigen Item.
Geautoriseerd — de bank is klaar om te importeren.
6. Kopieer de Item ID en rond af in Liquify
Op de Items-pagina in het Pluggy-dashboard (of het Demo-itemmenu) kopieer je de Item ID (UUID) van die bank.
In Liquify: Bank koppelen → Brazilië → plak Client ID, Client Secret en Item ID. Liquify versleutelt de keys op onze servers en start de sync.
Dezelfde Client ID en Secret werken voor alle banken; elke bank heeft een eigen Item ID nodig. Liquify vernieuwt ongeveer elke 6 uur en wanneer je naar beneden trekt om te vernieuwen. Ontkoppelen in Liquify verwijdert je Meu Pluggy- of Pluggy-verbinding niet.
7. Hernoem de bank en rekeningen in Liquify
Open onder Bank koppelen Bank bewerken. Stel een Banknaam en een Naam voor elke rekening in zodat je ze makkelijk vindt bij het koppelen van boxen. Laat een veld leeg om het huidige label te behouden.
Bank bewerken — hernoem de bank en elke rekening in Liquify.
Je bent klaar wanneer…
Liquify toont de bank onder Bank koppelen / Rekeningen met saldi. Koppel rekeningen aan boxen via Uitgavenbox bewerken als je Plan vs Rekeningen wilt.
Als de verbinding Opnieuw verbinden nodig toont, tik in Liquify op Opnieuw verbinden en vul opnieuw Client ID, Client Secret en Item ID in — de velden kunnen al ingevuld zijn van de vorige keer. Dat werkt alleen Liquify bij; het opent je bank niet. Als de banktoestemming zelf is verlopen (vaak ongeveer elke 90 dagen), vernieuw die eerst in Meu Pluggy / Pluggy Demo en gebruik daarna Opnieuw verbinden in Liquify met de huidige Item ID.