---
schema_version: "1"
id: fc0db106cf55642e2b7f191ad2d76aaa39ff74dbcbae717314cf5cf810866e1c
title: Integrate Clutch Gift Cards
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/commerce/264-0-0/rt_adv_config_3p_int_gift_card_clutch.md
canonical_url: https://help.salesforce.com/s/articleView?id=commerce.rt_adv_config_3p_int_gift_card_clutch.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 1868283cb98381672b8770f0c2fb7002fbaa328a6f22fec6fc07e4b177ffe4a0
description: The Point of Sale (POS) app supports gift card integration with Clutch. Learn how to configure a Clutch account with the supported functionality.
products:
  - Commerce
release: "264"
---
# Integrate Clutch Gift Cards

The Point of Sale (POS) app supports gift card integration with Clutch. Learn how to configure a Clutch account with the supported functionality.

- Modern POS App build: 6.6.2 or above
- Platform Support: iPhone & iPad
- Offline Support: No
- Clutch Account Setting: To support issuing refunds using a Gift Card during a return, Clutch needs to set up a maximum refund amount on the merchant's Clutch account.

This functionality is supported in the POS App:

- Purchase of a gift card
- Show the balance of a gift card
- Add balance to an existing gift card (available in staging but not in production)
- Refund to the gift card (gift card as a return tender)

This functionality is not supported in the POS App:

- Void a gift card transaction
- Virtual gift card

Tip: Refer to [Gift Card Support in POS](https://help.salesforce.com/s/articleView?id=commerce.rt_pos_checkout_gift_card.htm&release=264.0.0&type=5 "Gift card support in the POS app enables store associates to handle gift card payments, purchases, and returns, streamlining the checkout process. Associates can easily apply gift card tenders, add value to cards, and redeem them for merchandise. With gift card returns, associates can issue refunds to new gift cards, offering customers a convenient option.") for more information on gift cards.

## Configure Clutch Integration

1. In CMS, go to **Integrations** | **Gift Cards**.
2. Click **Create** to create a configuration for Clutch.
3. Configure the fields. Note, an asterisk(\*) denotes a required field.
    
    <table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small ">
              <colgroup>
                <col style="width:50%">
                <col style="width:50%">
              </colgroup>
              <tbody>
                <tr class="">
                  <td class="slds-cell-wrap" style="vertical-align:top;">Field</td>

                  <td class="slds-cell-wrap" style="vertical-align:top;">Description</td>

                </tr>
                <tr class="">
                  <td class="slds-cell-wrap" colspan="2" style="vertical-align:top;">General</td>

                </tr>
                <tr class="">
                  <td class="slds-cell-wrap" style="vertical-align:top;">Gift Card Service*</td>

                  <td class="slds-cell-wrap" style="vertical-align:top;">Select "Clutch"</td>

                </tr>
                <tr class="">
                  <td class="slds-cell-wrap" style="vertical-align:top;">Store ID*</td>

                  <td class="slds-cell-wrap" style="vertical-align:top;">Select "Default" to apply this configuration to all stores, or choose a specific
                    store to apply it to</td>

                </tr>
                <tr class="">
                  <td class="slds-cell-wrap" style="vertical-align:top;">Card Type*</td>

                  <td class="slds-cell-wrap" style="vertical-align:top;">Select either "Gift Card" or "Reward Card" </td>

                </tr>
                <tr class="">
                  <td class="slds-cell-wrap" style="vertical-align:top;">Currency*</td>

                  <td class="slds-cell-wrap" style="vertical-align:top;">Select a currency code in ISO 4217 (e.g., USD)</td>

                </tr>
                <tr class="">
                  <td class="slds-cell-wrap" colspan="2" style="vertical-align:top;">Store Configuration</td>

                </tr>
                <tr class="">
                  <td class="slds-cell-wrap" style="vertical-align:top;">Location ID*</td>

                  <td class="slds-cell-wrap" style="vertical-align:top;">Enter Clutch's location ID</td>

                </tr>
                <tr class="">
                  <td class="slds-cell-wrap" style="vertical-align:top;">Terminal ID*</td>

                  <td class="slds-cell-wrap" style="vertical-align:top;">Enter Clutch's terminal ID</td>

                </tr>
                <tr class="">
                  <td class="slds-cell-wrap" colspan="2" style="vertical-align:top;">Routing</td>

                </tr>
                <tr class="">
                  <td class="slds-cell-wrap" style="vertical-align:top;">Routing ID* </td>

                  <td class="slds-cell-wrap" style="vertical-align:top;">Enter Clutch's brand ID</td>

                </tr>
                <tr class="">
                  <td class="slds-cell-wrap" colspan="2" style="vertical-align:top;">Credentials</td>

                </tr>
                <tr class="">
                  <td class="slds-cell-wrap" style="vertical-align:top;">Username* </td>

                  <td class="slds-cell-wrap" style="vertical-align:top;">Enter Clutch's API key</td>

                </tr>
                <tr class="">
                  <td class="slds-cell-wrap" style="vertical-align:top;">Password* </td>

                  <td class="slds-cell-wrap" style="vertical-align:top;">Enter Clutch's API secret key</td>

                </tr>
                <tr class="">
                  <td class="slds-cell-wrap" style="vertical-align:top;">Token Endpoint* </td>

                  <td class="slds-cell-wrap" style="vertical-align:top;">Enter Clutch's base URL (e.g., https://api-stage.clutch.com/merchant/ or
                    https://api.clutch.com/merchant/) </td>

                </tr>
                <tr class="">
                  <td class="slds-cell-wrap" colspan="2" style="vertical-align:top;">Advanced</td>

                </tr>
                <tr class="">
                  <td class="slds-cell-wrap" style="vertical-align:top;">Name Space</td>

                  <td class="slds-cell-wrap" style="vertical-align:top;">Enter Clutch's name space (e.g., https://api-stage.clutch.com/merchant/)</td>

                </tr>
                <tr class="">
                  <td class="slds-cell-wrap" style="vertical-align:top;">Cash Out Configuration</td>

                  <td class="slds-cell-wrap" style="vertical-align:top;">Configure the threshold when redeeming cash with a gift card, refer to this <a href="https://help.salesforce.com/s/articleView?id=commerce.rt_pos_checkout_gift_card.htm&amp;release=264.0.0&amp;type=5" title="Gift card support in the POS app enables store associates to handle gift card payments, purchases, and returns, streamlining the checkout process. Associates can easily apply gift card tenders, add value to cards, and redeem them for merchandise. With gift card returns, associates can issue refunds to new gift cards, offering customers a convenient option."><u>Gift Card Support in
                        POS</u></a> for more information</td>

                </tr>
                <tr class="">
                  <td class="slds-cell-wrap" style="vertical-align:top;">Allow Gift Card Purchase</td>

                  <td class="slds-cell-wrap" style="vertical-align:top;">Enabling this flag allows gift cards to be purchased</td>

                </tr>
                <tr class="">
                  <td class="slds-cell-wrap" style="vertical-align:top;">Require Activation</td>

                  <td class="slds-cell-wrap" style="vertical-align:top;">Enabling this flag requires the gift card to be activated when purchsed</td>

                </tr>
              </tbody>
            </table>

![Important](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-commerce-retail-264-0-0-production-enus/17d647fb-8988-49fb-9add-c4f4cc79c9e4/images/icon_important.png)

Important Switching Gift Card services will clear all fields except for Store ID and Card Type.

## Enable App Config Settings

To set up a gift card as tender in the checkout flow, refer to [Gift Card Support in POS](https://help.salesforce.com/s/articleView?id=commerce.rt_pos_checkout_gift_card.htm&release=264.0.0&type=5 "Gift card support in the POS app enables store associates to handle gift card payments, purchases, and returns, streamlining the checkout process. Associates can easily apply gift card tenders, add value to cards, and redeem them for merchandise. With gift card returns, associates can issue refunds to new gift cards, offering customers a convenient option.") in [Gift Card Support in POS](https://help.salesforce.com/s/articleView?id=commerce.rt_pos_checkout_gift_card.htm&release=264.0.0&type=5 "Gift card support in the POS app enables store associates to handle gift card payments, purchases, and returns, streamlining the checkout process. Associates can easily apply gift card tenders, add value to cards, and redeem them for merchandise. With gift card returns, associates can issue refunds to new gift cards, offering customers a convenient option.").

## Mandating Gift Card Pin

You can configure whether a PIN is required for checking a gift card balance or redeeming it. Point of Sale offers three options: Optional, Required, or None. For the Clutch connector, the PIN is optional and passed as a parameter to Clutch. Merchants wishing to disable this feature entirely should contact Clutch support for assistance.

Important: The pin settings location depends on the app build version. For app builds 10.6.1 or higher, set the pin under **Integrations** | **Gift Cards**. For app builds 10.5.1 or lower, set it under **App Configs** | **Modules** | **Cart**.

### App Builds 10.6.1 or Greater

1. In CMS, go to **Integrations** | **Gift Cards**.
2. Edit a Clutch integration.
3. Under **Advanced** | **Pin Settings,** select one of the following options:
    1. Optional: PIN is not mandatory but can be used if available
    2. Required: PIN must be entered to check the balance or redeem the gift card
    3. None: PIN is required, and the system will process gift cards without PIN validation
        
        ![A form displays advanced settings.](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-commerce-retail-264-0-0-production-enus/17d647fb-8988-49fb-9add-c4f4cc79c9e4/retail/images/rt_adv_config_3p_int_gift_card_clutch_pin_10_6.png)
4. Save your changes.

### App Builds 10.5.1 or Lower

Note: For app builds 10.5.1 or lower, ensure only one pin setting (Optional, Required, or None) is configured in both locations: App Configs and Integrations > Gift Cards, as Retail Cloud's Backend validates the pin setting only under Integrations > Gift Cards.

1. In CMS, go to App Configs.
2. Edit an app config and go to **Modules** | **Cart.**
3. Under Gift Pin Settings, select one of these options:
    1. Optional: PIN isn't mandatory but can be used if available
    2. Required: PIN must be entered to check the balance or redeem the gift card
    3. None: PIN is required, and the system will process gift cards without PIN validation
        
        ![A screenshot displays cart settings for an application.](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-commerce-retail-264-0-0-production-enus/17d647fb-8988-49fb-9add-c4f4cc79c9e4/retail/images/rt_adv_config_3p_int_gift_card_clutch_pin_10_5.png)
4. Save your changes.

## Create a Gift Card Product

For gift card purchases in the POS, the gift card SKU/product needs to be entered into the POS system using.

- Product Feed: Add a gift card SKU to the product feed. Make sure to add its productClass with a value of GiftCard. Refer to [Product Feed](https://help.salesforce.com/s/articleView?id=commerce.rt_adv_config_data_feeds_specs_product.htm&release=264.0.0&type=5 "Create a robust user experience in the POS app by viewing product details such as search results and filters.") for more information.
- Create gift card in CMS: Refer to Create a Gift Card Product in [Configure Gift Card Payments in Payment Terminal](https://help.salesforce.com/s/articleView?id=commerce.rt_cms_hardware_config_gift_cards_terminal.htm&release=264.0.0&type=5 "Configure Point of Sale's Point of Sale (POS) to accept gift card payments, add value, cash out, and check balances, using a payment terminal. Merchants can select the integration approach that suits their needs, verifying all transactions are available through gateway reporting.").

## Enable POS Settings for Returns

Starting with app build 6.6.2, Point of Sale's POS app supports refunds to gift cards. To set up the gift card as a return tender, refer to Configure Returns to Gift Card via Tender Mapping in [Gift Card Support in POS](https://help.salesforce.com/s/articleView?id=commerce.rt_pos_checkout_gift_card.htm&release=264.0.0&type=5 "Gift card support in the POS app enables store associates to handle gift card payments, purchases, and returns, streamlining the checkout process. Associates can easily apply gift card tenders, add value to cards, and redeem them for merchandise. With gift card returns, associates can issue refunds to new gift cards, offering customers a convenient option.").

## Configure Deep Link on Layout

Gift card purchases are supported in the POS app and are available on the cart screen if configured correctly. To learn more about this configuration, refer to Configure Gift Card Deep Links in [Gift Card Support in POS](https://help.salesforce.com/s/articleView?id=commerce.rt_pos_checkout_gift_card.htm&release=264.0.0&type=5 "Gift card support in the POS app enables store associates to handle gift card payments, purchases, and returns, streamlining the checkout process. Associates can easily apply gift card tenders, add value to cards, and redeem them for merchandise. With gift card returns, associates can issue refunds to new gift cards, offering customers a convenient option.").

## Known Issues and Restrictions

- A refund to a gift card is supported only using brand new non-activated gift cards.
- When a Corporate Gift Card is used to make a purchase and there is a request to return the purchase and refund the same card, the workflow is different than adding balance to an existing gift card. On the return flow, the refund needs to be issued on the original authorization token.