ifixkart-admin/docs/commerce/payments.md
Adithiyan bbd3a3e959 feat: initial commit — full platform snapshot
- Backend: FastAPI app with all models, services, schemas, routes
- Admin Panel: Next.js dashboard with all modules
  (CRM, POS, repairs, warranties, billing, notifications, etc.)
- Ecommerce: storefront (submodule) + product catalog
- AI Agents: .agents/ skill library for Antigravity IDE
- Docs: architecture, billing, notification gateway markdown
- Submodules: Backend/OpenWA, Ecommerce/File 2/storefront
2026-10-13 12:59:47 +05:30

680 B

Payment Engine Architecture

Overview

Managed via PaymentRouter.py. Supports Razorpay online payments and Cash/Offline payments.


Payment Status Ledger

Every transaction is recorded in an append-only payment_ledger:

Field Type Description
payment_id String(26) ULID Primary key
order_id String(26) ULID Foreign key to orders
provider String(30) RAZORPAY, CASH, POS_CARD
transaction_ref String(100) Provider transaction ID
amount Numeric(10, 2) Payment amount
status String(30) PENDING, CAPTURED, FAILED, REFUNDED
created_at DateTime Timestamp