---
title: "Update Merchant Settings"
method: PUT
path: "/v3/merchantsetting/{merchantId}"
---

# Update Merchant Settings

`PUT /v3/merchantsetting/{merchantId}`

Update the settings of a merchant

## Path parameters

- `merchantId` string, required

## Request body

- object
  - `lossPrevention` object — Loss prevention settings
    - `keyedAvsAddress` boolean — Require Street Address when doing keyed transactions
    - `keyedAvsZip` boolean — Require Postal Code when doing keyed transactions
    - `keyedCvv` boolean — Require CVV when doing keyed transactions
    - `swipedAvsAddress` boolean — Require Street Address when doing swiped transactions
    - `swipedAvsZip` boolean — Require Postal Code when doing swiped transactions
    - `swipedLastFourDigits` boolean — Require Last 4 Digits when doing swiped transactions
    - `checkPhoneNumber` boolean — Require Phone Number when doing check transactions
    - `checkNumber` boolean — Require Check Number when doing check transactions
    - `declineOnCvvMismatch` boolean — Auto-decline on CVV mismatch
    - `declineOnAvsZipMismatch` boolean — Auto-decline on Postal Code mismatch
    - `declineOnAvsStreetMismatch` boolean — Auto-decline on Street Address mismatch
    - `enableEms` boolean — Enable or Disable EMS Fraud Scoring
    - `emsPaymentAmountThreshold` number, float — Only trigger EMS checks for payments over this amount.
    - `declineOnEmsScoreExceeded` boolean — Auto-decline if EMS score threshold is exceeded
    - `declineEmsScoreThreshold` number, float — EMS Score threshold
  - `receipt` object
    - `showPhone` boolean
    - `showWebsiteUrl` boolean
    - `returnPolicy` string
    - `imageDataUrl` string
    - `name` string
    - `phone` string
    - `email` string
    - `websiteUrl` string
    - `showHistory` boolean
    - `showLoyaltyPoints` boolean
    - `showTip` boolean
    - `receiptType` string
    - `showMasterCardMasterPass` boolean
    - `showInvoiceMemo` boolean
  - `payment` object
    - `promptForCustomData` boolean
    - `includeB2bFields` boolean
    - `enableAchPayments` boolean
    - `enableCashPayments` boolean
    - `enableCardPayments` boolean
    - `enableCheckPayments` boolean
    - `quickPayTransactionType` string
    - `quickPayTender` string
    - `quickPayCardPresent` string
    - `quickPayEndOfPayment` string
    - `autoCloseTime` string
    - `enableAutoClose` boolean
    - `terminalAutoCloseTime` string
    - `enableTerminalAutoClose` boolean
    - `enableTerminalBatch` boolean
    - `enableTip` boolean
    - `achIndicator` string
    - `enableDuplicateCheck` boolean
    - `enableVaultCard` boolean
    - `enableAuthorize` boolean
    - `enableTaxExempt` boolean
    - `enableSettleFunds` boolean
    - `enableDynamicDescriptor` boolean
    - `enabledB2BLineItem` boolean
    - `mxAdvantageEnabled` boolean
    - `mxAdvantageFeeLabel` string
  - `invoice` object
    - `enableItems` boolean
    - `enableTasks` boolean
    - `enableFulfillment` boolean
    - `defaultFulfillment` string
    - `enableInvoicing` boolean
    - `paymentTerms` string
    - `legalTerms` string
    - `enableClickToPay` boolean
    - `enableAch` boolean
    - `reminderDays` integer
    - `receiptDays` integer
    - `enableCardPayment` boolean
    - `interval` string
    - `frequency` integer
    - `dayNumber` integer
    - `dayType` string
    - `day` string
    - `requireAuthorization` boolean
    - `sendDeclineEmail` boolean
    - `month` string
    - `allowMultipleOrderDiscounts` boolean
    - `allowMultipleProductDiscounts` boolean
    - `InvoiceNumberSeed` integer
    - `InvoiceNumberSeedLocked` boolean
    - `sendEmail` boolean
    - `sendSms` boolean

## Response `201`

201

- object
  - `lossPrevention` object
    - `keyedAvsAddress` boolean
    - `keyedAvsZip` boolean
    - `keyedCvv` boolean
    - `swipedAvsAddress` boolean
    - `swipedAvsZip` boolean
    - `swipedLastFourDigits` boolean
    - `checkPhoneNumber` boolean
    - `checkNumber` boolean
    - `declineOnCvvMismatch` boolean
    - `declineOnAvsZipMismatch` boolean
    - `declineOnAvsStreetMismatch` boolean
    - `enableEms` boolean
    - `emsPaymentAmountThreshold` string
    - `declineOnEmsScoreExceeded` boolean
    - `declineEmsScoreThreshold` integer
  - `receipt` object
    - `showPhone` boolean
    - `showWebsiteUrl` boolean
    - `returnPolicy` string
    - `imageWidth` integer
    - `imageHeight` integer
    - `imageSize` integer
    - `imageDataUrl` string
    - `imageName` string
    - `title` string
    - `name` string
    - `phone` string
    - `receiptMessage` string
    - `email` string
    - `websiteUrl` string
    - `showHistory` boolean
    - `showLoyaltyPoints` boolean
    - `showTip` boolean
    - `address` object
      - `address1` string
      - `city` string
      - `state` string
      - `zip` string
    - `receiptType` string
    - `showMasterCardMasterPass` boolean
  - `payment` object
    - `promptForCustomData` boolean
    - `includeB2bFields` boolean
    - `enableAchPayments` boolean
    - `enableCashPayments` boolean
    - `enableCardPayments` boolean
    - `enableCheckPayments` boolean
    - `quickPayTransactionType` string
    - `quickPayTender` string
    - `quickPayCardPresent` string
    - `quickPayEndOfPayment` string
    - `autoCloseTime` string
    - `enableAutoClose` boolean
    - `enableTip` boolean
    - `achIndicator` string
  - `invoice` object
    - `enableItems` boolean
    - `enableTasks` boolean
    - `enableFulfillment` boolean
    - `defaultFulfillment` string
    - `enableInvoicing` boolean
    - `paymentTerms` string
    - `legalTerms` string
    - `enableClickToPay` boolean
    - `enableAch` boolean
    - `reminderDays` integer
    - `receiptDays` integer
    - `enableCardPayment` boolean
    - `interval` string
    - `frequency` integer
    - `dayNumber` integer
    - `dayType` string
    - `day` string
    - `requireAuthorization` boolean
    - `sendDeclineEmail` boolean
    - `month` string
    - `orderSourceType` string
    - `allowMultipleOrderDiscounts` boolean
    - `allowMultipleProductDiscounts` boolean
  - `general` object
    - `defaultCatalogId` integer
    - `locationId` integer
    - `package` string[]
    - `timezoneOffset` string
    - `daylightSaving` boolean

## Other responses

- `400` — 400

---

[API](https://skmtc.net/mxmerchant/apis/checkout-api.md) · [All operations](https://skmtc.net/mxmerchant/apis/checkout-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mxmerchant/checkout-api/versions/6807b698abcb/schema)