> For the complete documentation index, see [llms.txt](https://apidocs.akinon.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://apidocs.akinon.com/commerce-openapis/checkout/gift-cards-gift-boxes-and-loyalty.md).

# Gift Cards, Gift Boxes & Loyalty

## Checkout Gift Cards, Gift Boxes & Loyalty

Apply supplementary payment methods and gifting options that adjust the order total or add items to the order.

**Gift Cards** let customers apply a pre-loaded card balance to their order. The flow supports OTP verification, multi-card application (when configured), amount adjustment, and removal.

**Gift Boxes** let customers add gift packaging to their order.

**Loyalty Points** let customers redeem accumulated points as a payment contribution.

**Rewards** present available reward options that the customer can apply to the order.

### Authentication

These endpoints support both authenticated and anonymous sessions.

* **Authenticated users**: Session cookie (`sessionid`) tracks checkout progress.
* **Anonymous users**: Guest checkout is available when the `CAN_GUEST_PURCHASE` setting is enabled.

### Request Format

Include the following header in all checkout requests:

* **x-requested-with**: `XMLHttpRequest`

### Dynamic Settings

#### GIFT\_CARD\_CONFIG

Configuration for the gift card feature:

* `multi_card_enabled` — allows more than one gift card per order when enabled.
* `max_amount_per_order` — maximum cumulative gift card amount per order (zero means no cap).
* `balance_cache_ttl` — duration in seconds that a fetched card balance is cached.
* `otp_resend_cooldown` — minimum interval in seconds between OTP resend requests.
* `void_task_countdown` — delay in seconds before unused reservations are voided.

#### LOYALTY\_MONEY\_ENABLED

Master switch for the loyalty money payment feature. When disabled, the loyalty money step is not shown.

#### MINIMUM\_ORDER\_AMOUNT

Minimum order total required after loyalty points are applied. Redemption is capped so the remaining amount does not fall below this threshold.

#### CUSTOMER\_LOYALTY\_CARD\_SERVICE

Configures the service used to retrieve loyalty point balances and the optional minimum basket amount required before redemption is available.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://apidocs.akinon.com/commerce-openapis/checkout/gift-cards-gift-boxes-and-loyalty.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.