--- title: "Service:UpdateSettings" method: PATCH path: "/v2/services/{serviceId}/settings" tags: ["Services"] --- # Service:UpdateSettings `PATCH /v2/services/{serviceId}/settings` Update settings of your service. You need to have access to that service to be able to update the settings ## Path parameters - `serviceId` string, required ## Request body - ServiceInputSettings — Input for updating service settings. - `cnp` ServiceInputSettingsCardNotPresentSettings — Input for updating card not present settings within service configuration. - `showGrouped` boolean, nullable - `contactMethodType` 'WEBSITE' | 'PHONE' | 'null', nullable - `contactMethodValue` string, nullable - `delayedCapture` boolean, nullable - `recurring` boolean, nullable - `cardHolderTypes` string[] - `fundingTypes` string[] - `allowedRegions` string[] - `blockedCountries` string[], nullable - `tds` ServiceInputSettingsTdsSettings — Input for updating TDS settings within service configuration. - `accept` 'FULL' | 'FULL_ATTEMPTED' | 'FULL_ATTEMPTED_NON_TDS' | 'null', nullable - `challengeLevel` 'NO_PREFERENCE' | 'NONE' | 'OPTIONAL' | 'MANDATORY' | 'null', nullable - `scaExemption` string[] - `pos` ServiceInputSettingsPointOfSaleSettings — Input for updating general point of sale settings within service configuration. - `refund` ServiceInputSettingsRefundSettings — Input for updating refund settings within service configuration. - `allowed` boolean, nullable - `mode` 'NONE' | 'ALL' | 'PER_TERMINAL' | 'null', nullable - `policyId` string, nullable - `ticketFooter` object, nullable - `ticketHeader` object, nullable - `giftcards` ServiceInputSettingsGiftCardSettings — Input for updating gift card settings within service configuration. - `showGrouped` boolean, nullable - `verify` ServiceInputSettingsVerifySettings — Input for updating verify settings within service configuration. - `strength` 'NONE' | 'LIGHT' | 'REGULAR' | 'STRONG' | 'KNOWN_INCIDENTS' | 'null', nullable - `showScreen` boolean, nullable - `level` 'SELF' | 'FULLSERVICE' | 'FULLSERVICEPLUS' | 'PREACCEPT' | 'null', nullable - `group` integer, nullable - `ruleGroup` string, nullable - `cnp` boolean, nullable - `other` boolean, nullable - `exchange` ServiceInputSettingsExchangeSettings — Input for updating exchange settings within service configuration. - `useExchange` 'NONE' | 'STATIC_URL' | 'API' | 'null', nullable - `urls` string[], nullable - `method` 'TXT-GET' | 'TXT-POST' | 'XML-POST' | 'JSON-POST' | 'SIGNED-JSON' | 'null', nullable - `seperator` string, nullable - `retryScheme` 'EIGHT_TIMES_AFTER_15M' | '9_TIMES_OVER_24H' | 'ONCE_AFTER_5S' | 'ONE_DAY' | '6_TIMES_OVER_2H' | 'null', nullable - `communicationStatus` 'ALL' | 'PAYMENT_COMPLETE_ONLY' | 'ORDER_CHANGE' | 'CHANGES_NO_PENDING' | 'null', nullable - `notifications` ServiceInputSettingsNotificationsSettings — Input for updating notification settings within service configuration. - `refundNotification` 'NO' | 'YES' | 'ONLY_VOUCHER_MULTIPAYMENT' | 'null', nullable - `transactionNotification` 'NO' | 'YES' | 'YES_NO_PRIVACY_DATA' | 'null', nullable - `emailAddresses` string[], nullable - `googleAnalytics` ServiceInputSettingsGoogleAnalyticsSettings — Input for updating Google Analytics settings within service configuration. - `type` 'STANDARD' | 'GA4' | 'null', nullable - `code` string, nullable - `secret` string, nullable - `secondChance` ServiceInputSettingsSecondChanceSettings — Input for updating second chance settings within service configuration. - `bccEmailAddress` string, nullable - `timeoutMinutes` integer, nullable - `linkExpirationDays` integer, nullable ## Response `200` Created - ServiceOutputSettings — Settings for a service. Contains all configurable settings grouped by category. - `cnp` ServiceOutputSettingsCardNotPresentSettings — Represents the Card Not Present Settings in the Service Settings Output. - `showGrouped` BoolValueOutput — A boolean value that could contain a default value and a current value. - `defaultValue` boolean, nullable - `value` boolean, nullable - `contactMethodType` EnumValueOutput — An enum value containing a default value and a current value. - `defaultValue` unknown - `value` unknown - `contactMethodValue` StringValueOutput — A string value that could contain a default value and a current value. - `defaultValue` string, nullable - `value` string, nullable - `delayedCapture` BoolValueOutput — A boolean value that could contain a default value and a current value. - `defaultValue` boolean, nullable - `value` boolean, nullable - `recurring` BoolValueOutput — A boolean value that could contain a default value and a current value. - `defaultValue` boolean, nullable - `value` boolean, nullable - `cardHolderTypes` ArrayValueOutput — An array value that could contain a default value and a current value. - `defaultValue` string[], nullable - `value` string[], nullable - `fundingTypes` ArrayValueOutput — An array value that could contain a default value and a current value. - `defaultValue` string[], nullable - `value` string[], nullable - `allowedRegions` ArrayValueOutput — An array value that could contain a default value and a current value. - `defaultValue` string[], nullable - `value` string[], nullable - `blockedCountries` ArrayValueOutput — An array value that could contain a default value and a current value. - `defaultValue` string[], nullable - `value` string[], nullable - `tds` ServiceOutputSettingsTdsSettings — Represents the TDS Secure Settings in the Service Settings Output. - `accept` EnumValueOutput — An enum value containing a default value and a current value. - `defaultValue` unknown - `value` unknown - `challengeLevel` EnumValueOutput — An enum value containing a default value and a current value. - `defaultValue` unknown - `value` unknown - `scaExemption` ArrayValueOutput — An array value that could contain a default value and a current value. - `defaultValue` string[], nullable - `value` string[], nullable - `pos` ServiceOutputSettingsPointOfSaleSettings — Represents the Point of Sale Settings in the Service Settings Output. - `refund` ServiceOutputSettingsRefundSettings — Represents the Refund Settings in the Service Settings Output. - `allowed` BoolValueOutput — A boolean value that could contain a default value and a current value. - `defaultValue` boolean, nullable - `value` boolean, nullable - `mode` EnumValueOutput — An enum value containing a default value and a current value. - `defaultValue` unknown - `value` unknown - `policyId` StringValueOutput — A string value that could contain a default value and a current value. - `defaultValue` string, nullable - `value` string, nullable - `ticketFooter` ArrayValueOutput — An array value that could contain a default value and a current value. - `defaultValue` string[], nullable - `value` string[], nullable - `ticketHeader` ArrayValueOutput — An array value that could contain a default value and a current value. - `defaultValue` string[], nullable - `value` string[], nullable - `giftcards` ServiceOutputSettingsGiftCardSettings — Represents the Gift Card Settings in the Service Settings Output. - `showGrouped` BoolValueOutput — A boolean value that could contain a default value and a current value. - `defaultValue` boolean, nullable - `value` boolean, nullable - `verify` ServiceOutputSettingsVerifySettings — Represents the Verify Settings in the Service Settings Output. - `strength` EnumValueOutput — An enum value containing a default value and a current value. - `defaultValue` unknown - `value` unknown - `showScreen` BoolValueOutput — A boolean value that could contain a default value and a current value. - `defaultValue` boolean, nullable - `value` boolean, nullable - `level` EnumValueOutput — An enum value containing a default value and a current value. - `defaultValue` unknown - `value` unknown - `group` IntegerValueOutput — An integer value that could contain a default value and a current value. - `defaultValue` integer, nullable - `value` integer, nullable - `ruleGroup` StringValueOutput — A string value that could contain a default value and a current value. - `defaultValue` string, nullable - `value` string, nullable - `cnp` BoolValueOutput — A boolean value that could contain a default value and a current value. - `defaultValue` boolean, nullable - `value` boolean, nullable - `other` BoolValueOutput — A boolean value that could contain a default value and a current value. - `defaultValue` boolean, nullable - `value` boolean, nullable - `exchange` ServiceOutputSettingsExchangeSettings — Represents the Exchange Settings in the Service Settings Output. - `useExchange` 'NONE' | 'STATIC_URL' | 'API' - `urls` string[] - `method` 'TXT-GET' | 'TXT-POST' | 'XML-POST' | 'JSON-POST' | 'SIGNED-JSON' - `seperator` string, nullable - `retryScheme` EnumValueOutput — An enum value containing a default value and a current value. - `defaultValue` unknown - `value` unknown - `communicationStatus` 'ALL' | 'PAYMENT_COMPLETE_ONLY' | 'ORDER_CHANGE' | 'CHANGES_NO_PENDING' - `notifications` ServiceOutputSettingsNotificationsSettings — Notification settings nested within service settings. Contains notification URL and email configuration. - `refundNotification` 'NO' | 'YES' | 'ONLY_VOUCHER_MULTIPAYMENT' - `transactionNotification` 'NO' | 'YES' | 'YES_NO_PRIVACY_DATA' - `emailAddresses` string[] - `googleAnalytics` ServiceOutputSettingsGoogleAnalyticsSettings — Represents the Google Analytics Settings in the Service Settings Output. - `type` 'STANDARD' | 'GA4' - `code` string, nullable - `secret` string, nullable - `secondChance` ServiceOutputSettingsSecondChanceSettings — Represents Second Chance Settings in the Service Settings output. - `bccEmailAddress` string - `timeoutMinutes` integer — The duration in seconds in after which the second chance will be sent. - `linkExpirationDays` integer — The duration in seconds in after which the link will expire. ## Other responses - `400` — Bad request, see response body for more information - `401` — Unauthorized. Supplied credentials are invalid - `403` — Forbidden. Supplied credentials have no rights - `404` — Resource not found - `405` — Used HTTP method is not allowed - `406` — Not acceptable. The supplied content type in the accept parameter in the header is not supported - `410` — Indicates that this resource is no longer available for use - `415` — Unsupported media. The supplied content type in the content-type parameter in the header is not supported - `422` — Unprocessable entity - `429` — Rate limit reached. - `500` — An internal error occurred. - `503` — The server is currently unable to handle your request --- [API](https://skmtc.net/pay/apis/pay-transaction-gateway-unit-api.md) · [All operations](https://skmtc.net/pay/apis/pay-transaction-gateway-unit-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pay/pay-transaction-gateway-unit-api/versions/2bc260c7bdfc/schema)