Brazilian banks through Open Finance. Users give their Pluggy client
credentials and the ids of their connections (items), from Meu Pluggy.
- Uses the cursor-paginated /v2/transactions; /transactions is removed
after 2026-12-31. Our own filters are sent again with each cursor.
- The direction comes from `type`, not the amount's sign: credit cards
keep the card's sign, purchases are positive. Checked against a real
Meu Pluggy card and checking account; the sandbox data doesn't match
production here.
- Pending transactions keep their id once they post (a card's open bill
stays pending until it closes), so they're imported unpaid and settled
later. Future-dated ones (installments, scheduled payments) wait for
their date. Installments already come dated in their own month.
- Foreign purchases use the account's amount, with the original amount
in the notes.
- Connections that need the user to log in again show as an error.
Providers can now return pending transactions, flagged as such, when
their ids survive posting. They're imported unpaid right away and, once
the bank posts them, marked paid with their final amount and date.
- Settling happens once, so later edits stick, and one marked paid by
hand is left alone. It goes through save() so a transfer's other side
follows; no rules run again. reference_date moves only if it still
followed the date.
- Each sync looks back to the oldest unpaid synced transaction, since a
card purchase can post weeks later when the bill closes. Pending ones
older than 60 days are taken as cancelled and no longer followed.
Users paste a one-time setup token. On save it's claimed and the access
URL it returns is stored; credentials go in a header, never the URL, so
errors don't leak them.
- Providers can validate or transform their settings (clean_settings),
run by the service form once every other field is valid, so a token
isn't spent on a form that fails anyway.
- Providers can declare a minimum sync interval. SimpleFIN Bridge
disables tokens that go much past ~24 requests a day, so it's 6 hours.
- Tokens and access URLs are user input pointing the server at a host:
only SimpleFIN Bridge is allowed unless SIMPLEFIN_ALLOWED_HOSTS says
otherwise. Checked again on every request, for restored settings.
- Transactions are fetched per account in 90-day windows, Bridge's
limit per request. Pending ones are skipped.
Provider registry modeled after automatic exchange rates: each provider
declares its own settings fields, rendered dynamically in the service form.
Lunch Flow is the first provider.
- Map provider accounts to WYGIWYH accounts with a start date and an
optional currency filter
- Hourly task syncs due services; manual sync from the list
- Deduplicates through Transaction.internal_id, optionally matching
transactions already entered by hand
- Per account errors and provider reported connection problems
Refs #498