Update Settlement Schedule(s)

Update / set a payout on a Merchant's Settlement Schedule(s).

Parameters

The following parameters are available to properly update / set payout on a settlement schedule.

parameterdescriptionrequired
id

the id of the settlement schedule to be updated
The settlement id can be found by using the 'Fetch Settlement Schedule' API call

Yes
name

your name of the settlement schedule (individually granted)

No
description

a description of the settlement schedule (individually granted)

No
schedule

the desired schedule frequency of the settlement schedule
Possible request values are daily, weekly, monthly, and annually

No
schedule_factor

the multiplier to the settlement schedule
For example: A request with a daily schedule and a schedule factor of 2 will make settlements every other day, a schedule factor of 3 will settle every third day and so on

No
start_date

the start date of the updated settlement
Note: The date is in YYYYMMDD form and the dates must be Tuesday through Friday

No
amountthe desired amount to be settledNo
unit_of_measure

the unit of measure that the settlement is using to calculate how much is being settled
Possible request values are actual for a specific dollar amount being settled and percent for a percent amount being settled (individually granted)

No
minimum

the minimum amount required for a settlement to be made (individually granted)

No
maximum

the maximum amount of a settlement (individually granted)

No
float

the minimum amount that is desired to stay inside of an account's balance (individually granted)

No
off_days

indicates whether or not that holidays and weekends will create a settlement
Possible request values are 0 = do not skip off days and 1 = skip off days (individually granted)

No
same_day

indicates whether a settlement will be made the same day this update is requested
Possible request values are 0 = not same day and 1 = is same day (individually granted)

No
is_inactive

indicates whether or not the settlement schedule is active
Possible request values are 0 = active and 1 = inactive (individually granted)

No
is_frozen

indicates whether or not the settlement schedule is frozen
Possible request values are 0 = not frozen and 1 = frozen (individually granted)

No
JSON Example

The following JSON example provides test values to update a settlement schedule. You can copy and paste these values in the Body Params section above to be used by the Try It feature

{
  [
    {
      "id": "{schedule_id}",
      "amount": 3.00
    },
    {
      "id": "{schedule_id}",
      "amount": 6.00
    }
  ]
}
Language
Click Try It! to start a request and see the response here!