Überblick
Für alle mit Liquify-Login (Free, Pro oder Ultra), die brasilianische Banken mit eigenen Pluggy-Schlüsseln verbinden wollen. Das ist ein Entwickler-Setup—nicht Ultra-pflichtig. Liquify sieht nie deinen Bank-Login—du autorisierst in Meu Pluggy und teilst nur verschlüsselte API-Schlüssel plus Item-ID. Zu Limits und zur Funktionsweise der Synchronisierung siehe Bank-Sync.
Bevor du startest
- Ein Liquify-Konto mit Login (Free, Pro oder Ultra)
- Eine brasilianische Bank mit Open Finance
- Etwa 15 Minuten für die einmalige Einrichtung (Demo-OAuth einmal pro Bank wiederholen)
- Meu Pluggy kann eine Testphase anzeigen — ignorieren; für den privaten Gebrauch bleibt es dauerhaft kostenlos für bis zu 5 Bankverbindungen
Pluggy-Links — Portale nicht verwechseln
meu.pluggy.ai
Consumer-App, in der du jede brasilianische Bank über Open Finance verbindest.
dashboard.pluggy.ai
Developer-Portal, in dem du eine App erstellst, Meu Pluggy aktivierst und Client ID, Client Secret und Item ID kopierst.
Bankabdeckung
Prüfe, welche brasilianischen Banken Pluggy über Open Finance unterstützt, bevor du verbindest.
Meu-Pluggy-Anleitung
Pluggys eigene Anleitung, falls etwas auf ihrer Seite beim Verbinden oder Autorisieren scheitert.
1. Banken in Meu Pluggy verbinden
Registriere dich auf meu.pluggy.ai. Tippe auf dem Willkommensbildschirm auf den Hauptbutton, um eine Bank zu verbinden.
Meu Pluggy-Start — tippe auf den Hauptbutton, um eine Bank zu verbinden.
Suche deine Bank, wähle sie aus und schließe den Open-Finance-Flow der Bank ab (CPF, Filiale, Passwort oder SMS — je nach Bank).
Wähle deine Bank aus der Liste.
Gib deine CPF ein und schließe den Bank-Login ab.
Wenn es klappt, erscheint die Bank unter verbundenen Konten. Wiederhole das für jede brasilianische Bank, die du in Liquify willst (bis zu 5 pro Person).
Verbundene Banken erscheinen hier.
2. Pluggy-Developer-Konto erstellen
Registrieren Sie sich unter dashboard.pluggy.ai. Pluggy kann eine kurze Dashboard-Testphase starten — für dieses Setup ignorieren. Meu Pluggy bleibt kostenlos für persönliche Bank-Synchronisierung; Liquify verlangt für diesen Brazil-BYOK-Pfad kein Ultra.
3. Meu Pluggy-Connector aktivieren
Im Pluggy-Dashboard öffne Customization → Connector list. Meu Pluggy ist leicht zu übersehen — aktiviere ihn, bevor du weitergehst.
Customization → Connector list.
Nach dem Aktivieren sollte Meu Pluggy in deiner Connector-Liste erscheinen. Ohne diesen Schritt zeigt Demo-OAuth Meu Pluggy später nicht.
Meu Pluggy in der Connector-Liste aktiviert.
4. Development Application erstellen und Keys kopieren
Auf der Application-Seite erstelle eine Development Application. Du erhältst Client ID und Client Secret zum Einfügen in Liquify.
Erstelle eine Development Application.
Kopiere beide Werte. Speichere das Client Secret sofort — Pluggy zeigt es möglicherweise nur einmal.
Kopiere Client ID und Client Secret.
5. Meu Pluggy in Pluggy Demo autorisieren (einmal pro Bank)
Öffne Pluggy Demo im Dashboard, starte eine Verbindung und wähle Meu Pluggy, um OAuth zu beginnen.
Starte Meu Pluggy-OAuth in Pluggy Demo.
Erlaube den Zugriff und wähle, welche Meu Pluggy-Bank geteilt werden soll. Einmal pro Bank, nicht pro Konto.
Wähle die Bank und erlaube den Zugriff.
Nach erfolgreicher Autorisierung zeigt die Demo das verknüpfte Meu Pluggy-Item. Jede Bank wird zu einem eigenen Item.
Autorisiert — die Bank ist bereit zum Import.
6. Item ID kopieren und in Liquify fertigstellen
Auf der Items-Seite im Pluggy-Dashboard (oder im Demo-Item-Menü) kopiere die Item ID (UUID) dieser Bank.
In Liquify: Bank verbinden → Brasilien → Client ID, Client Secret und Item ID einfügen. Liquify verschlüsselt die Keys auf unseren Servern und startet den Sync.
Dieselbe Client ID und Secret gelten für alle Banken; jede Bank braucht ihre eigene Item ID. Liquify aktualisiert etwa alle 6 Stunden und beim Ziehen zum Aktualisieren. Trennen in Liquify löscht deine Verbindung in Meu Pluggy oder Pluggy nicht.
7. Bank und Konten in Liquify umbenennen
Unter Bank verbinden öffnen Sie Bank bearbeiten. Legen Sie einen Banknamen und einen Namen für jedes Konto fest, damit Sie sie beim Verknüpfen von Kategorien leicht finden. Ein leeres Feld behält die aktuelle Bezeichnung.
Bank bearbeiten — benennen Sie Bank und Konten in Liquify um.
Fertig, wenn…
Liquify zeigt die Bank unter Bank verbinden / Konten mit Salden. Verknüpfe Konten mit Kategorien in Ausgabenkategorie bearbeiten, wenn du Plan vs. Konten willst.
Wenn die Verbindung Erneut verbinden benötigt zeigt, tippe in Liquify auf Erneut verbinden und gib Client ID, Client Secret und Item ID erneut ein — die Felder können schon von letztem Mal ausgefüllt sein. Das aktualisiert nur Liquify; es öffnet nicht deine Bank. Wenn die Bankzustimmung selbst abgelaufen ist (oft etwa alle 90 Tage), erneuere sie zuerst in Meu Pluggy / Pluggy Demo und nutze danach Erneut verbinden in Liquify mit der aktuellen Item ID.