settleflow 0.7.5

Live demo (free) · User guide · Changelog · Contributing · Security

For merchants and accountants reconciling UPI payouts against bank credits. A gateway settlement file and a bank statement go in; matched rows, an explicit exception list, and Tally / GST / TDS code-1035 (ex-194O) workpapers come out. Open source (MIT), Python, zero runtime dependencies — the core runs on the standard library alone, enforced by CI.

Why not just use the gateway's own settlement reports? They tell you what the gateway says it sent. They never check against the credit that actually landed in your bank, and they don't produce workpapers. UPI settles as bulk NEFT credits: one undifferentiated bank line against hundreds of orders. The match key is not the UTR — your bank's UTR is the correspondent bank's, a different number. SettleFlow closes that gap deterministically, and every match is inspectable.

Install

Not on PyPI yet — install from source (the core needs no dependencies at all):

pip install "settleflow @ git+https://github.com/AtlasNex/settleflow.git"

Or clone and run from the repo root. Python ≥ 3.10 (CI runs 3.10–3.12).

60-second tour

# the library — one command, three workpapers in out/
python -m settleflow reconcile \
    --settlements settlements.csv --vendor razorpay_settlement_csv \
    --bank sbi --statement statement.csv --out-dir out

# the hosted app locally (needs: pip install "settleflow[saas]")
python -m uvicorn saas.app:app --port 8093
# open http://127.0.0.1:8093 — or the live demo at settleflow.atlasnex.com

# the single runnable self-check (no test framework, by design)
python tests/test_matching.py        # prints "all 77 checks passed"

10-second example

from datetime import date
from decimal import Decimal
from settleflow import Txn, match

settlements = [Txn("123456789012", Decimal("100.00"), date(2026, 8, 15))]
bank        = [Txn("1234 5678 9012", Decimal("100.00"), date(2026, 8, 16))]

result = match(settlements, bank)
print(result.matched)           # one exact match — UTRs normalized, money is Decimal
print(result.settlement_only)   # in the gateway file, not in your bank
print(result.bank_only)         # in your bank, not in the gateway file

What it reads

A format with no verified public sample is refused, never guessed — that is why IDFC and Cashfree's plain settlements export stay unwired (guessing a column layout is how silently wrong ledgers get made). docs/SCHEMAS.md traces every wired format to its source.

Library API

from settleflow import parse_razorpay_recon, group_batches, match_orders

lines = parse_razorpay_recon(api_response_dict)   # GET /v1/settlements/recon/combined
batches = group_batches(lines)                    # netting: gross − MDR − GST − refunds
orders = [Txn(None, Decimal("1000.00"), date(2026, 8, 15), ref="order_123")]
result = match_orders(lines, orders)              # payments joined to your order ledger

Exports: export_tally_csv, export_gst_worksheet, export_tds_1035. Exceptions: rule-based classify, a build_llm_prompt helper, a provider-agnostic triage_exceptions hook. Full API: docs/ARCHITECTURE.md.

Optional extras

The core is stdlib-only — these are opt-in and lazily imported:

Security posture (honest)

• Core library: stdlib only, no network calls of any kind — local file in, local file out.
• The hosted service: run URLs are bearer credentials (no-store everywhere, including the CDN), uploads size-capped and work-capped, rate limits keyed so a caller cannot mint identity per request, malformed input refused as 400 — never 500, never a crash.
• The first real Strix AI pentest ran on this repo (v0.7.4); all 12 findings (1 high, 5 medium) are fixed in 0.7.5 with live-gate evidence per fix — see CHANGELOG.md and docs/DECISIONS.md D-38…D-42.
• Found something? SECURITY.md — email, not a public issue.

Status — what works, what doesn't

Built: the table above, a CLI, exception classification, the hosted beta (saas/, deployable via Docker or plain systemd+Cloudflare-Tunnel), CI on three Python versions plus a boot-and-reconcile integration job, 77 assert-based checks.

Not built — don't pretend otherwise: no PyPI release yet (name pending), non-SBI bank PDFs, a user model or API keys (the service is deliberately stateless per run), and any SLA. Pre-1.0: no API-stability promise. Legal pages in docs/legal/ are drafts pending professional review.

Pricing, honestly

• Library: MIT, free forever. Self-hosting: free.
• Hosted service: free while in beta. No commercial tier is live; if that changes it will be announced here and on the site.

Docs

License

MIT — see LICENSE. The one asymmetry that matters: you can audit exactly how your reconciliation is computed, which no closed reconciliation SaaS will let you do.

Built by AtlasNex · sanjay@atlasnex.com