Update Account-Level Settlement Schedule

This endpoint updates the default settlement schedule for all merchants under an account.

Note: This does not override merchants that have a custom settlement schedule already set.

PATCH https://<Platform-host>/api/settlement-schedules

Request

Name	Type	Description
custom_settlement_time	string	Time of settlement in 24-hour HH:mm format (e.g., "15:00"). Note: This field is required if settlement_timezone is provided
custom_settlement_timezone	string	Timezone for the settlement time (e.g., "US/Alaska"). See list of supported timezones below Note: This field is required if settlement_time is provided
custom_settlement_enabled	boolean	Indicates if a custom settlement schedule should be applied at account level

List of supported time zones

• US/Alaska

• US/Aleutian

• US/Arizona

• US/Central

• US/Eastern

• US/Hawaii

• US/Mountain

• US/Pacific

Use the exact timezone string from the list above when setting settlement_timezone.

Response

Name	Type	Description
message	string	success | failed success - if the gateway settlement schedule is updated successfully failed - if the gateway settlement schedule is not updated
data.custom_settlement_time	string	The configured settlement time (HH:mm format) Note - Time provided in the request
data.custom_settlement_timezone	string	The configured timezone Note: Timezone provided in the request
data.custom_settlement_enabled	boolean	True if the gateway is enabled for the merchant

Sample Request and Response

Sample Request Body

{
    "custom_settlement_time": "18:00",
    "custom_settlement_timezone": "US/Mountain",
    "custom_settlement_enabled": true
}

Sample Response Body - success