@ingenx-io/valets-schema-mcp-server 0.1.2 → 0.1.4

package/data/docs/collections/firestore-paths.md

@@ -6,7 +6,7 @@ sidebar_position: 1
 
 # Firestore Collection Paths
 
-All collections are scoped under a company document.
+All collections are scoped under a company document. Per **D40**, a `sites/{siteId}/` sub-tenant scope sits below `companies/{companyId}/` for site-specific collections (ING-304).
 
 ```
 companies/{companyId}/
@@ -19,17 +19,37 @@ companies/{companyId}/
 ├── sales/{saleId}
 ├── purchases/{purchaseId}
 ├── customerPayments/{paymentId}
+├── paymentSummaries/{period}
 ├── loyaltyTransactions/{transactionId}
-└── loyaltyConfig (singleton document)
+├── loyaltyConfig (singleton document)
+└── sites/{siteId}/                      ← D40 sub-tenant scope
+    ├── magic_link_requests/{requestId}  ← 16-byte hex; auth audit log
+    ├── allowed_users/{contactId}        ← access allowlist; doc ID = email / E.164 phone (URL-escaped)
+    ├── payments/{paymentId}             ← SitePayment — immutable transaction ledger
+    └── analytics_events/{eventId}       ← append-only product/behavior event stream
 ```
 
 ## Path conventions
 
 - All paths are **tenant-scoped** under `companies/{companyId}/`
+- Site-specific collections live under `companies/{companyId}/sites/{siteId}/` (D40)
 - Sub-collections (sessions, tickets) are nested under their parent
 - `loyaltyConfig` is a singleton document, not a collection
 - Document IDs are auto-generated Firestore IDs unless specified
 
+## D40 — Site sub-tenant scope
+
+Introduced for ING-304 (canonical Firestore models derived from the SR Single site reference). The four site-scoped collections share one rationale: they belong to a *site* (a per-company product surface), not to the company as a whole. A company may host many sites.
+
+| Collection | Purpose | Write pattern |
+|---|---|---|
+| `magic_link_requests` | Authentication audit log — every access request | Two-stage PATCH (request → verify) |
+| `allowed_users` | Authoritative paid-access allowlist; referral-code resolution table | Upsert by contact ID |
+| `payments` | Immutable SitePayment ledger (distinct from `customerPayments`) | Append-only; dual-write (redirect + webhook) |
+| `analytics_events` | Product/behavior event stream (page views, funnel, forms, orders, identity, errors) | Append-only, immutable |
+
+Related follow-ups: [ING-340](https://linear.app/ingenx/issue/ING-340) (retention/TTL), [ING-341](https://linear.app/ingenx/issue/ING-341) (PII redaction convention).
+
 ## Security rules pattern
 
 ```

package/data/docs/enums/attention-status.md

@@ -0,0 +1,24 @@
+---
+title: "AttentionStatus"
+sidebar_label: "AttentionStatus"
+sidebar_position: 1
+---
+
+# AttentionStatus
+
+|                |                                |
+| -------------- | ------------------------------ |
+| **Type**       | `enum (of string)`             |
+| **Required**   | No                             |
+| **Defined in** | #/definitions/attention-status |
+
+**Description:** Operational attention status for Order and Booking (D39). Controls home-page queue assignment. Server-owned — set via triggers or callable fn only.
+
+Must be one of:
+* "ACTIVE"
+* "STALE"
+* "ON_HOLD"
+* "ESCALATED"
+
+----------------------------------------------------------------------------------------------------------------------------
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-04-18 at 21:21:09 +0000

package/data/docs/enums/booking-status.md

@@ -1,7 +1,7 @@
 ---
 title: "BookingStatus"
 sidebar_label: "BookingStatus"
-sidebar_position: 1
+sidebar_position: 2
 ---
 
 # BookingStatus
@@ -23,4 +23,4 @@ Must be one of:
 * "COMPLETED_MIXED"
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-03-09 at 13:15:53 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-04-18 at 21:21:09 +0000

package/data/docs/enums/customer-payment-status.md

@@ -1,7 +1,7 @@
 ---
 title: "CustomerPaymentStatus"
 sidebar_label: "CustomerPaymentStatus"
-sidebar_position: 2
+sidebar_position: 3
 ---
 
 # CustomerPaymentStatus
@@ -23,4 +23,4 @@ Must be one of:
 * "CANCELLED"
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-03-09 at 13:15:53 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-04-18 at 21:21:09 +0000

package/data/docs/enums/customer-payment-target-type.md

@@ -1,7 +1,7 @@
 ---
 title: "CustomerPaymentTargetType"
 sidebar_label: "CustomerPaymentTargetType"
-sidebar_position: 3
+sidebar_position: 4
 ---
 
 # CustomerPaymentTargetType
@@ -20,4 +20,4 @@ Must be one of:
 * "PURCHASE"
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-03-09 at 13:15:53 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-04-18 at 21:21:09 +0000

package/data/docs/enums/delivery-type.md

@@ -1,7 +1,7 @@
 ---
 title: "DeliveryType"
 sidebar_label: "DeliveryType"
-sidebar_position: 4
+sidebar_position: 5
 ---
 
 # DeliveryType
@@ -20,4 +20,4 @@ Must be one of:
 * "DELIVERY"
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-03-09 at 13:15:53 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-04-18 at 21:21:09 +0000

package/data/docs/enums/event-status.md

@@ -1,7 +1,7 @@
 ---
 title: "EventStatus"
 sidebar_label: "EventStatus"
-sidebar_position: 5
+sidebar_position: 6
 ---
 
 # EventStatus
@@ -21,7 +21,7 @@ Must be one of:
 * "COMPLETED"
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-03-09 at 13:15:53 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-04-18 at 21:21:09 +0000
 
 ## Related Decisions
 

package/data/docs/enums/fulfillment-status.md

@@ -1,7 +1,7 @@
 ---
 title: "FulfillmentStatus"
 sidebar_label: "FulfillmentStatus"
-sidebar_position: 6
+sidebar_position: 7
 ---
 
 # FulfillmentStatus
@@ -23,7 +23,7 @@ Must be one of:
 * "PICKED_UP"
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-03-09 at 13:15:53 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-04-18 at 21:21:09 +0000
 
 ## Related Decisions
 

package/data/docs/enums/loyalty-transaction-type.md

@@ -1,7 +1,7 @@
 ---
 title: "LoyaltyTransactionType"
 sidebar_label: "LoyaltyTransactionType"
-sidebar_position: 7
+sidebar_position: 8
 ---
 
 # LoyaltyTransactionType
@@ -23,7 +23,7 @@ Must be one of:
 * "REFUND"
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-03-09 at 13:15:53 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-04-18 at 21:21:09 +0000
 
 ## Related Decisions
 

package/data/docs/enums/order-status.md

@@ -1,7 +1,7 @@
 ---
 title: "OrderStatus"
 sidebar_label: "OrderStatus"
-sidebar_position: 8
+sidebar_position: 9
 ---
 
 # OrderStatus
@@ -24,7 +24,7 @@ Must be one of:
 * "EXPIRED"
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-03-09 at 13:15:53 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-04-18 at 21:21:09 +0000
 
 ## Related Decisions
 

package/data/docs/enums/payment-method.md

@@ -1,7 +1,7 @@
 ---
 title: "PaymentMethod"
 sidebar_label: "PaymentMethod"
-sidebar_position: 9
+sidebar_position: 10
 ---
 
 # PaymentMethod
@@ -27,7 +27,7 @@ Must be one of:
 * "OTHER"
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-03-09 at 13:15:53 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-04-18 at 21:21:09 +0000
 
 ## Related Decisions
 

package/data/docs/enums/payment-proof-status.md

@@ -1,7 +1,7 @@
 ---
 title: "PaymentProofStatus"
 sidebar_label: "PaymentProofStatus"
-sidebar_position: 10
+sidebar_position: 11
 ---
 
 # PaymentProofStatus
@@ -20,4 +20,4 @@ Must be one of:
 * "REJECTED"
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-03-09 at 13:15:53 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-04-18 at 21:21:09 +0000

package/data/docs/enums/payment-status.md

@@ -1,7 +1,7 @@
 ---
 title: "PaymentStatus"
 sidebar_label: "PaymentStatus"
-sidebar_position: 11
+sidebar_position: 12
 ---
 
 # PaymentStatus
@@ -24,7 +24,7 @@ Must be one of:
 * "PARTIALLY_REFUNDED"
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-03-09 at 13:15:53 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-04-18 at 21:21:09 +0000
 
 ## Related Decisions
 

package/data/docs/enums/pending-issue.md

@@ -0,0 +1,31 @@
+---
+title: "PendingIssue"
+sidebar_label: "PendingIssue"
+sidebar_position: 13
+---
+
+# PendingIssue
+
+|                |                             |
+| -------------- | --------------------------- |
+| **Type**       | `enum (of string)`          |
+| **Required**   | No                          |
+| **Defined in** | #/definitions/pending-issue |
+
+**Description:** Specific detected conditions on an Order or Booking requiring human action (D39). Stored as an array — multiple issues can be active simultaneously. Server-owned.
+
+Must be one of:
+* "PAYMENT_PROOF_PENDING"
+* "PAYMENT_PROOF_REJECTED"
+* "AMOUNT_DISCREPANCY"
+* "RETURN_UNRESOLVED"
+* "OVERDUE_DELIVERY"
+* "SESSION_OVERDUE"
+* "PAYMENT_INCOMPLETE"
+* "CANCELLATION_REQUESTED"
+* "UNREFUNDED_CANCELLATION"
+* "UPCOMING_UNPAID"
+* "NO_SHOW_UNRESOLVED"
+
+----------------------------------------------------------------------------------------------------------------------------
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-04-18 at 21:21:09 +0000

package/data/docs/enums/return-status.md

@@ -1,7 +1,7 @@
 ---
 title: "ReturnStatus"
 sidebar_label: "ReturnStatus"
-sidebar_position: 12
+sidebar_position: 14
 ---
 
 # ReturnStatus
@@ -23,7 +23,7 @@ Must be one of:
 * "EXCHANGE_COMPLETED"
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-03-09 at 13:15:53 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-04-18 at 21:21:09 +0000
 
 ## Related Decisions
 

package/data/docs/enums/session-status.md

@@ -1,7 +1,7 @@
 ---
 title: "SessionStatus"
 sidebar_label: "SessionStatus"
-sidebar_position: 13
+sidebar_position: 15
 ---
 
 # SessionStatus
@@ -23,7 +23,7 @@ Must be one of:
 * "CANCELLED"
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-03-09 at 13:15:53 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-04-18 at 21:21:09 +0000
 
 ## Related Decisions
 

package/data/docs/enums/ticket-status.md

@@ -1,7 +1,7 @@
 ---
 title: "TicketStatus"
 sidebar_label: "TicketStatus"
-sidebar_position: 14
+sidebar_position: 16
 ---
 
 # TicketStatus
@@ -20,7 +20,7 @@ Must be one of:
 * "CANCELLED"
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-03-09 at 13:15:53 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-04-18 at 21:21:09 +0000
 
 ## Related Decisions
 

package/data/docs/index.md

@@ -19,12 +19,13 @@ Developers own the Zod source in `packages/schema/src/`. When schemas change, th
 
 ## What's documented
 
-### Enums (14)
+### Enums (16)
 
 Status enums that drive business logic across Order, Booking, Event, and Loyalty domains:
 
 | Enum | Values | Description |
 |------|--------|-------------|
+| [AttentionStatus](enums/attention-status) | 4 values | Operational attention status for Order and Booking (D39). Controls home-page queue assignment. Server-owned — set via triggers or callable fn only. |
 | [BookingStatus](enums/booking-status) | 6 values | Booking lifecycle status. COMPLETED_MIXED = some sessions completed, others cancelled/no-show. |
 | [CustomerPaymentStatus](enums/customer-payment-status) | 6 values | Customer payment lifecycle status (D22). Tracks allocation progress of received payments. |
 | [CustomerPaymentTargetType](enums/customer-payment-target-type) | 3 values | Target document type for customer payment allocation. |
@@ -36,17 +37,20 @@ Status enums that drive business logic across Order, Booking, Event, and Loyalty
 | [PaymentMethod](enums/payment-method) | 10 values | Unified payment method set with African + global methods (D02). |
 | [PaymentProofStatus](enums/payment-proof-status) | 3 values | Payment proof review status. Used by Order and Booking payment proof workflows. |
 | [PaymentStatus](enums/payment-status) | 7 values | Payment lifecycle status (D01 amended). Used by Order, Sale/Purchase, Booking. |
+| [PendingIssue](enums/pending-issue) | 11 values | Specific detected conditions on an Order or Booking requiring human action (D39). Stored as an array — multiple issues can be active simultaneously. Server-owned. |
 | [ReturnStatus](enums/return-status) | 6 values | Post-sale return/exchange lifecycle (D34). Optional — null until return or exchange initiated. |
 | [SessionStatus](enums/session-status) | 6 values | Per-date/per-slot booking session status (D19). Dashboard is sole writer; Mobile is read-only. |
 | [TicketStatus](enums/ticket-status) | 3 values | Event ticket status (D32). VALID = active and unused. |
 
 
-### Models (17)
+### Models (21)
 
 Core Firestore document schemas:
 
 | Model | Fields | Required | Description |
 |-------|--------|----------|-------------|
+| [AllowedUser](models/allowed-user) | 9 | 8 | — |
+| [AnalyticsEvent](models/analytics-event) | 12 | 10 | — |
 | [Booking](models/booking) | 52 | 7 | — |
 | [BookingVersion](models/booking-version) | 9 | 6 | — |
 | [Customer](models/customer) | 17 | 4 | — |
@@ -57,12 +61,14 @@ Core Firestore document schemas:
 | [LoyaltyReward](models/loyalty-reward) | 11 | 5 | — |
 | [LoyaltyStatus](models/loyalty-status) | 9 | 2 | — |
 | [LoyaltyTransaction](models/loyalty-transaction) | 16 | 4 | — |
+| [MagicLinkRequest](models/magic-link-request) | 15 | 11 | — |
 | [MetricsCurrent](models/metrics-current) | 25 | 25 | — |
 | [MetricsDaily](models/metrics-daily) | 26 | 26 | — |
 | [MetricsMonthly](models/metrics-monthly) | 26 | 26 | — |
 | [Order](models/order) | 47 | 8 | — |
 | [OrderItem](models/order-item) | 12 | 3 | — |
 | [Sale](models/sale) | 12 | 1 | — |
+| [SitePayment](models/site-payment) | 10 | 9 | — |
 | [Ticket](models/ticket) | 16 | 6 | — |
 
 
@@ -79,6 +85,13 @@ Core Firestore document schemas:
 
 
 
+| Enum | Values | Description |
+|------|--------|-------------|
+| [AttentionStatus](proposed/enums/attention-status) | 4 values | Operational attention status for Order and Booking (D39). Controls home-page queue assignment. Server-owned — set via triggers or callable fn only. |
+| [PendingIssue](proposed/enums/pending-issue) | 11 values | Specific detected conditions on an Order or Booking requiring human action (D39). Stored as an array — multiple issues can be active simultaneously. Server-owned. |
+
+
+
 
 ## Machine-friendly formats
 

package/data/docs/models/allowed-user.md

@@ -0,0 +1,188 @@
+---
+title: "AllowedUser"
+sidebar_label: "AllowedUser"
+sidebar_position: 1
+---
+
+# AllowedUser
+
+<details>
+<summary>Example JSON</summary>
+
+```json
+{
+  "id": null,
+  "companyId": "comp_xyz789",
+  "siteId": "sit_ref123",
+  "contact": "contact",
+  "tier": "Gold",
+  "amount": 45000,
+  "currency": "XOF",
+  "transactionId": "tra_ref123",
+  "paidAt": "pai_ref123"
+}
+```
+
+</details>
+
+
+- [1. Property `id`](#id)
+- [2. Property `companyId`](#companyId)
+- [3. Property `siteId`](#siteId)
+- [4. Property `contact`](#contact)
+- [5. Property `tier`](#tier)
+- [6. Property `amount`](#amount)
+- [7. Property `currency`](#currency)
+- [8. Property `transactionId`](#transactionId)
+- [9. Property `paidAt`](#paidAt)
+  - [9.1. Property `_seconds`](#paidAt__seconds)
+  - [9.2. Property `_nanoseconds`](#paidAt__nanoseconds)
+
+|                           |                            |
+| ------------------------- | -------------------------- |
+| **Type**                  | `object`                   |
+| **Required**              | No                         |
+| **Additional properties** | Not allowed                |
+| **Defined in**            | #/definitions/allowed-user |
+
+**Description:** AllowedUser model (D40 / ING-304). Collection: companies/\{companyId\}/sites/\{siteId\}/allowed_users/\{contactId\}. Authoritative paid-access allowlist. Upsert semantics — tier upgrades overwrite. Source of truth for access checks and referral code resolution.
+
+| Property                           | Pattern | Type           | Deprecated | Definition                           | Title/Description                                                                                |
+| ---------------------------------- | ------- | -------------- | ---------- | ------------------------------------ | ------------------------------------------------------------------------------------------------ |
+| - [id](#id )                       | No      | string or null | No         | -                                    | (Read-only) Firestore document ID = contact identifier (email or E.164 phone), URL-escaped.      |
+| + [companyId](#companyId )         | No      | string         | No         | -                                    | (Immutable) FK → Company document ID.                                                            |
+| + [siteId](#siteId )               | No      | string         | No         | -                                    | (Immutable) FK → Site document ID (D40 sub-tenant scope).                                        |
+| + [contact](#contact )             | No      | string         | No         | -                                    | Email or E.164 phone number. Canonical identifier for this user within the site.                 |
+| + [tier](#tier )                   | No      | string         | No         | -                                    | Access tier. Free string per site (ING-304 open question — tier values are site-specific today). |
+| + [amount](#amount )               | No      | number         | No         | -                                    | Amount paid. Generalized from amount_xof per D40 decision.                                       |
+| + [currency](#currency )           | No      | string         | No         | -                                    | Currency code (ISO 4217). Defaults to XOF for legacy SR-Single parity.                           |
+| + [transactionId](#transactionId ) | No      | string         | No         | -                                    | Payment provider transaction ID (e.g. Wave).                                                     |
+| + [paidAt](#paidAt )               | No      | object         | No         | In #/definitions/firestore-timestamp | RFC3339Nano UTC when payment was completed.                                                      |
+
+## <a name="id"></a>1. Property `id`
+
+|              |                  |
+| ------------ | ---------------- |
+| **Type**     | `string or null` |
+| **Required** | No               |
+
+**Description:** (Read-only) Firestore document ID = contact identifier (email or E.164 phone), URL-escaped.
+
+:::warning Server-set
+Do not include in write requests. This field is set exclusively by the server (Firestore trigger or Admin SDK). Clients that send it will have the value silently ignored or may receive a validation error.
+:::
+
+## <a name="companyId"></a>2. Property `companyId`
+
+|              |          |
+| ------------ | -------- |
+| **Type**     | `string` |
+| **Required** | Yes      |
+
+**Description:** (Immutable) FK → Company document ID.
+
+:::info Immutable
+Set at creation only. This field cannot be modified after the document is created. Include it in CREATE payloads; omit it (or leave unchanged) in UPDATE payloads.
+:::
+
+## <a name="siteId"></a>3. Property `siteId`
+
+|              |          |
+| ------------ | -------- |
+| **Type**     | `string` |
+| **Required** | Yes      |
+
+**Description:** (Immutable) FK → Site document ID (D40 sub-tenant scope).
+
+:::info Immutable
+Set at creation only. This field cannot be modified after the document is created. Include it in CREATE payloads; omit it (or leave unchanged) in UPDATE payloads.
+:::
+
+## <a name="contact"></a>4. Property `contact`
+
+|              |          |
+| ------------ | -------- |
+| **Type**     | `string` |
+| **Required** | Yes      |
+
+**Description:** Email or E.164 phone number. Canonical identifier for this user within the site.
+
+## <a name="tier"></a>5. Property `tier`
+
+|              |          |
+| ------------ | -------- |
+| **Type**     | `string` |
+| **Required** | Yes      |
+
+**Description:** Access tier. Free string per site (ING-304 open question — tier values are site-specific today).
+
+## <a name="amount"></a>6. Property `amount`
+
+|              |          |
+| ------------ | -------- |
+| **Type**     | `number` |
+| **Required** | Yes      |
+
+**Description:** Amount paid. Generalized from amount_xof per D40 decision.
+
+## <a name="currency"></a>7. Property `currency`
+
+|              |          |
+| ------------ | -------- |
+| **Type**     | `string` |
+| **Required** | Yes      |
+| **Default**  | `"XOF"`  |
+
+**Description:** Currency code (ISO 4217). Defaults to XOF for legacy SR-Single parity.
+
+## <a name="transactionId"></a>8. Property `transactionId`
+
+|              |          |
+| ------------ | -------- |
+| **Type**     | `string` |
+| **Required** | Yes      |
+
+**Description:** Payment provider transaction ID (e.g. Wave).
+
+## <a name="paidAt"></a>9. Property `paidAt`
+
+|                           |                                   |
+| ------------------------- | --------------------------------- |
+| **Type**                  | `object`                          |
+| **Required**              | Yes                               |
+| **Additional properties** | Not allowed                       |
+| **Defined in**            | #/definitions/firestore-timestamp |
+
+**Description:** RFC3339Nano UTC when payment was completed.
+
+| Property                                | Pattern | Type    | Deprecated | Definition | Title/Description |
+| --------------------------------------- | ------- | ------- | ---------- | ---------- | ----------------- |
+| + [_seconds](#paidAt__seconds )         | No      | integer | No         | -          | -                 |
+| + [_nanoseconds](#paidAt__nanoseconds ) | No      | integer | No         | -          | -                 |
+
+### <a name="paidAt__seconds"></a>9.1. Property `_seconds`
+
+|              |           |
+| ------------ | --------- |
+| **Type**     | `integer` |
+| **Required** | Yes       |
+
+| Restrictions |                        |
+| ------------ | ---------------------- |
+| **Minimum**  | &ge; -9007199254740991 |
+| **Maximum**  | &le; 9007199254740991  |
+
+### <a name="paidAt__nanoseconds"></a>9.2. Property `_nanoseconds`
+
+|              |           |
+| ------------ | --------- |
+| **Type**     | `integer` |
+| **Required** | Yes       |
+
+| Restrictions |                        |
+| ------------ | ---------------------- |
+| **Minimum**  | &ge; -9007199254740991 |
+| **Maximum**  | &le; 9007199254740991  |
+
+----------------------------------------------------------------------------------------------------------------------------
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-04-18 at 21:21:09 +0000