9fac160258
Add independent payment-service (port 8012, payment_db) with foundation licensing, BYO-PSP, merchant accounts, idempotent requests, callbacks, and immutable ledger. Co-authored-by: Cursor <cursoragent@cursor.com>
63 lines
2.9 KiB
Markdown
63 lines
2.9 KiB
Markdown
# Payment Platform Phase Area (Torbat Pay)
|
||
|
||
Independent enterprise **Payment Platform** (`payment-service`, `payment_db`, port **8012**). Commercial product: **Torbat Pay**.
|
||
|
||
Supports **BYO-PSP** (tenant-owned gateways) and **Torbat Pay Merchant** (facilitator) modes for all TorbatYar verticals via API + Events only.
|
||
|
||
## Phase Numbering
|
||
|
||
Payment track phases are **14.0–14.10** with manifest IDs `payment-14.x`.
|
||
Beauty Business uses a separate track: `beauty-business-14.x` — see [beauty-business-roadmap.md](../../beauty-business-roadmap.md).
|
||
|
||
## Status
|
||
|
||
| Phase | Title | Implementation Priority | Status |
|
||
| --- | --- | --- | --- |
|
||
| Reg | Platform Registration | — | Complete |
|
||
| Arch | Architecture Prerequisites | — | Complete |
|
||
| 14.0 | Payment Foundation | HIGH | Complete |
|
||
| 14.1 | PSP Management | HIGH | Complete |
|
||
| 14.2 | Merchant Accounts | HIGH | Complete |
|
||
| 14.3 | Payment Requests | HIGH | Complete |
|
||
| 14.4 | Callback & Verification | HIGH | Complete |
|
||
| 14.5 | Transaction Ledger | HIGH | Complete |
|
||
| 14.6 | Refunds & Reversals | LATER | Planned |
|
||
| 14.7 | Split Payments & Facilitator Settlement | LATER | Planned |
|
||
| 14.8 | Vertical Connectors & Checkout Contracts | LATER | Planned |
|
||
| 14.9 | Reconciliation & Accounting Integration | LATER | Planned |
|
||
| 14.10 | Analytics, Fraud Shells & Enterprise Validation | LATER | Planned |
|
||
|
||
## Documents
|
||
|
||
- [Roadmap](../../payment-roadmap.md) — authoritative phase specifications
|
||
- [Pay-Reg](../../payment-phase-pay-reg.md)
|
||
- [Pay-Arch](../../payment-phase-pay-arch.md)
|
||
- [Handover Pay-Reg](../../phase-handover/phase-pay-reg.md)
|
||
- [Handover Pay-Arch](../../phase-handover/phase-pay-arch.md)
|
||
- [Handover 14.5 MVP](../../phase-handover/phase-14-5.md)
|
||
- [Payment Contracts](../../reference/payment-contracts.md)
|
||
- [ADR-020](../../architecture/adr/ADR-020.md)
|
||
- [ADR-021](../../architecture/adr/ADR-021.md)
|
||
- [AI Framework](../../ai-framework/README.md)
|
||
|
||
### Phase Documents
|
||
|
||
- [14.0 Payment Foundation](phase-14-0-payment-foundation.md)
|
||
- [14.1 PSP Management](phase-14-1-psp-management.md)
|
||
- [14.2 Merchant Accounts](phase-14-2-merchant-accounts.md)
|
||
- [14.3 Payment Requests](phase-14-3-payment-requests.md)
|
||
- [14.4 Callback & Verification](phase-14-4-callback-verification.md)
|
||
- [14.5 Transaction Ledger](phase-14-5-transaction-ledger.md)
|
||
- [14.6 Refunds & Reversals](phase-14-6-refunds-reversals.md)
|
||
- [14.7 Split & Settlement](phase-14-7-split-settlement.md)
|
||
- [14.8 Vertical Connectors](phase-14-8-vertical-connectors.md)
|
||
- [14.9 Reconciliation](phase-14-9-reconciliation.md)
|
||
- [14.10 Enterprise Validation](phase-14-10-enterprise-validation.md)
|
||
|
||
## Boundary Reminder
|
||
|
||
Payment owns PSP routing, callbacks, and payment-domain ledger.
|
||
Verticals own checkout/commercial context.
|
||
Accounting owns journals. Communication owns message delivery.
|
||
Do not embed PSP SDKs in Hospitality, Marketplace, or other services.
|