> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

## Resource: Sample Flows

## Article: Sample Flows

## Article Link: https://dev.wix.com/docs/api-reference/business-solutions/gift-cards/transactions/sample-flows.md

## Article Content:

# Gift Card Transactions: Sample Flows

This article presents possible use cases and corresponding sample flows that you can support. This can be a helpful jumping off point as you plan your implementation.

## Query a gift card's complete transaction history

Retrieve the full history of balance changes for a specified gift card when managing gift cards for customer service or reporting. This flow retrieves all transactions ordered by creation date.

To query a gift card's complete transaction history, follow these steps:

1. Call [Query Gift Cards](https://dev.wix.com/docs/api-reference/business-solutions/gift-cards/gift-cards/query-gift-cards.md) to retrieve gift cards and their IDs.

2. Call [Query Gift Card Transactions](https://dev.wix.com/docs/api-reference/business-solutions/gift-cards/transactions/query-gift-card-transactions.md) with the gift card ID:

3. Process the `transactions` array in the response. Each transaction includes the `amount`, `type`, and `updatedBalance` after the transaction is applied.

## Filter transactions by type for reports

Analyze specified transaction types when generating reports. For example, filter to show only `REDEEM` transactions to understand gift card usage patterns.

To filter transactions by type, follow these steps:

1. Call Query Gift Card Transactions with a filter for the desired transaction type:

    ```json
    {
      "giftCardId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "query": {
        "filter": {
          "type": "REDEEM"
        }
      }
    }
    ```
2. Process the transactions in the response, which now contain only redemption records.
3. To analyze refunds instead, change the filter value to `"PAYMENT_METHOD_REFUND"`.