# GIFT\_CARD\_CONFIG

**Type**: `object` **Default**:

```json
{
  "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`.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://apidocs.akinon.com/commerce-openapis/checkout/dynamic-settings/gift_card_config.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.