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

21 lines
680 B
Markdown

# 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 |