GIFT_CARD_CONFIG

Type: object Default:

{
  "multi_card_enabled": false,
  "max_amount_per_order": 0,
  "balance_cache_ttl": 1800,
  "otp_resend_cooldown": 60,
  "void_task_countdown": 1800
}

Description: Configuration for the gift card payment feature during checkout.

• multi_card_enabled: Boolean (default false). When true, the user may apply more than one gift card to a single order. When false, attempting to add a second card returns a validation error.

• max_amount_per_order: Decimal (default 0). Maximum cumulative gift card amount that may be applied across all reservations on a single order. 0 means no global cap is enforced beyond the remaining unpaid amount.

• balance_cache_ttl: Integer seconds (default 1800). How long a fetched gift card balance is kept in cache. The update-amount page uses this cache to avoid a gateway round-trip; if the cache has expired, the reservation is removed and the user is asked to re-add the card.

• otp_resend_cooldown: Integer seconds (default 60). Minimum interval between OTP resend requests. If a resend is attempted before this interval elapses, a cooldown error is returned with the remaining wait time in seconds (retry_after).

• void_task_countdown: Integer seconds (default 1800). Delay before the background task that voids unused reservations is triggered.

Used in: GiftCardPage, GiftCardApplyPage, GiftCardUpdateAmountPage, GiftCardOtpResendPage.