---
title: "Update Card Definition"
method: PUT
path: "/v2/loyalties/card-definitions/{cardDefinitionId}"
tags: ["Card Definitions"]
---

# Update Card Definition

`PUT /v2/loyalties/card-definitions/{cardDefinitionId}`

<Info>

<Badge color="gray">Documentation in progress</Badge>

This documentation is in progress. The parameters, fields, request and response bodies, and other data may be subject to change. If you need more information or you want to share feedback, contact [Voucherify support](https://www.voucherify.io/contact-support) or your Technical Account Manager.

</Info>

Updates a card definition. All properties are optional; only provided sections
are updated. `type` and `status` cannot be changed through this endpoint
(status transitions are performed via the activate/draft endpoints).

When the card definition is in use (e.g. assigned to a program with existing cards),
updates to restricted sections may be rejected with a resource-locked error;
only `name`, `metadata` and `pay_with_points` are always updatable.

## Path parameters

- `id` string, required

## Request body

- CardDefinitionUpdateRequest — Request body for updating a card definition. All properties are optional. `type` and `status` cannot be updated.
  - `name` string, nullable — Card definition name.
  - `code_config` CardDefinitionCodeConfigInput — 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.
    - `length` integer, nullable — Number of generated characters in the code (ignored when `pattern` is provided). A positive integer. Defaults to 10.
    - `charset` string, nullable — Characters used for code generation. Defaults to alphanumeric: `0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ`.
    - `prefix` string, nullable — Fixed prefix prepended to every generated code. Defaults to an empty string.
    - `postfix` string, nullable — Fixed postfix appended to every generated code. Defaults to an empty string.
    - `pattern` string, nullable — Code pattern where each `#` is replaced with a random character from the charset, e.g. `###-###`. Defaults to `#` repeated `length` times.
  - `points_expiration` CardDefinitionPointsExpirationInput — 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.
    - `type` 'NO_EXPIRATION' | 'ROLLING_EXPIRATION' | 'CALENDAR_EXPIRATION' | 'SLIDING_EXPIRATION', required — Points expiration type.
    - `rolling_expiration` CardDefinitionPointsExpirationRollingExpirationInput — Rolling expiration configuration - points expire after a fixed period from earning.
      - `period` CardDefinitionPointsExpirationRollingExpirationPeriodInput, required — Rolling expiration period. The maximum `value` depends on `unit`: 1-90 for `DAY`, 1-12 for `MONTH`, 1-5 for `YEAR` (enforced via if/then conditions).
        - `unit` 'DAY' | 'MONTH' | 'YEAR', required — Period unit.
        - `value` integer, required — Period length. Maximum: 90 for `DAY`, 12 for `MONTH`, 5 for `YEAR`.
      - `rounding` CardDefinitionPointsExpirationRollingExpirationRoundingInput — Rounding of the rolling expiration date. When `type` is `END_OF_PARTICULAR_MONTH`, `value` (month number 1-12) is required; for all other types `value` must be null/absent.
        - `type` 'END_OF_MONTH' | 'END_OF_QUARTER' | 'END_OF_HALF_YEAR' | 'END_OF_YEAR' | 'END_OF_PARTICULAR_MONTH', required — Rounding type.
        - `value` integer, nullable — Month number (1-12). Required when `type` is `END_OF_PARTICULAR_MONTH`, must be null otherwise.
    - `calendar_expiration` CardDefinitionPointsExpirationCalendarExpirationInput — Calendar expiration configuration - points expire on fixed calendar dates.
      - `expiration_dates` CardDefinitionPointsExpirationCalendarExpirationDateInput[], required — List of calendar dates on which points expire (1-20 dates).
        - `day` integer, required — Day of the month. Maximum depends on the month: 29 for February, 30 for April, June, September, November, 31 otherwise.
        - `month` integer, required — Month number (1-12).
    - `sliding_expiration` CardDefinitionPointsExpirationSlidingExpirationInput — Sliding expiration configuration - points expiration slides on member activity. At least one of `earning_activity`, `spending_activity` or `custom_activity` must be `true`. When `custom_activity` is `true`, `custom_activity_types` is required with 1-10 unique custom event schema IDs.
      - `earning_activity` boolean — Whether earning points resets the expiration window.
      - `spending_activity` boolean — Whether spending points resets the expiration window.
      - `custom_activity` boolean — Whether the configured custom events reset the expiration window.
      - `custom_activity_types` string[], nullable — Custom event schema IDs (pattern `^ms_[a-zA-Z0-9]+`) that reset the expiration window. Required with 1-10 unique items when `custom_activity` is `true`.
      - `period` CardDefinitionPointsExpirationSlidingExpirationPeriodInput, required — Sliding expiration period. The maximum `value` depends on `unit`: 1-90 for `DAY`, 1-12 for `MONTH`, 1-1 for `YEAR` (enforced via if/then conditions).
        - `value` integer, required — Period length. Maximum: 90 for `DAY`, 12 for `MONTH`, 1 for `YEAR`.
        - `unit` 'DAY' | 'MONTH' | 'YEAR', required — Period unit.
  - `pending_points` CardDefinitionPendingPointsInput — 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.
    - `type` 'IMMEDIATE' | 'PERIOD_BASED' | 'FIXED_DATES' | 'EVENT_BASED', required — Pending points activation type. `IMMEDIATE` means no pending period.
    - `period_based` CardDefinitionPendingPointsPeriodBasedInput — Period-based pending points activation - points activate after a fixed period.
      - `period` CardDefinitionPendingPointsPeriodBasedPeriodInput, required — Pending period. The maximum `value` depends on `unit`: 1-90 for `DAY`, 1-12 for `MONTH`, 1-1 for `YEAR` (enforced via if/then conditions).
        - `unit` 'DAY' | 'MONTH' | 'YEAR', required — Period unit.
        - `value` integer, required — Period length. Maximum: 90 for `DAY`, 12 for `MONTH`, 1 for `YEAR`.
    - `fixed_dates` CardDefinitionPendingPointsFixedDatesInput — Fixed-dates pending points activation - points activate on fixed calendar dates.
      - `dates` CardDefinitionPendingPointsFixedDatesDateInput[], required — List of calendar dates on which pending points activate (1-20 dates).
        - `day` integer, required — Day of the month. Maximum depends on the month: 29 for February, 30 for April, June, September, November, 31 otherwise.
        - `month` integer, required — Month number (1-12).
    - `event_based` CardDefinitionPendingPointsEventBasedInput — Event-based pending points activation - points activate when one of the configured custom events occurs, or are cancelled after the cancel period.
      - `event_types` string[], required — Custom event schema IDs (pattern `^ms_[a-zA-Z0-9]+`) that activate pending points. 1-10 unique items.
      - `cancel_period` CardDefinitionPendingPointsEventBasedCancelPeriodInput, required — Period after which non-activated pending points are cancelled. The maximum `value` depends on `unit`: 1-90 for `DAY`, 1-12 for `MONTH`, 1-1 for `YEAR` (enforced via if/then conditions).
        - `value` integer, required — Period length. Maximum: 90 for `DAY`, 12 for `MONTH`, 1 for `YEAR`.
        - `unit` 'DAY' | 'MONTH' | 'YEAR', required — Period unit.
  - `earning_limits` CardDefinitionEarningLimitsInput — Points earning limits.
    - `global` CardDefinitionEarningLimitsGlobalInput, required — Global (per card) earning limits. When `type` is `NO_LIMIT`, `limits` must be empty or `null`; when `type` is `LIMITED`, `limits` must contain exactly 1 limit.
      - `type` 'NO_LIMIT' | 'LIMITED', required — Whether global earning limits apply.
      - `limits` CardDefinitionEarningLimitsGlobalLimitInput[], nullable — Limit definitions. Empty/null when `type` is `NO_LIMIT`; exactly 1 item required when `type` is `LIMITED`.
        - union — A global earning limit, discriminated by `type`: `BALANCE_BASED` (maximum card balance) or `TIME_BASED` (maximum points earned per period).
          - object — Balance-based limit - the card balance cannot exceed `max` points.
            - `type` 'BALANCE_BASED', required — Limit type.
            - `max` integer, required — Maximum card balance in points.
          - object — Time-based limit - at most `points.max` points can be earned per period.
            - `type` 'TIME_BASED', required — Limit type.
            - `period` CardDefinitionEarningLimitsGlobalTimeBasedPeriodInput, required — Time-based earning limit period. When `type` is `CURRENT_PERIOD` (the only allowed value), `current_period` is required.
              - …
            - `points` CardDefinitionEarningLimitsGlobalTimeBasedPointsInput, required — Points cap for the time-based earning limit.
              - …
    - `transactions` CardDefinitionEarningLimitsTransactionsInput, required — Per-transaction earning limits. When `type` is `NO_LIMIT`, `limits` must be empty or `null`; when `type` is `LIMITED`, `limits` must contain at least 1 limit. Each limit `type` may appear at most once in the array.
      - `type` 'NO_LIMIT' | 'LIMITED', required — Whether per-transaction earning limits apply.
      - `limits` CardDefinitionEarningLimitsTransactionsLimitInput[], nullable — Limit definitions with unique types. Empty/null when `type` is `NO_LIMIT`; at least 1 item required when `type` is `LIMITED`.
        - union — A per-transaction earning limit, discriminated by `type`: `POINTS` (maximum points earned per transaction) or `SPENDING` (minimum order amount required to earn points).
          - object — Points limit - at most `max` points can be earned in a single transaction.
            - `type` 'POINTS', required — Limit type.
            - `max` integer, required — Maximum points earned per transaction.
          - object — Spending threshold - points are only earned when the transaction amount is at least `min_amount`.
            - `type` 'SPENDING', required — Limit type.
            - `min_amount` integer, required — Minimum transaction amount required to earn points.
  - `spending_limits` CardDefinitionSpendingLimitsInput — Points spending limits.
    - `global` CardDefinitionSpendingLimitsGlobalInput, required — Global (per card) spending limits. When `type` is `NO_LIMIT`, `limits` must be empty or `null`; when `type` is `LIMITED`, `limits` must contain exactly 1 limit.
      - `type` 'NO_LIMIT' | 'LIMITED', required — Whether global spending limits apply.
      - `limits` CardDefinitionSpendingLimitsGlobalLimitInput[], nullable — Limit definitions. Empty/null when `type` is `NO_LIMIT`; exactly 1 item required when `type` is `LIMITED`.
        - union — A global spending limit, discriminated by `type`: `SPENDING_BASED` (total points spent) or `TIME_BASED` (points spent per period).
          - object — Spending-based limit - at most `max` points can be spent in total.
            - `type` 'SPENDING_BASED', required — Limit type.
            - `max` integer, required — Maximum total points spent.
          - object — Time-based limit - at most `points.max` points can be spent per period.
            - `type` 'TIME_BASED', required — Limit type.
            - `period` CardDefinitionSpendingLimitsGlobalTimeBasedPeriodInput, required — Time-based spending limit period. When `type` is `CURRENT_PERIOD` (the only allowed value), `current_period` is required.
              - …
            - `points` CardDefinitionSpendingLimitsGlobalTimeBasedPointsInput, required — Points cap for the time-based spending limit.
              - …
    - `transactions` CardDefinitionSpendingLimitsTransactionsInput, required — Per-transaction spending limits. When `type` is `NO_LIMIT`, `limits` must be empty or `null`; when `type` is `LIMITED`, `limits` must contain exactly 1 limit.
      - `type` 'NO_LIMIT' | 'LIMITED', required — Whether per-transaction spending limits apply.
      - `limits` CardDefinitionSpendingLimitsTransactionsLimitInput[], nullable — Limit definitions. Empty/null when `type` is `NO_LIMIT`; exactly 1 item required when `type` is `LIMITED`.
        - `type` 'POINTS', required — Limit type.
        - `max` integer, required — Maximum points spent per transaction.
  - `refunds` CardDefinitionRefundsInput — Refund handling configuration.
    - `spent_points` CardDefinitionRefundsSpentPointsInput, required — How points spent on a refunded order are handled. When `type` is `NONE`, `methods` must be empty or `null`; when `type` is `REFUNDABLE`, `methods` must contain exactly 1 method.
      - `type` 'NONE' | 'REFUNDABLE', required — Whether spent points are refundable.
      - `methods` CardDefinitionRefundsSpentPointsMethodInput[], nullable — Refund methods. Empty/null when `type` is `NONE`; exactly 1 item required when `type` is `REFUNDABLE`. Currently only one method is allowed.
        - `type` 'RETURN_POINTS', required — Refund method type.
        - `mode` 'REFUND_ALL' | 'REFUND_ITEM' | 'REFUND_AMOUNT', required — Refund mode: on full-order refund (`REFUND_ALL`), per-item refund (`REFUND_ITEM`) or amount-based refund (`REFUND_AMOUNT`).
    - `earned_points` CardDefinitionRefundsEarnedPointsInput, required — How points earned on a refunded order are handled. When `type` is `NONE`, `methods` must be empty or `null`; when `type` is `REFUNDABLE`, `methods` must contain exactly 1 method.
      - `type` 'NONE' | 'REFUNDABLE', required — Whether earned points are revocable on refund.
      - `methods` CardDefinitionRefundsEarnedPointsMethodInput[], nullable — Revoke methods. Empty/null when `type` is `NONE`; exactly 1 item required when `type` is `REFUNDABLE`.
        - union — An earned points revoke method, discriminated by `type`: `REVOKE_FROM_PENDING` (only valid when `pending_points.type` is `PERIOD_BASED`, `FIXED_DATES` or `EVENT_BASED`) or `REVOKE_FROM_BALANCE`.
          - object — Revoke earned points from pending points.
            - `type` 'REVOKE_FROM_PENDING', required — Revoke method type.
          - object — Revoke earned points from the card balance.
            - `type` 'REVOKE_FROM_BALANCE', required — Revoke method type.
            - `mode` 'REVOKE_TO_ZERO' | 'REVOKE_BELOW_ZERO', required — Revoke mode. `REVOKE_BELOW_ZERO` requires `balance_settings.allow_negative` to be `true`.
  - `balance_settings` CardDefinitionBalanceSettingsInput — Card balance settings. `allow_negative` can only be `true` when `points_expiration.type` is `NO_EXPIRATION`.
    - `allow_negative` boolean, required — Whether the card balance is allowed to go below zero.
  - `pay_with_points` union — Pay-with-points configuration, discriminated by `type`: `NO_PAYMENTS` (paying with points disabled) or `EXCHANGE_RATIO` (points can be exchanged for money using a formula).
    - object — Paying with points is disabled.
      - `type` 'NO_PAYMENTS', required — Pay-with-points type.
    - object — Points can be exchanged for money at the configured ratio.
      - `type` 'EXCHANGE_RATIO', required — Pay-with-points type.
      - `exchange_ratio` CardDefinitionPayWithPointsExchangeRatioInput, required — Exchange ratio used to convert points into money.
        - `formula` union, required — Exchange ratio formula. A string expression (1-2000 characters) or a number. Numbers are converted to strings server-side.
          - string
          - number
  - `metadata` object, nullable — Arbitrary key-value metadata attached to the card definition.

## Response `200`

The updated card definition.

- CardDefinition — A card definition.
  - `id` string, required — Unique card definition ID.
  - `name` string, required — Card definition name.
  - `type` 'INDIVIDUAL', required — Card definition type.
  - `status` 'DRAFT' | 'ACTIVE' | 'DELETED', required — Current card definition status.
  - `code_config` CardDefinitionCodeConfig, required — Card code generation configuration. Always present with server-side defaults applied.
    - `pattern` string, required — Code pattern where each `#` is replaced with a random character from the charset.
    - `length` integer, required — Number of `#` placeholders in the pattern.
    - `charset` string, required — Characters used for code generation.
    - `prefix` string, required — Fixed prefix prepended to every generated code. Empty string when not set.
    - `postfix` string, required — Fixed postfix appended to every generated code. Empty string when not set.
  - `points_expiration` CardDefinitionPointsExpiration, required — Points expiration policy. Always present; defaults to `NO_EXPIRATION`.
    - `type` 'NO_EXPIRATION' | 'ROLLING_EXPIRATION' | 'CALENDAR_EXPIRATION' | 'SLIDING_EXPIRATION', required — Points expiration type.
    - `rolling_expiration` CardDefinitionPointsExpirationRollingExpiration — Rolling expiration configuration.
      - `period` CardDefinitionPeriod, required — A period expressed as a value and unit.
        - `value` integer, required — Period length.
        - `unit` 'DAY' | 'MONTH' | 'YEAR', required — Period unit.
      - `rounding` CardDefinitionPointsExpirationRollingExpirationRounding — Rounding of the rolling expiration date.
        - `type` 'END_OF_MONTH' | 'END_OF_QUARTER' | 'END_OF_HALF_YEAR' | 'END_OF_YEAR' | 'END_OF_PARTICULAR_MONTH', required — Rounding type.
        - `value` integer — Month number (1-12). Only present when `type` is `END_OF_PARTICULAR_MONTH`.
    - `calendar_expiration` CardDefinitionPointsExpirationCalendarExpiration — Calendar expiration configuration.
      - `expiration_dates` CardDefinitionCalendarDate[], required — Calendar dates on which points expire.
        - `day` integer, required — Day of the month.
        - `month` integer, required — Month number (1-12).
    - `sliding_expiration` CardDefinitionPointsExpirationSlidingExpiration — Sliding expiration configuration.
      - `earning_activity` boolean — Whether earning points resets the expiration window.
      - `spending_activity` boolean — Whether spending points resets the expiration window.
      - `custom_activity` boolean — Whether the configured custom events reset the expiration window.
      - `custom_activity_types` string[], required — Custom event schema IDs that reset the expiration window. Empty array when `custom_activity` is false.
      - `period` CardDefinitionPeriod, required — A period expressed as a value and unit.
        - `value` integer, required — Period length.
        - `unit` 'DAY' | 'MONTH' | 'YEAR', required — Period unit.
  - `pending_points` CardDefinitionPendingPoints, required — Pending points activation policy. Always present; defaults to `IMMEDIATE`.
    - `type` 'IMMEDIATE' | 'PERIOD_BASED' | 'FIXED_DATES' | 'EVENT_BASED', required — Pending points activation type.
    - `period_based` CardDefinitionPendingPointsPeriodBased — Period-based pending points activation.
      - `period` CardDefinitionPeriod, required — A period expressed as a value and unit.
        - `value` integer, required — Period length.
        - `unit` 'DAY' | 'MONTH' | 'YEAR', required — Period unit.
    - `fixed_dates` CardDefinitionPendingPointsFixedDates — Fixed-dates pending points activation.
      - `dates` CardDefinitionCalendarDate[], required — Calendar dates on which pending points activate.
        - `day` integer, required — Day of the month.
        - `month` integer, required — Month number (1-12).
    - `event_based` CardDefinitionPendingPointsEventBased — Event-based pending points activation.
      - `event_types` string[], required — Custom event schema IDs that activate pending points.
      - `cancel_period` CardDefinitionPeriod, required — A period expressed as a value and unit.
        - `value` integer, required — Period length.
        - `unit` 'DAY' | 'MONTH' | 'YEAR', required — Period unit.
  - `earning_limits` CardDefinitionEarningLimits, required — Points earning limits. Always present; defaults to `NO_LIMIT` for both scopes.
    - `global` CardDefinitionEarningLimitsGlobal — Global (per card) earning limits.
      - `type` 'NO_LIMIT' | 'LIMITED', required — Whether global earning limits apply.
      - `limits` CardDefinitionEarningLimitsGlobalLimit[], required — Limit definitions. Empty array when `type` is `NO_LIMIT`.
        - union — A global earning limit: `BALANCE_BASED` or `TIME_BASED`.
          - object — Balance-based limit.
            - `type` 'BALANCE_BASED', required — Limit type.
            - `max` integer, required — Maximum card balance in points.
          - object — Time-based limit.
            - `type` 'TIME_BASED', required — Limit type.
            - `period` CardDefinitionLimitTimeBasedPeriod — Time-based limit period.
              - …
            - `points` CardDefinitionLimitTimeBasedPoints — Points cap for a time-based limit.
              - …
    - `transactions` CardDefinitionEarningLimitsTransactions — Per-transaction earning limits.
      - `type` 'NO_LIMIT' | 'LIMITED', required — Whether per-transaction earning limits apply.
      - `limits` CardDefinitionEarningLimitsTransactionsLimit[], required — Limit definitions. Empty array when `type` is `NO_LIMIT`.
        - union — A per-transaction earning limit: `POINTS` or `SPENDING`.
          - object — Points limit.
            - `type` 'POINTS', required — Limit type.
            - `max` integer, required — Maximum points earned per transaction.
          - object — Spending threshold.
            - `type` 'SPENDING', required — Limit type.
            - `min_amount` integer, required — Minimum transaction amount required to earn points.
  - `spending_limits` CardDefinitionSpendingLimits, required — Points spending limits. Always present; defaults to `NO_LIMIT` for both scopes.
    - `global` CardDefinitionSpendingLimitsGlobal — Global (per card) spending limits.
      - `type` 'NO_LIMIT' | 'LIMITED', required — Whether global spending limits apply.
      - `limits` CardDefinitionSpendingLimitsGlobalLimit[], required — Limit definitions. Empty array when `type` is `NO_LIMIT`.
        - union — A global spending limit: `SPENDING_BASED` or `TIME_BASED`.
          - object — Spending-based limit.
            - `type` 'SPENDING_BASED', required — Limit type.
            - `max` integer, required — Maximum total points spent.
          - object — Time-based limit.
            - `type` 'TIME_BASED', required — Limit type.
            - `period` CardDefinitionLimitTimeBasedPeriod — Time-based limit period.
              - …
            - `points` CardDefinitionLimitTimeBasedPoints — Points cap for a time-based limit.
              - …
    - `transactions` CardDefinitionSpendingLimitsTransactions — Per-transaction spending limits.
      - `type` 'NO_LIMIT' | 'LIMITED', required — Whether per-transaction spending limits apply.
      - `limits` CardDefinitionSpendingLimitsTransactionsLimit[], required — Limit definitions. Empty array when `type` is `NO_LIMIT`.
        - `type` 'POINTS', required — Limit type.
        - `max` integer, required — Maximum points spent per transaction.
  - `refunds` CardDefinitionRefunds, required — Refund handling configuration. Always present; defaults to `NONE` for both scopes.
    - `spent_points` CardDefinitionRefundsSpentPoints, required — How points spent on a refunded order are handled.
      - `type` 'NONE' | 'REFUNDABLE', required — Whether spent points are refundable.
      - `methods` CardDefinitionRefundsSpentPointsMethod[], required — Refund methods. Empty array when `type` is `NONE`.
        - `type` 'RETURN_POINTS', required — Refund method type.
        - `mode` 'REFUND_ALL' | 'REFUND_ITEM' | 'REFUND_AMOUNT', required — Refund mode.
    - `earned_points` CardDefinitionRefundsEarnedPoints, required — How points earned on a refunded order are handled.
      - `type` 'NONE' | 'REFUNDABLE', required — Whether earned points are revocable on refund.
      - `methods` CardDefinitionRefundsEarnedPointsMethod[], required — Revoke methods. Empty array when `type` is `NONE`.
        - union — An earned points revoke method: `REVOKE_FROM_PENDING` or `REVOKE_FROM_BALANCE`.
          - object — Revoke earned points from pending points.
            - `type` 'REVOKE_FROM_PENDING', required — Revoke method type.
          - object — Revoke earned points from the card balance.
            - `type` 'REVOKE_FROM_BALANCE', required — Revoke method type.
            - `mode` 'REVOKE_TO_ZERO' | 'REVOKE_BELOW_ZERO', required — Revoke mode.
  - `balance_settings` CardDefinitionBalanceSettings, required — Card balance settings. Always present; defaults to `allow_negative: false`.
    - `allow_negative` boolean, required — Whether the card balance is allowed to go below zero.
  - `pay_with_points` CardDefinitionPayWithPoints, required — Pay-with-points configuration. Always present; defaults to `NO_PAYMENTS`.
    - `type` 'NO_PAYMENTS' | 'EXCHANGE_RATIO', required — Pay-with-points type.
    - `exchange_ratio` object — Exchange ratio. Only present when `type` is `EXCHANGE_RATIO`.
      - `formula` string, required — Exchange ratio formula (always returned as a string).
  - `metadata` object, required — Arbitrary key-value metadata. Empty object when not set.
  - `created_at` string, date-time, required — Creation timestamp (ISO 8601).
  - `updated_at` string, date-time, nullable, required — Last update timestamp (ISO 8601). `null` when the card definition has never been updated.
  - `object` 'card_definition', required — Object type marker. Always `card_definition`.

## Other responses

- `400` — Validation error - the request body or query parameters are invalid.
- `404` — Resource not found
- `409` — Conflict - invalid state transition
- `500` — Internal server error

---

[API](https://skmtc.net/voucherifyio/apis/voucherify-loyalty-v2-api.md) · [All operations](https://skmtc.net/voucherifyio/apis/voucherify-loyalty-v2-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/voucherifyio/voucherify-loyalty-v2-api/revisions/69be73b5cff0/schema)