--- title: "Updating Settlement Time" method: PATCH path: "/v4/processors/{id}" tags: ["Gateway Features", "Settlement Time"] --- # Updating Settlement Time `PATCH /v4/processors/{id}` > ❗️ Never Use Real API Keys > > Never use real API Keys when testing. The gateway allows Partners to create Test Merchant Accounts. Testing should always use keys from the Test Accounts and never keys from a Standard Account.
Usage This can be done when creating the merchant’s processor in the first place (Add Processors) but you can also update it whenever you’d like using the request below. Please note this is a PATCH request. Attempting a POST will result in an error. The date must be a valid ISO 8601 time string (Example: 13:14:15). Since this is an update to an existing merchant’s processor, we return the processor object, and you can confirm your change was successful by looking at the settlementTime value in this response.
## Path parameters - `id` string, required ## Headers - `Content-Type` string, required - `Authorization` string, required ## Request body - UpdatingSettlementTimeRequest - `settlementTime` string, required — Required. Specifies the time at which the settlement process will be executed following a successful update. This value determines when the settlement operations will occur. ## Response `200` Success - UpdatingSettlementTimeResponse - `objectType` string — The type of object that was returned as a result of the request. - `id` number — The ID of the request. - `processorType` string — The type of payment processor. - `processorId` string — The ID of the processor. - `processorName` string — The name of the processor. - `serviceId` string — The ID of the processor platform. - `merchantId` number — The ID of the merchant. - `mcc` string — The Merchant Category Code. - `accountClassification` string — The processor account classification. - `maxTicketAmount` string — The maximum amount for a single transaction run through the added processor. - `maxMonthlyVolume` string — The maximum total amount that can be run through the processor in a single month. - `applyToAllCardType` boolean — Whether the maxMonthlyVolume and maxTicketAmount apply to all payment methods through the added processor or not. - `enableDuplicateChecking` boolean — Whether duplicate checking is enabled or not. - `allowMerchantOverride` boolean — Whether the merchant is allowed to ignore the duplicate check on a per-transaction basis or not. - `duplicateTime` string — The amount of time in seconds to look back to check if a transaction is a duplicate. - `status` 'active' | 'pending' — The status of the added processor or service, depending on the processor/billing authorization status. - `condition` 'offered' | 'notOffered' | 'mandatory' — The condition of the added processor or service. - `extraDetails` object — Any extra details about the added processor. - `freeTrialEndDate` string — End date of free trial. - `freeTrialDaysLeft` string — Days left of free trial. - `hasBeenActive` boolean — Whether the processor has been active before or not. - `created` string — The date and time of when the processor or service was added. - `updated` string — The date and time of when the processor or service was last updated. - `supportsReroutedRefunds` boolean — Whether the added processor supports rerouted refunds or not. - `shouldDisableFields` boolean — Whether the added processor should disable fields or not. - `disabled` boolean — Whether the processor is disabled or not. - `refundProcessor` string — The specified processor to reroute future refunds to, if this processor is disabled. - `billingType` string — The billing type of the added processor or service. - `avsCvvPreCheck` string — The AVS/CVV precheck method for the added processor. - `skipAvsCvv` boolean — Whether skipping AVS/CVV is enabled for the added processor or not. - `processorFields` object — The processor-dependent fields for the added processor. - `paymentTypes` string[] — The allowed payment types for the added processor. - `descriptor` object — The descriptor fields for the added processor. - `descriptor` string — The descriptor for the added processor. - `phone` string — The descriptor phone number for the added processor. - `city` string — The descriptor city for the added processor. - `state` string — The descriptor state for the added processor. - `url` string — The descriptor URL for the added processor. - `currencies` string[] — The allowed currencies for the added processor. - `requiredFields` object — The fields that are required to be populated for each transaction. - `name` boolean — Whether the name is a required field or not. - `company` boolean — Whether the company is a required field or not. - `address` boolean — Whether the address is a required field or not. - `city` boolean — Whether the city is required field or not. - `state` boolean — Whether the state is a required field or not. - `zip` boolean — Whether the ZIP code is a required field or not. - `country` boolean — Whether the country is a required field or not. - `phone` boolean — Whether the phone is a required field or not. - `email` boolean — Whether the email is a required field or not. - `driversLicense` boolean — Whether the driver's license is a required field or not. - `driversLicenseState` boolean — Whether the driver's license state is a required field or not. - `driversLicenseDob` boolean — Whether the driver's license date of birth is a required field or not. - `ssn` boolean — Whether the SSN is a required field or not. - `cvv` string — The CVV requirement setting. - `fax` boolean — Whether the fax is a required field or not. - `url` boolean — Whether the URL is a required field or not. - `orderId` boolean — Whether the order ID is a required field or not. - `orderDescription` boolean — Whether the order description is a required field or not. - `poNumber` boolean — Whether the PO number is a required field or not. - `shipping` boolean — Whether shipping is a required field or not. - `tax` boolean — Whether tax is a required field or not. - `shippingName` boolean — Whether the shipping name is a required field or not. - `shippingAddress` boolean — Whether the shipping address is a required field or not. - `shippingCity` boolean — Whether the shipping city is a required field or not. - `shippingState` boolean — Whether the shipping state is a required field or not. - `shippingZip` boolean — Whether the shipping ZIP code is a required field or not. - `shippingCountry` boolean — Whether the shipping country is a required field or not. - `mdf1` boolean — Whether Merchant Defined Field 1 is a required field or not. - `mdf2` boolean — Whether Merchant Defined Field 2 is a required field or not. - `mdf3` boolean — Whether Merchant Defined Field 3 is a required field or not. - `mdf4` boolean — Whether Merchant Defined Field 4 is a required field or not. - `mdf5` boolean — Whether Merchant Defined Field 5 is a required field or not. - `mdf6` boolean — Whether Merchant Defined Field 6 is a required field or not. - `mdf7` boolean — Whether Merchant Defined Field 7 is a required field or not. - `mdf8` boolean — Whether Merchant Defined Field 8 is a required field or not. - `mdf9` boolean — Whether Merchant Defined Field 9 is a required field or not. - `mdf10` boolean — Whether Merchant Defined Field 10 is a required field or not. - `mdf11` boolean — Whether Merchant Defined Field 11 is a required field or not. - `mdf12` boolean — Whether Merchant Defined Field 12 is a required field or not. - `mdf13` boolean — Whether Merchant Defined Field 13 is a required field or not. - `mdf14` boolean — Whether Merchant Defined Field 14 is a required field or not. - `mdf15` boolean — Whether Merchant Defined Field 15 is a required field or not. - `mdf16` boolean — Whether Merchant Defined Field 16 is a required field or not. - `mdf17` boolean — Whether Merchant Defined Field 17 is a required field or not. - `mdf18` boolean — Whether Merchant Defined Field 18 is a required field or not. - `mdf19` boolean — Whether Merchant Defined Field 19 is a required field or not. - `mdf20` boolean — Whether Merchant Defined Field 20 is a required field or not. - `faceConfiguration` object — The FACe configuration for the added processor. - `disabledFields` object — The disabled fields for the added processor. - `processorFields` object — The processor-dependent fields and whether they are disabled or not. - `settlementTime` string — Specifies the time at which the settlement process will be executed following a successful update. This value determines when the settlement operations will occur. --- [API](https://skmtc.net/nmi/apis/embedded-components-api.md) · [All operations](https://skmtc.net/nmi/apis/embedded-components-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nmi/embedded-components-api/versions/45c2ecda3685/schema)