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>
72 lines
1.7 KiB
Markdown
72 lines
1.7 KiB
Markdown
# Phase 14.8 — Vertical Connectors & Checkout Contracts
|
|
|
|
| Field | Value |
|
|
| --- | --- |
|
|
| Identifier | `payment-14.8` |
|
|
| Implementation Priority | **LATER** |
|
|
| Status | Planned |
|
|
| Service | `payment` |
|
|
| Depends On | `payment-14.5` |
|
|
|
|
> Full specification: [payment-roadmap.md](../../payment-roadmap.md#phase-14-8--vertical-connectors--checkout-contracts)
|
|
|
|
## Purpose
|
|
|
|
Versioned consumer connector contracts for Hospitality, Marketplace, Sports Center, Experience, CRM, Healthcare, Beauty, Delivery, Automation, and future services.
|
|
|
|
## Business Scope
|
|
|
|
Standard checkout session: create → pay → confirm. Document embed/redirect shapes.
|
|
|
|
## Technical Scope
|
|
|
|
PaymentConnectorRegistration, PaymentConnectorDispatch, CheckoutSession. Mock Hospitality + Marketplace connectors.
|
|
|
|
## Dependencies
|
|
|
|
`payment-14.5`
|
|
|
|
## Out of Scope
|
|
|
|
Vertical client implementation; frontend checkout UI.
|
|
|
|
## Capabilities
|
|
|
|
`payment.connectors`, `payment.checkout_sessions`
|
|
|
|
## Permissions
|
|
|
|
`payment.connectors.manage`, `payment.checkout_sessions.create|view`
|
|
|
|
## Events
|
|
|
|
`payment.connector.registered`, `payment.checkout_session.created|completed|expired`
|
|
|
|
## API Contracts
|
|
|
|
Connector CRUD; POST checkout-sessions; POST complete
|
|
|
|
## Data Ownership
|
|
|
|
Payment owns checkout session shell; vertical owns order/ticket.
|
|
|
|
## Provider Ownership
|
|
|
|
Connector contract surface owned by Payment.
|
|
|
|
## Integration Rules
|
|
|
|
One session → one payment request chain; subscribe to `payment.transaction.recorded`.
|
|
|
|
## Quality Gates
|
|
|
|
Contract tests, mock vertical dispatch, no cross-DB imports.
|
|
|
|
## Definition of Done
|
|
|
|
Two mock connectors documented and tested.
|
|
|
|
## Future Compatibility
|
|
|
|
Mobile/web SDK stubs; webhook subscription registry.
|