--- title: "Update configuration" method: PUT path: "/v1/configuration/{handle}" tags: ["configuration"] --- # Update configuration `PUT /v1/configuration/{handle}` ## Request - Base URL: `https://checkout-api.frisbii.com` - URL: `https://checkout-api.frisbii.com/v1/configuration/{handle}` - Auth: HTTP basic ## Path parameters - `handle` string, required ## Request body - UpdateConfiguration - `name` string: Descriptive name for configuration - `logo` string: Logo url. Must be hosted on a *.frisbii.com or *.reepay.com domain. - `locale` string: Locale to use if not provided when creating session. Defaults to account locale. - `styleConfig` StyleConfig: Optional style configuration - `backgroundColor` string - `windowBackgroundColor` string - `windowHeaderBackgroundColor` string - `paymentHeaderBackgroundColor` string - `footerBackgroundColor` string - `darkMode` boolean - `windowHeaderBoxShadowColor` string - `footerFont` FontConfig - `color` string - `family` string - `size` string - `weight` integer - `sizeMobile` string - `weightMobile` integer - `footerLogoColor` 'grey' | 'black' | 'blue' | 'white': Frisbii logo colour in the checkout footer. Defaults to grey. - `windowHeaderCancelButton` FontConfig - `color` string - `family` string - `size` string - `weight` integer - `sizeMobile` string - `weightMobile` integer - `defaultConfig` DefaultConfig - `font` FontConfig - `color` string - `family` string - `size` string - `weight` integer - `sizeMobile` string - `weightMobile` integer - `border` BorderTypeConfig - `standard` BorderConfig - `width` string - `color` string - `radius` string - `focused` BorderConfig - `width` string - `color` string - `radius` string - `valid` BorderConfig - `width` string - `color` string - `radius` string - `invalid` BorderConfig - `width` string - `color` string - `radius` string - `buttonConfig` ButtonConfig - `payButtonSpacing` SpacingConfig - `padding` PaddingConfig - `top` string - `bottom` string - `right` string - `left` string - `margin` MarginConfig - `top` string - `bottom` string - `right` string - `left` string - `continueButtonSpacing` SpacingConfig - `padding` PaddingConfig - `top` string - `bottom` string - `right` string - `left` string - `margin` MarginConfig - `top` string - `bottom` string - `right` string - `left` string - `payButtonBorder` BorderConfig - `width` string - `color` string - `radius` string - `continueButtonBorder` BorderConfig - `width` string - `color` string - `radius` string - `paymentMethodDivider` PaymentMethodDividerConfig - `color` string - `topColor` string - `bottomColor` string - `paymentMethodTitle` PaymentMethodTitleConfig - `standard` FontConfig - `color` string - `family` string - `size` string - `weight` integer - `sizeMobile` string - `weightMobile` integer - `selected` FontConfig - `color` string - `family` string - `size` string - `weight` integer - `sizeMobile` string - `weightMobile` integer - `coBrandedCardSelection` CoBrandedCardSelectionConfig - `font` FontConfig - `color` string - `family` string - `size` string - `weight` integer - `sizeMobile` string - `weightMobile` integer - `radioButtonGroup` RadioButtonGroupConfig - `font` FontConfig - `color` string - `family` string - `size` string - `weight` integer - `sizeMobile` string - `weightMobile` integer - `unchecked` RadioButtonConfig - `fontWeight` integer - `fontWeightMobile` integer - `indicatorSize` string - `indicatorSizeMobile` string - `indicatorColor` string - `checked` RadioButtonConfig - `fontWeight` integer - `fontWeightMobile` integer - `indicatorSize` string - `indicatorSizeMobile` string - `indicatorColor` string - `paymentDescription` FontConfig - `color` string - `family` string - `size` string - `weight` integer - `sizeMobile` string - `weightMobile` integer - `paymentAmount` FontConfig - `color` string - `family` string - `size` string - `weight` integer - `sizeMobile` string - `weightMobile` integer - `labels` FontConfig - `color` string - `family` string - `size` string - `weight` integer - `sizeMobile` string - `weightMobile` integer - `payButton` ButtonStateConfig - `enabled` ButtonAppearanceConfig - `font` FontConfig - `color` string - `family` string - `size` string - `weight` integer - `sizeMobile` string - `weightMobile` integer - `backgroundColor` string - `disabled` ButtonAppearanceConfig - `font` FontConfig - `color` string - `family` string - `size` string - `weight` integer - `sizeMobile` string - `weightMobile` integer - `backgroundColor` string - `continueButton` ButtonStateConfig - `enabled` ButtonAppearanceConfig - `font` FontConfig - `color` string - `family` string - `size` string - `weight` integer - `sizeMobile` string - `weightMobile` integer - `backgroundColor` string - `disabled` ButtonAppearanceConfig - `font` FontConfig - `color` string - `family` string - `size` string - `weight` integer - `sizeMobile` string - `weightMobile` integer - `backgroundColor` string - `orderLineName` FontConfig - `color` string - `family` string - `size` string - `weight` integer - `sizeMobile` string - `weightMobile` integer - `orderLineQuantity` FontConfig - `color` string - `family` string - `size` string - `weight` integer - `sizeMobile` string - `weightMobile` integer - `orderLineAmount` FontConfig - `color` string - `family` string - `size` string - `weight` integer - `sizeMobile` string - `weightMobile` integer - `inputs` InputConfig - `border` BorderTypeConfig - `standard` BorderConfig - `width` string - `color` string - `radius` string - `focused` BorderConfig - `width` string - `color` string - `radius` string - `valid` BorderConfig - `width` string - `color` string - `radius` string - `invalid` BorderConfig - `width` string - `color` string - `radius` string - `standardText` FontConfig - `color` string - `family` string - `size` string - `weight` integer - `sizeMobile` string - `weightMobile` integer - `placeholderText` FontConfig - `color` string - `family` string - `size` string - `weight` integer - `sizeMobile` string - `weightMobile` integer - `spacing` SpacingConfig - `padding` PaddingConfig - `top` string - `bottom` string - `right` string - `left` string - `margin` MarginConfig - `top` string - `bottom` string - `right` string - `left` string - `boxShadowColor` string - `companyName` FontConfig - `color` string - `family` string - `size` string - `weight` integer - `sizeMobile` string - `weightMobile` integer - `companyAddress` FontConfig - `color` string - `family` string - `size` string - `weight` integer - `sizeMobile` string - `weightMobile` integer - `title` FontConfig - `color` string - `family` string - `size` string - `weight` integer - `sizeMobile` string - `weightMobile` integer - `subTitle` FontConfig - `color` string - `family` string - `size` string - `weight` integer - `sizeMobile` string - `weightMobile` integer - `termsLine` FontConfig - `color` string - `family` string - `size` string - `weight` integer - `sizeMobile` string - `weightMobile` integer - `pricingItemTitle` FontConfig - `color` string - `family` string - `size` string - `weight` integer - `sizeMobile` string - `weightMobile` integer - `pricingItemRow` FontConfig - `color` string - `family` string - `size` string - `weight` integer - `sizeMobile` string - `weightMobile` integer - `site` string: Checkout site domain to use: `reepay` or `frisbii` - `payment_methods` string[]: Optional lists of payment methods to use for sessions with this configuration - `co_branded_card_selection` boolean: Option to control if the cardholder should be able to choose which part of a co-branded card to use. Defaults to false. - `co_branded_visa_dankort_preference` string: Default selected part of a co-branded Visa-Dankort if `co_branded_card_selection` enabled and cardholder makes no specific selection. - `amount_formatting` 'currency_code' | 'currency_symbol': How to format amount and currency: `currency_code` - with currency code, e.g. 100 USD (default), or `currency_symbol` - with symbol, e.g. $100 - `payment_type_priority` string[]: List of payment types giving the order in the checkout - `show_test_hints` boolean: For test accounts, use this setting to control if info boxes with hints on how to perform testing should be shown in Checkout. - `show_subscription_details_expanded` boolean: A property, which shows if subscription details should be expanded in Checkout. - `consent_configuration` ConsentConfiguration: Configuration for required consents - `consent_definitions` ConsentDefinitionDto[]: List of consent definitions for this configuration - `text` string, required: Text of the consent definition that should be rendered. The text supports templates for policies handles. - `policies` PolicyDefinitionDto[]: List of policy handles that are used in the text of the consent definition. - `handle` string, required: Per account unique identifier for the policy - `name` string, required: Name of the policy - `custom_name` string: Custom name that should be rendered in the consent definition instead of the defined name - `require_cardholder_name` boolean: Require name on card for credit card payments ## Response `200` Successful operation - Configuration - `name` string: Descriptive name for configuration - `logo` string: Logo url. Must be hosted on a *.frisbii.com or *.reepay.com domain. - `locale` string: Locale to use if not provided when creating session. Defaults to account locale. - `styleConfig` StyleConfig: Optional style configuration - `backgroundColor` string - `windowBackgroundColor` string - `windowHeaderBackgroundColor` string - `paymentHeaderBackgroundColor` string - `footerBackgroundColor` string - `darkMode` boolean - `windowHeaderBoxShadowColor` string - `footerFont` FontConfig - `color` string - `family` string - `size` string - `weight` integer - `sizeMobile` string - `weightMobile` integer - `footerLogoColor` 'grey' | 'black' | 'blue' | 'white': Frisbii logo colour in the checkout footer. Defaults to grey. - `windowHeaderCancelButton` FontConfig - `color` string - `family` string - `size` string - `weight` integer - `sizeMobile` string - `weightMobile` integer - `defaultConfig` DefaultConfig - `font` FontConfig - `color` string - `family` string - `size` string - `weight` integer - `sizeMobile` string - `weightMobile` integer - `border` BorderTypeConfig - `standard` BorderConfig - `width` string - `color` string - `radius` string - `focused` BorderConfig - `width` string - `color` string - `radius` string - `valid` BorderConfig - `width` string - `color` string - `radius` string - `invalid` BorderConfig - `width` string - `color` string - `radius` string - `buttonConfig` ButtonConfig - `payButtonSpacing` SpacingConfig - `padding` PaddingConfig - `top` string - `bottom` string - `right` string - `left` string - `margin` MarginConfig - `top` string - `bottom` string - `right` string - `left` string - `continueButtonSpacing` SpacingConfig - `padding` PaddingConfig - `top` string - `bottom` string - `right` string - `left` string - `margin` MarginConfig - `top` string - `bottom` string - `right` string - `left` string - `payButtonBorder` BorderConfig - `width` string - `color` string - `radius` string - `continueButtonBorder` BorderConfig - `width` string - `color` string - `radius` string - `paymentMethodDivider` PaymentMethodDividerConfig - `color` string - `topColor` string - `bottomColor` string - `paymentMethodTitle` PaymentMethodTitleConfig - `standard` FontConfig - `color` string - `family` string - `size` string - `weight` integer - `sizeMobile` string - `weightMobile` integer - `selected` FontConfig - `color` string - `family` string - `size` string - `weight` integer - `sizeMobile` string - `weightMobile` integer - `coBrandedCardSelection` CoBrandedCardSelectionConfig - `font` FontConfig - `color` string - `family` string - `size` string - `weight` integer - `sizeMobile` string - `weightMobile` integer - `radioButtonGroup` RadioButtonGroupConfig - `font` FontConfig - `color` string - `family` string - `size` string - `weight` integer - `sizeMobile` string - `weightMobile` integer - `unchecked` RadioButtonConfig - `fontWeight` integer - `fontWeightMobile` integer - `indicatorSize` string - `indicatorSizeMobile` string - `indicatorColor` string - `checked` RadioButtonConfig - `fontWeight` integer - `fontWeightMobile` integer - `indicatorSize` string - `indicatorSizeMobile` string - `indicatorColor` string - `paymentDescription` FontConfig - `color` string - `family` string - `size` string - `weight` integer - `sizeMobile` string - `weightMobile` integer - `paymentAmount` FontConfig - `color` string - `family` string - `size` string - `weight` integer - `sizeMobile` string - `weightMobile` integer - `labels` FontConfig - `color` string - `family` string - `size` string - `weight` integer - `sizeMobile` string - `weightMobile` integer - `payButton` ButtonStateConfig - `enabled` ButtonAppearanceConfig - `font` FontConfig - `color` string - `family` string - `size` string - `weight` integer - `sizeMobile` string - `weightMobile` integer - `backgroundColor` string - `disabled` ButtonAppearanceConfig - `font` FontConfig - `color` string - `family` string - `size` string - `weight` integer - `sizeMobile` string - `weightMobile` integer - `backgroundColor` string - `continueButton` ButtonStateConfig - `enabled` ButtonAppearanceConfig - `font` FontConfig - `color` string - `family` string - `size` string - `weight` integer - `sizeMobile` string - `weightMobile` integer - `backgroundColor` string - `disabled` ButtonAppearanceConfig - `font` FontConfig - `color` string - `family` string - `size` string - `weight` integer - `sizeMobile` string - `weightMobile` integer - `backgroundColor` string - `orderLineName` FontConfig - `color` string - `family` string - `size` string - `weight` integer - `sizeMobile` string - `weightMobile` integer - `orderLineQuantity` FontConfig - `color` string - `family` string - `size` string - `weight` integer - `sizeMobile` string - `weightMobile` integer - `orderLineAmount` FontConfig - `color` string - `family` string - `size` string - `weight` integer - `sizeMobile` string - `weightMobile` integer - `inputs` InputConfig - `border` BorderTypeConfig - `standard` BorderConfig - `width` string - `color` string - `radius` string - `focused` BorderConfig - `width` string - `color` string - `radius` string - `valid` BorderConfig - `width` string - `color` string - `radius` string - `invalid` BorderConfig - `width` string - `color` string - `radius` string - `standardText` FontConfig - `color` string - `family` string - `size` string - `weight` integer - `sizeMobile` string - `weightMobile` integer - `placeholderText` FontConfig - `color` string - `family` string - `size` string - `weight` integer - `sizeMobile` string - `weightMobile` integer - `spacing` SpacingConfig - `padding` PaddingConfig - `top` string - `bottom` string - `right` string - `left` string - `margin` MarginConfig - `top` string - `bottom` string - `right` string - `left` string - `boxShadowColor` string - `companyName` FontConfig - `color` string - `family` string - `size` string - `weight` integer - `sizeMobile` string - `weightMobile` integer - `companyAddress` FontConfig - `color` string - `family` string - `size` string - `weight` integer - `sizeMobile` string - `weightMobile` integer - `title` FontConfig - `color` string - `family` string - `size` string - `weight` integer - `sizeMobile` string - `weightMobile` integer - `subTitle` FontConfig - `color` string - `family` string - `size` string - `weight` integer - `sizeMobile` string - `weightMobile` integer - `termsLine` FontConfig - `color` string - `family` string - `size` string - `weight` integer - `sizeMobile` string - `weightMobile` integer - `pricingItemTitle` FontConfig - `color` string - `family` string - `size` string - `weight` integer - `sizeMobile` string - `weightMobile` integer - `pricingItemRow` FontConfig - `color` string - `family` string - `size` string - `weight` integer - `sizeMobile` string - `weightMobile` integer - `site` string: Checkout site domain to use: `reepay` or `frisbii` - `handle` string, required - `created` string, date-time - `payment_methods` string[]: Optional lists of payment methods to use for sessions with this configuration - `co_branded_card_selection` boolean: Option to control if the cardholder should be able to choose which part of a co-branded card to use. Defaults to false. - `co_branded_visa_dankort_preference` string: Default selected part of a co-branded Visa-Dankort if `co_branded_card_selection` enabled and cardholder makes no specific selection. - `amount_formatting` 'currency_code' | 'currency_symbol': How to format amount and currency: `currency_code` - with currency code, e.g. 100 USD (default), or `currency_symbol` - with symbol, e.g. $100 - `payment_type_priority` string[]: List of payment types giving the order in the checkout - `show_test_hints` boolean: For test accounts, use this setting to control if info boxes with hints on how to perform testing should be shown in Checkout. - `show_subscription_details_expanded` boolean: A property, which shows if subscription details should be expanded in Checkout. - `consent_configuration` ConsentConfiguration: Configuration for required consents - `consent_definitions` ConsentDefinitionDto[]: List of consent definitions for this configuration - `text` string, required: Text of the consent definition that should be rendered. The text supports templates for policies handles. - `policies` PolicyDefinitionDto[]: List of policy handles that are used in the text of the consent definition. - `handle` string, required: Per account unique identifier for the policy - `name` string, required: Name of the policy - `custom_name` string: Custom name that should be rendered in the consent definition instead of the defined name - `require_cardholder_name` boolean: Require name on card for credit card payments ## Other responses - `400`: Invalid request, see error codes at https://api.frisbii.com/v1/error_codes - `401`: None or invalid credentials provided in access to secured resource - `403`: Not authorized to perform resource operation - `404`: Resource or referenced resource not found, see error codes at https://api.frisbii.com/v1/error_codes - `500`: Internal service error, error is reported automatically to Frisbii --- [API](https://skmtc.dev/frisbii/apis/frisbii-checkout-api.md) - [All operations](https://skmtc.dev/frisbii/apis/frisbii-checkout-api/llms.txt) - [OpenAPI document](https://skmtc.dev/frisbii/apis/frisbii-checkout-api/revisions/43015ffd9dbb?raw)