CustomerClientCards
Customer loyalty/membership card data.
Fields
| Field | Type | Required | Version | Description |
|---|---|---|---|---|
id |
integer | Yes | 1.0 | Unique card identifier |
customerClientId |
guid | Yes | 1.0 | Reference to CustomerClient |
customerId |
integer | Yes | 1.0 | Reference to Customer |
cardNumber |
string | No | 1.0 | Card number |
cardType |
string | No | 1.0 | Card type (loyalty, membership, etc.) |
balance |
float | No | 1.0 | Card balance (for prepaid/gift cards) |
points |
integer | No | 1.0 | Loyalty points |
validFrom |
date | No | 1.0 | Card valid from date |
validTo |
date | No | 1.0 | Card expiration date |
active |
boolean | No | 1.0 | Card active status |
created_at |
date | No | 1.0 | Creation timestamp |
Example - Loyalty Card
{
"id": 50001,
"customerClientId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"customerId": 12345,
"cardNumber": "LOYAL-2024-00001",
"cardType": "loyalty",
"balance": 0.0,
"points": 1250,
"validFrom": "2024-01-01T00:00:00Z",
"validTo": "2025-12-31T23:59:59Z",
"active": true,
"created_at": "2024-01-01T10:00:00Z"
}
Example - Gift Card
{
"id": 50002,
"customerClientId": null,
"customerId": 12345,
"cardNumber": "GIFT-2024-00123",
"cardType": "giftcard",
"balance": 500.00,
"points": 0,
"validFrom": "2024-06-15T00:00:00Z",
"validTo": "2026-06-15T23:59:59Z",
"active": true,
"created_at": "2024-06-15T14:30:00Z"
}
Example - Membership Card
{
"id": 50003,
"customerClientId": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
"customerId": 12345,
"cardNumber": "MEMBER-2024-00456",
"cardType": "membership",
"balance": 0.0,
"points": 0,
"validFrom": "2024-01-01T00:00:00Z",
"validTo": "2024-12-31T23:59:59Z",
"active": true,
"created_at": "2024-01-01T08:00:00Z"
}
Related Entities
- Customer - Parent customer/tenant
- CustomerClient - Card owner
- Payments - Payments can reference customer card