Scheduled Jobs
Eclipse supports scheduled jobs that execute recurring financial operations — such as regular withdrawals to a beneficiary or periodic wallet payments — without manual intervention. Jobs can be configured at the tenant level or scoped to a specific wallet.
Accessing Scheduled Jobs
- Tenant-level: Navigate to the tenant sidebar → Scheduled Jobs. Manage all scheduled jobs for the tenant.
- Wallet-level: Open a wallet (customer, organisation, tenant, or system wallet) → Scheduled Withdrawals tab. Manage jobs scoped to that specific wallet.
Job Types
| Type | Description |
|---|---|
WITHDRAWAL | Executes a withdrawal from a wallet to a registered beneficiary on a schedule |
PAYMENT | Executes a wallet-to-wallet payment on a schedule |
Creating a Scheduled Job
- Navigate to Scheduled Jobs or a wallet's Scheduled Withdrawals tab.
- Click + Schedule Job.
- Fill in the required fields:
Base fields (all job types):
| Field | Required | Description |
|---|---|---|
| Job Type | Yes | WITHDRAWAL or PAYMENT |
| Description | Yes | Human-readable label for this job |
| Start Date / Time | Yes | When the first execution should occur |
| End Date / Time | No | When the schedule should stop (leave blank for indefinite) |
| Time Zone | No | Time zone for the schedule (defaults to UTC) |
| Recurrence (cron) | Yes | Cron expression defining the schedule (e.g., 0 8 1 * * for 8 AM on the 1st of every month) |
Withdrawal-specific fields:
| Field | Required | Description |
|---|---|---|
| Wallet ID | Yes | The source wallet to debit |
| Beneficiary ID | Yes | The registered beneficiary to pay |
| Amount | Yes | Amount in minor currency units (cents) |
| Currency | Yes | ISO 3-letter currency code |
Payment-specific fields:
| Field | Required | Description |
|---|---|---|
| Source Wallet ID | Yes | Wallet to debit |
| Destination Wallet ID | Yes | Wallet to credit |
| Amount | Yes | Amount in minor currency units |
| Currency | Yes | ISO 3-letter currency code |
- Click Save. The job is created and will execute at the first scheduled time.
Cron Expression Reference
Eclipse uses standard 5-field cron syntax: minute hour day-of-month month day-of-week
| Expression | Meaning |
|---|---|
0 8 1 * * | 8:00 AM on the 1st of every month |
0 9 * * 1 | 9:00 AM every Monday |
0 0 */7 * * | Every 7 days at midnight |
30 15 28 * * | 3:30 PM on the 28th of every month |
Scheduled Jobs Table Columns
| Column | Description |
|---|---|
| Job ID | Unique identifier |
| Description | Label set at creation |
| Type | WITHDRAWAL or PAYMENT |
| Customer ID | Customer associated with the source wallet (if applicable) |
| Wallet ID | Source wallet |
| Start Date | First scheduled execution |
| End Date | Last scheduled execution (if set) |
Editing a Scheduled Job
- Locate the job in the table.
- Click Edit in the actions column.
- Update the fields as needed.
- Click Save.
Editing a job does not affect previous executions — only future executions are affected.
Deleting a Scheduled Job
- Locate the job and click Delete.
- Confirm deletion.
Deletion stops all future executions. Past executions are recorded in the wallet's transaction history and are not removed.
Monitoring Job Execution
Each time a scheduled job runs, it creates a transaction on the source wallet. Check the wallet's Transaction History tab to confirm job executions. If a job fails (e.g., insufficient funds, invalid beneficiary), the failure is recorded and the job will attempt execution again at the next scheduled time.
Permissions
Creating and managing scheduled jobs requires the ScheduledJobs.CREATE and ScheduledJobs.UPDATE permissions on the user's role. Read access requires ScheduledJobs.READ.
Updated about 8 hours ago