Create Card Definition

Card code generation configuration. When pattern is provided, the effective code length is the number of # placeholders in the pattern; otherwise length (default 10) # placeholders are used.

Points expiration policy. Conditional requirements based on type:

• NO_EXPIRATION: rolling_expiration, calendar_expiration and sliding_expiration must be null/absent.
• ROLLING_EXPIRATION: rolling_expiration is required; the other two must be null/absent.
• CALENDAR_EXPIRATION: calendar_expiration is required; the other two must be null/absent.
• SLIDING_EXPIRATION: sliding_expiration is required; the other two must be null/absent.

Pending points activation policy. Conditional requirements based on type:

• IMMEDIATE: period_based, fixed_dates and event_based must be null/absent.
• PERIOD_BASED: period_based is required; the other two must be null/absent.
• FIXED_DATES: fixed_dates is required; the other two must be null/absent.
• EVENT_BASED: event_based is required; the other two must be null/absent.

Points earning limits.

Points spending limits.

Refund handling configuration.

Card balance settings. allow_negative can only be true when points_expiration.type is NO_EXPIRATION.

Card code generation configuration. Always present with server-side defaults applied.

Points expiration policy. Always present; defaults to NO_EXPIRATION.

Pending points activation policy. Always present; defaults to IMMEDIATE.

Points earning limits. Always present; defaults to NO_LIMIT for both scopes.

Points spending limits. Always present; defaults to NO_LIMIT for both scopes.

Refund handling configuration. Always present; defaults to NONE for both scopes.

Card balance settings. Always present; defaults to allow_negative: false.

Pay-with-points configuration. Always present; defaults to NO_PAYMENTS.