Frequently Asked Questions
Answers to common questions about Reconbanker — what it is, how it works, security, setup, and support.
Frequently Asked Questions
Product & Value
What is Reconbanker?
Reconbanker is a self-hosted software that reconciles money for you. It ingests the payments your system receives through an API or webhook and automatically cross-references them against the transactions on your bank statement. Instead of matching rows by hand in a spreadsheet, you get a clear, real-time view of what was paid versus what actually landed in the bank. It is a piece of software you run, not a service you subscribe to.
Is it really free and open source?
Yes. The full reconciliation engine is open source under a permissive license. You can read the code, audit it, contribute, fork it, and run it however you like. There is no paid tier, no SaaS, and no feature locked behind a license key. What you self-host is the complete product.
Why use Reconbanker instead of reconciling manually?
Manual reconciliation breaks down as soon as volume grows — spreadsheets get stale, matches get missed, and discrepancies surface late. Reconbanker gives you an automated, real-time, audit-ready view of money expected versus money received, so you catch missing, duplicated, or mismatched amounts before they become a problem.
How it works
What's the difference between reconcile and passthrough modes?
Reconbanker runs in one of two modes. In reconcile mode, it asks your system for the payments you are expecting and matches each new bank transaction against them, flagging matches, ambiguities, and expirations. In passthrough mode, it does no matching — it simply forwards every new bank transaction to your webhook so you can handle the logic yourself. You pick the mode once, per user, and it applies to all your bank accounts.
Which banks and payment providers are supported?
On the payment side, Reconbanker accepts events from any provider that can send a webhook — Stripe, MercadoPago, or a custom API. On the bank side, coverage is extensible through bank scripts: each bank is a script that reads its transactions, so new banks can be added by the community or contributed as needed.
→ Reference: Banks
Can I reconcile multiple bank accounts?
Yes. You can connect as many bank accounts as you need. Each one is reconciled independently, runs in its own mode, and shows up as a separate ledger in the dashboard.
Setup & Requirements
What do I need to get started?
Two things: a payment source and a bank. For the payment source, you configure your provider (Stripe, MercadoPago, or your own API) to send webhooks to Reconbanker. For the bank, you provide the credentials Reconbanker uses to read your transactions. With both connected, an account is ready to reconcile.
→ Full guide: Getting Started
How do I install it and get it running?
Clone the repository and follow the getting-started guide. Reconbanker runs entirely on your own infrastructure — a server, a VM, or a container you control. Once it is up, you point your payment provider's webhook at it and connect a bank account, and it starts reconciling.
→ Full guide: Getting Started
Security & Privacy
Do my data and bank credentials ever leave my infrastructure?
No. Reconbanker runs entirely on infrastructure you control. Your payment data, bank transactions, and credentials stay on your own servers — nothing is sent to a third party, because there is no third party involved.
How are sensitive bank credentials stored?
Bank credentials are encrypted at rest inside your own instance. They never leave your infrastructure, so the security perimeter is entirely yours to define and control.
Does Reconbanker send any telemetry?
No. Self-hosted instances send no telemetry and phone home to nothing. The software does what you configure it to do and nothing else.
Scale & Support
Is there a limit on how many payments I can reconcile?
No. Because you self-host Reconbanker, there are no artificial caps on payments, transactions, or accounts. The only limit is the hardware you choose to run it on.
What kind of support is available?
Support is community-driven through GitHub issues. Since the project is open source, you can also read the code directly to understand behavior, debug your setup, and contribute fixes or improvements back.
How do I report a bug or request a feature?
Open an issue on the GitHub repository. Bug reports, feature requests, and questions all go through the same place, and contributions via pull request are welcome.