> ## Documentation Index
> Fetch the complete documentation index at: https://developers.redo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# hsaPaymentSettingsUpdate

> Change the store's HSA/FSA payment settings and return them. Fields you leave out keep their values. A new label is synced to the store's Shopify payment customization. An invalid value fails with INVALID_STOREFRONT_SETTING (400).

**Required scopes:** [`checkout_settings_write`](https://developers.redo.com/docs/api-reference/v3/reference/scopes#scope-checkout_settings_write)

**Store must have one of:** `HSA`

## Arguments

**input** `[HsaPaymentSettingsUpdateInput!](/docs/api-reference/v3/reference/payments/hsa-payment-settings-update-input)` *required*

The fields to change.

**fields**

**cartPlacements** `[\[StorefrontSelectorInput!\]](/docs/api-reference/v3/reference/checkout/storefront-selector-input)`

Replaces every cart placement of the eligibility widget; an empty list clears them. Left out or null keeps them. Selectors are only checked for shape (not empty, at most 500 characters, no control characters, at most 50 per placement). They aren't parsed or checked against the storefront's theme, so one that doesn't parse or matches nothing is accepted and shows nothing.

**fields**

**insertPosition** `[StorefrontInsertPosition!](/docs/api-reference/v3/reference/checkout/storefront-insert-position)` *required*

Where the widget goes relative to the selected element.

**selector** `String!` *required*

The CSS selector.

**paymentMethodName** `String`

The label shoppers see at checkout, trimmed, at most 100 characters and no control characters. Left out keeps it; null or blank clears it, which uses the default label.

**productPagePlacement** `[StorefrontSelectorInput](/docs/api-reference/v3/reference/checkout/storefront-selector-input)`

Where the eligibility widget goes on product pages. Left out keeps it; null clears it. Selectors are only checked for shape (not empty, at most 500 characters, no control characters, at most 50 per placement). They aren't parsed or checked against the storefront's theme, so one that doesn't parse or matches nothing is accepted and shows nothing.

**fields**

**insertPosition** `[StorefrontInsertPosition!](/docs/api-reference/v3/reference/checkout/storefront-insert-position)` *required*

Where the widget goes relative to the selected element.

**selector** `String!` *required*

The CSS selector.

**showOnlyHsaPaymentMethod** `Boolean`

Whether a checkout started from an HSA buy button shows only the HSA/FSA payment method. Left out or null keeps it.

## Returns

**hsaPaymentSettingsUpdate** `[HsaPaymentSettings!](/docs/api-reference/v3/reference/payments/hsa-payment-settings)` *required*

How the HSA/FSA payment method appears at checkout and where its eligibility widget goes on the storefront.

**fields**

**cartPlacements** `[\[StorefrontSelector!\]!](/docs/api-reference/v3/reference/checkout/storefront-selector)` *required*

Where the eligibility widget goes in the cart. Empty when none are set.

**fields**

**insertPosition** `[StorefrontInsertPosition!](/docs/api-reference/v3/reference/checkout/storefront-insert-position)` *required*

Where the widget goes relative to the selected element.

**selector** `String!` *required*

The CSS selector.

**paymentMethodName** `String`

The label shoppers see for the HSA/FSA payment method at checkout. Null uses the default label.

**productPagePlacement** `[StorefrontSelector](/docs/api-reference/v3/reference/checkout/storefront-selector)`

Where the eligibility widget goes on product pages. Null when none is set. A placement saved without an insert position reads as APPEND.

**fields**

**insertPosition** `[StorefrontInsertPosition!](/docs/api-reference/v3/reference/checkout/storefront-insert-position)` *required*

Where the widget goes relative to the selected element.

**selector** `String!` *required*

The CSS selector.

**showOnlyHsaPaymentMethod** `Boolean!` *required*

Whether a checkout started from an HSA buy button shows only the HSA/FSA payment method. True unless changed.

## Example

```graphql theme={null}
mutation {
  hsaPaymentSettingsUpdate(input: { ... }) {
    paymentMethodName
    showOnlyHsaPaymentMethod
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.