Create a transfer schedule, which represents a transfer operation from a parent (main) account to one or more associated child accounts. Configure the schedule's execution frequency and other details in the schedule_details field.
Transfer amounts can be set as follows.
- If you fill out the
strategyfield, the platform uses the strategy logic to determine transfer amounts. - If you don't fill out the
strategyfield, you must specify theamountfield for each transfer in thetransfersarray.
In some cases, due to errors and retries, execution of the scheduled transaction might occur on the following day instead of the originally scheduled date. To address this, the allow_execution_after_day_change flag in schedule_details enables you to pre-authorize execution of the scheduled transaction on the next day. This flag must be set to true for schedules that are set to be executed at the end of the day (after 11:30pm UTC). If the schedule is not executed on the expected day for any reason, and this field isn't set to true, the schedule is not executed and is marked as EXECUTED_WITH_ERROR_NEXT_DAY_NOT_ALLOWED.
This endpoint generates the Scheduled payment created or modified event with the status field set to CREATED.
Each execution of the schedule also generates the Scheduled payment executed event.
Refer to the Payment scheduler guide for more information.