CustomerClientCards

Customer client cards represent loyalty cards, membership cards, or gift cards associated with customer clients.

Storage Location

{customer_id}-customer_client_card.json

Note: This file may not exist for all customers. Only present when the customer uses loyalty/gift card features.

Fields

Field	Type	Required	Description
id	string	Yes	Unique card identifier.
guid	guid	Yes	Card GUID.
customer_id	integer	Yes	Reference to Customer.
customer_client_guid	guid	No	Reference to CustomerClient owner (null for anonymous cards).
card_num	string	Yes	Card number.
type	string	Yes	Card type: deposit, membership, discount, prepaid.
name	string	No	v1.1. Card holder name.
created	datetime	Yes	Card creation date.
expiration	datetime	No	Card expiration date.
status	string	Yes	Status: active, inactive, deleted.
remarks	string	No	v1.1. Notes/remarks on the card.
card_type_name	string	No	v1.1. Name of the card type configuration.
card_definition_name	string	No	v1.1. Name of the card definition.

Card Types

Type	Description
deposit	Prepaid deposit/gift card with monetary balance
membership	Membership/subscription card
discount	Discount card
prepaid	Prepaid card

Example

{
  "id": "200130066",
  "guid": "484aa1c9-9840-2a33-e063-0a01000a5f65",
  "customer_id": 200013285,
  "card_num": "04049E62033E81",
  "type": "deposit",
  "created": "2025-04-24T00:00:00",
  "expiration": "2026-05-24T00:00:00",
  "status": "active",
  "remarks": "Imported from legacy system"
}

Related Entities

• Customers - Parent customer/tenant
• CustomerClients - Card owner (optional)
• Payments - Payments can reference customer card