Schedule API

Create, retrieve, and delete schedules. Schedules are charges or transfers that occur at regular intervals, for example, a monthly membership fee or a weekly transfer. Actual schedule dates are accessed via the occurrence API.

Metadata Key Formatting and Limitations

Using metadata fields is optional. When using these fields, please adhere to the following requirements:

Key Format Requirements

Each metadata key must be formatted as a unique column using the specific syntax:

metadata["SOME_METADATA_KEY"]

Where "SOME_METADATA_KEY" represents your custom identifier.

Example: metadata["membership_card"]

System Limitations

The metadata system enforces several important constraints:

Maximum Keys

Limit: 50 unique metadata keys per implementation
Ensures optimal database performance and prevents resource overconsumption

Key Character Limit

Limit: 50 characters maximum per metadata key identifier
Promotes concise and manageable naming conventions

Value Character Limit

Limit: 500 characters maximum per metadata value
Provides sufficient space for detailed information while maintaining system performance

Purpose

These limitations ensure optimal database performance and prevent resource overconsumption while still allowing for comprehensive metadata storage and retrieval.

Attributes

Name	Type	Description
object	string	The string `schedule`.
id	string	The schedule identifier matching `/schd(_test)?_[0-9a-z]+/`.
livemode	boolean	Whether this is a live (`true`) or test (`false`) schedule.
location	string	API path to retrieve the current `schedule` object.
active	boolean	Whether schedule is status `active` or `expiring`.
charge	charge_schedule	Charge schedule object.
created	string	UTC datetime of schedule creation in ISO 8601 format (`YYYY-MM-DDThh:mm:ssZ`).
creator_display_name	string	TBD
deleted	boolean	Whether schedule is deleted.
deleted_by	string	TBD
end_date	string	End date of schedule in ISO 8601 format.
ended_at	string	Actual end date of schedule in ISO 8601 format.
every	integer	How often schedule should run when applied to `period`. For example, if set to `3` and `period` is set to `week`, schedule should run every `3` weeks.
execute_time	string	TBD
in_words	string	Schedule expressed as an English sentence. E.g.: `Every 2 months on the 15th`, `Every 3 days`, `Every week on monday and friday`.
is_admin_managed	boolean	TBD
merchant_name	string	TBD
next_occurrence_dates	array	An array of up to 30 upcoming occurrence dates in ISO 8601 format. Returns an empty array in case of expired, suspended or deleted schedule.
occurrences	list	List of occurrence objects.
on	object	Object specifying schedule timing.
period	string	Period to use for `every`. One of `day`, `week` or `month`. For example, if set to `week` and `every` is set to `3` schedule should run every 3 weeks.
start_date	string	Start date of schedule in ISO 8601 format.
state	string	Indicates whether the schedule is Active or Paused.
status	string	The current status of the schedule. One of: `active`: The schedule is running. `expiring`: The schedule's next occurrence is its last. `expired`: The schedule has reached its last occurrence and is not running anymore. `deleted`: The schedule has been deleted and is not running anymore. `paused`: The schedule is paused `suspended`: The schedule could not be completed and was stopped. Schedules are suspended three (3) days after the charge is unsuccessful, as Omise systems will retry three (3) times, one time per day. .
transfer	transfer_schedule	Transfer schedule object.

Example

JSON Response

{
  "object": "schedule",
  "id": "schd_test_no1t4tnemucod0e51mo",
  "livemode": false,
  "location": "/schedules/schd_test_no1t4tnemucod0e51mo",
  "next_occurrence_dates": [
    "2023-11-01",
    "2023-11-03",
    "2023-11-05",
    "2023-11-07",
    "2023-11-09",
    "2023-11-11",
    "2023-11-13",
    "2023-11-15",
    "2023-11-17",
    "2023-11-19",
    "2023-11-21",
    "2023-11-23",
    "2023-11-25",
    "2023-11-27",
    "2023-11-29",
    "2023-12-01",
    "2023-12-03",
    "2023-12-05",
    "2023-12-07",
    "2023-12-09",
    "2023-12-11",
    "2023-12-13",
    "2023-12-15",
    "2023-12-17",
    "2023-12-19",
    "2023-12-21",
    "2023-12-23",
    "2023-12-25",
    "2023-12-27",
    "2023-12-29"
  ],
  "deleted": false,
  "end_date": "2024-11-01",
  "start_date": "2023-11-01",
  "every": 2,
  "occurrences": {
    "object": "list",
    "data": [],
    "limit": 20,
    "offset": 0,
    "total": 0,
    "location": "/schedules/schd_test_no1t4tnemucod0e51mo/occurrences",
    "order": "chronological",
    "from": "1970-01-01T00:00:00Z",
    "to": "2019-12-31T12:59:59Z"
  },
  "on": {},
  "charge": {
    "object": "scheduled_charge",
    "id": "rchg_test_no1t4tnemucod0e51mo",
    "livemode": false,
    "currency": "thb",
    "amount": 12345,
    "card": null,
    "customer": "cust_test_no1t4tnemucod0e51mo",
    "description": null,
    "metadata": null
  },
  "in_words": "Every 2 day(s)",
  "period": "day",
  "status": "active",
  "created": "2019-12-31T12:59:59Z",
  "ended_at": null,
  "active": true
}

Create a schedule

- POST https://api.omise.co/schedules

Creates and returns a new schedule.

Note: From the Omise dashboard, you can upload data of multiple cards as a batch for multiple schedules to be created automatically.

Request Parameters

Name Type Description

end_date

string

(required) End date of schedule in ISO 8601 format.

every

integer

(required) How often schedule should run when applied to period. For example, if set to 3 and period is set to week, schedule should run every 3 weeks.

period

string

(required, one of: day, week, month) Period to use for every. One of day, week or month. For example, if set to week and every is set to 3 schedule should run every 3 weeks.

start_date

string

(required) Start date of schedule in ISO 8601 format.

charge

object

(optional, but conditionally required) Charge schedule object. Use when creating a charge schedule.

When creating a charge schedule, pass the following parameters:

Name	Type	Required?	Description
amount	integer	yes	Scheduled charge amount in the smallest unit of charge currency.
card	string	no	Identifier for the card to be charged.
currency	string	no	Currency for the scheduled charge as a three-letter ISO 4217 code.
customer	string	yes	Identifier for the customer to be charged.
description	string	no	Scheduled charge description.

object

(optional) Object specifying schedule timing.

transfer

object

(optional, but conditionally required) Transfer schedule object. Use when creating a transfer schedule.

When creating a transfer schedule, pass the following parameters:

Name	Type	Required?	Description
amount	integer	no	Scheduled transfer amount in the smallest unit of charge currency.
currency	string	no	Currency for the scheduled transfer as a three-letter ISO 4217 code.
percentage_of_balance	float	no	Percentage of balance to transfer.
recipient	string	yes	Identifier for the recipient of the scheduled transfer.

Example

Charge a specific customer every 2 days

curl
php
node.js
ruby
C#
java
python
go
elixir

curl https://api.omise.co/schedules \
  -u $OMISE_SECRET_KEY: \
  -d "every=2" \
  -d "period=day" \
  -d "start_date=2022-01-01" \
  -d "end_date=2022-12-31" \
  -d "charge[customer]=cust_test_5g0221fe8iwtayocgja" \
  -d "charge[card]=card_test_5g021zls9ei5suyryss" \
  -d "charge[amount]=100000" \
  -d "charge[description]=Membership fee"

<?php

require './omise-php/lib/Omise.php';

define('OMISE_SECRET_KEY', 'skey_test_51fl8dfabe7sqnj8th2');

$scheduler = OmiseCharge::schedule(array(
    'customer'    => 'cust_test_58e7b94d2wfmfn6p2x1',
    'card'        => 'card_test_58eeofcdwl5clmhtyf0',
    'amount'      => 100000,
    'description' => 'Membership fee'
));

$schedule = $scheduler->every(2)
                      ->days()
                      ->startDate('2017-09-17')
                      ->endDate('2018-09-17')
                      ->start();

const omise = require('omise')({
  secretKey: 'skey_test_no1t4tnemucod0e51mo',
});

const schedule = await omise.schedules.create({
  every: 2,
  period: 'day',
  start_date: '2025-05-01',
  end_date: '2026-05-01',
  charge: {
    customer: 'cust_test_no1t4tnemucod0e51mo',
    card: 'card_test_no1t4tnemucod0e51mo',
    amount: 100000,
    description: 'Membership fee',
  },
});
console.log(schedule);

require "omise"

Omise.secret_api_key = "skey_test_4xs8breq3htbkj03d2x"

scheduler = Omise::Charge.schedule({
  customer:    "cust_test_57m2wcnfx96k634rkqq",
  card:        "card_test_57m2w8iemdovs4f92m2",
  amount:      100000,
  description: "Membership fee"
})

schedule = scheduler.every(2).days
  .start_date("2017-05-01")
  .end_date("2018-05-01")
  .start

var schedule = await Client.Schedules.Create(new CreateScheduleRequest
{
    Every = 2,
    Period = SchedulePeriod.Day,
    StartDate = DateTime.Now,
    EndDate = DateTime.Now.AddYears(2),
    On = new ScheduleOnRequest
    {
        Weekdays = new[] { Weekdays.Monday }
    },
    Charge = new ChargeScheduling
    {
        Amount = 2000,
        Currency = "thb",
        Customer = "cust_test_59gbtlbjldnc8651pmp",
    }
});

Console.WriteLine($"created schedule: {schedule.Id}");

Schedule schedule = client.schedules()
  .create(new Schedule.Create()
    .every(2)
    .period(SchedulePeriod.day)
    .startDate(new DateTime(DateTime.parse("2017-05-01")))
    .endDate(new DateTime(DateTime.parse("2018-05-01")))
    .charge(new ChargeScheduling.Params()
      .customer("cust_test_57m2wcnfx96k634rkqq")
      .card("card_test_57m2w8iemdovs4f92m2")
      .amount(100000)
      .description("Membership fee")
    ));
System.out.printf("created charge schedule: %s", schedule.getId());

import omise

omise.api_secret = "skey_test_no1t4tnemucod0e51mo"

schedule = omise.Schedule.create(
    every=2,
    period="day",
    start_date="2021-05-01",
    end_date="2022-05-01",
    charge={
        "customer": "cust_test_no1t4tnemucod0e51mo",
        "card": "card_test_no1t4tnemucod0e51mo",
        "amount": 100000,
        "description": "Membership fee",
    },
)

client, _ := omise.NewClient(
	"pkey_test_no1t4tnemucod0e51mo",
	"skey_test_no1t4tnemucod0e51mo",
)

result := &omise.Schedule{}

err := client.Do(result, &operations.CreateChargeSchedule{
	Every:       2,
	Period:      schedule.PeriodDay,
	StartDate:   "2024-05-01",
	EndDate:     "2027-05-01",
	Customer:    "cust_test_no1t4tnemucod0e51mo",
	Amount:      100000,
	Description: "Membership fee",
})
if err != nil {
	log.Fatalln(err)
}
log.Println(result)

Omise.configure(secret_key: "skey_test_4xs8breq3htbkj03d2x")

Omise.Schedule.create(
  every:      2,
  period:     "day",
  start_date: "2017-05-01",
  end_date:   "2018-05-01",
  charge: [
    customer:    "cust_test_57m2wcnfx96k634rkqq",
    card:        "card_test_57m2w8iemdovs4f92m2",
    amount:      100000,
    description: "Membership fee",
  ]
)

Transfer a fixed amount every 2 days

curl
php
node.js
C#
go
elixir

curl https://api.omise.co/schedules \
  -u $OMISE_SECRET_KEY: \
  -d "every=2" \
  -d "period=day" \
  -d "start_date=2022-01-01" \
  -d "end_date=2022-12-31" \
  -d "transfer[recipient]=recp_test_5g03h1x1mbpgxp8h1fh" \
  -d "transfer[amount]=1000000"

<?php

require './omise-php/lib/Omise.php';

define('OMISE_SECRET_KEY', 'skey_test_51fl8dfabe7sqnj8th2');

$scheduler = OmiseTransfer::schedule(array(
    'recipient' => 'recp_test_586lkjci7y1h3a0uce3',
    'amount'    => 1000000
));

$schedule  = $scheduler->every(2)
                       ->days()
                       ->startDate('2017-09-17')
                       ->endDate('2018-09-17')
                       ->start();

const omise = require('omise')({
  secretKey: 'skey_test_no1t4tnemucod0e51mo',
});

const schedule = await omise.schedules.create({
  every: 2,
  period: 'day',
  start_date: '2025-05-01',
  end_date: '2026-05-01',
  charge: {
    recipent: 'recp_test_no1t4tnemucod0e51mo',
    amount: 100000,
  },
});
console.log(schedule);

var recipient = RetrieveRecipient();
var schedule = await Client.Schedules.Create(new CreateScheduleRequest
{
    Every = 2,
    Period = SchedulePeriod.Day,
    StartDate = DateTime.Now,
    EndDate = DateTime.Now.AddYears(2),
    Transfer = new TransferScheduling
    {
        Amount = 200000,
        Recipient = recipient.Id,
    }
});

Console.WriteLine($"created schedule: {schedule.Id}");

client, _ := omise.NewClient(
	"pkey_test_no1t4tnemucod0e51mo",
	"skey_test_no1t4tnemucod0e51mo",
)

result := &omise.Schedule{}

err := client.Do(result, &operations.CreateTransferSchedule{
	Every:     10,
	Period:    schedule.PeriodDay,
	StartDate: "2024-02-27",
	EndDate:   "2029-01-01",
	Recipient: "recp_test_no1t4tnemucod0e51mo",
	Amount:    1000000,
})
if err != nil {
	log.Fatalln(err)
}
log.Println(result)

Omise.configure(secret_key: "skey_test_4xs8breq3htbkj03d2x")

Omise.Schedule.create(
  every:      2,
  period:     "day",
  start_date: "2017-05-01",
  end_date:   "2018-05-01",
  transfer: [
    recipient: "recp_test_57m2wcnfx96k634rkqq",
    amount:     1000000,
  ]
)

Charge on the 1st every 3 months

curl
php
node.js
ruby
C#
java
python
go
elixir

curl https://api.omise.co/schedules \
  -u $OMISE_SECRET_KEY: \
  -d "every=3" \
  -d "period=month" \
  -d "on[days_of_month][]=1" \
  -d "start_date=2025-01-01" \
  -d "end_date=2025-12-31" \
  -d "charge[customer]=cust_test_5g0221fe8iwtayocgja" \
  -d "charge[amount]=100000" \
  -d "charge[description]=Membership fee"

<?php

require './omise-php/lib/Omise.php';

define('OMISE_SECRET_KEY', 'skey_test_51fl8dfabe7sqnj8th2');

$scheduler = OmiseCharge::schedule(array(
    'customer'    => 'cust_test_58e7b94d2wfmfn6p2x1',
    'card'        => 'card_test_58eeofcdwl5clmhtyf0',
    'amount'      => 100000,
    'description' => 'Membership fee'
));

$schedule = $scheduler->every(3)
                      ->months(array(1))
                      ->startDate('2017-09-17')
                      ->endDate('2018-09-17')
                      ->start();

const omise = require('omise')({
  secretKey: 'skey_test_no1t4tnemucod0e51mo',
});

const schedule = await omise.schedules.create({
  every: 3,
  period: 'month',
  on: {
    days_of_month: [1],
  },
  start_date: '2023-05-01',
  end_date: '2025-05-01',
  charge: {
    customer: 'cust_test_no1t4tnemucod0e51mo',
    amount: 100000,
    description: 'Membership fee',
  },
});
console.log(schedule);

require "omise"

Omise.secret_api_key = "skey_test_4xs8breq3htbkj03d2x"

scheduler = Omise::Charge.schedule({
  customer:    "cust_test_57m2wcnfx96k634rkqq",
  card:        "card_test_57m2w8iemdovs4f92m2",
  amount:      100000,
  description: "Membership fee"
})

schedule = scheduler.every(3).months(on: [1])
  .start_date("2017-05-01")
  .end_date("2018-05-01")
  .start

var schedule = await Client.Schedules.Create(new CreateScheduleRequest
{
    Every = 3,
    Period = SchedulePeriod.Month,
    StartDate = DateTime.Now,
    EndDate = DateTime.Now.AddYears(2),
    On = new ScheduleOnRequest
    {
        DaysOfMonth = new[] { 1 }
    },
    Charge = new ChargeScheduling
    {
        Amount = 2000,
        Currency = "thb",
        Customer = "cust_test_59gbtlbjldnc8651pmp",
    }
});

Console.WriteLine($"created schedule: {schedule.Id}");

Schedule schedule = client.schedules()
  .create(new Schedule.Create()
    .every(3)
    .period(SchedulePeriod.month)
    .on(new ScheduleOn.Params()
      .daysOfMonth(1))
    .startDate(new DateTime(DateTime.parse("2017-05-01")))
    .endDate(new DateTime(DateTime.parse("2018-05-01")))
    .charge(new ChargeScheduling.Params()
      .customer("cust_test_57m2wcnfx96k634rkqq")
      .amount(100000)
      .description("Membership fee")
    ));
System.out.printf("created charge schedule: %s", schedule.getId());

import omise

omise.api_secret = "skey_test_no1t4tnemucod0e51mo"

schedule = omise.Schedule.create(
    every=3,
    period="month",
    on={"days_of_month": [1]},
    start_date="2021-05-01",
    end_date="2022-05-01",
    charge={
        "customer": "cust_test_no1t4tnemucod0e51mo",
        "card": "card_test_no1t4tnemucod0e51mo",
        "amount": 100000,
        "description": "Membership fee",
    },
)

var schd omise.Schedule
create := operations.CreateChargeSchedule{
	Every:       3,
	Period:      schedule.PeriodMonth,
	DaysOfMonth: schedule.DaysOfMonth{1},
	StartDate:   "2017-05-01",
	EndDate:     "2018-05-01",
	Customer:    "cust_test_57m2wcnfx96k634rkqq",
	Amount:      100000,
	Description: "Membership fee"
}

if e := client.Do(&schd, &create); e != nil {
	log.Fatalln(e)
}

log.Println("created schedule: %#v\n", schd)

Omise.configure(secret_key: "skey_test_4xs8breq3htbkj03d2x")

Omise.Schedule.create(
  every:      3,
  period:     "month",
  on:         [days_of_month: [1]],
  start_date: "2017-05-01",
  end_date:   "2018-05-01",
  charge: [
    customer:    "cust_test_57m2wcnfx96k634rkqq",
    card:        "card_test_57m2w8iemdovs4f92m2",
    amount:      100000,
    description: "Membership fee",
  ]
)

Charge on the second Monday every month

curl
php
node.js
ruby
C#
java
python
go
elixir

curl https://api.omise.co/schedules \
  -u $OMISE_SECRET_KEY: \
  -d "every=1" \
  -d "period=month" \
  -d "on[weekday_of_month]=2nd_monday" \
  -d "start_date=2022-01-01" \
  -d "end_date=2022-12-31" \
  -d "charge[customer]=cust_test_5g0221fe8iwtayocgja" \
  -d "charge[amount]=100000" \
  -d "charge[description]=Membership fee"

<?php

require './omise-php/lib/Omise.php';

define('OMISE_SECRET_KEY', 'skey_test_51fl8dfabe7sqnj8th2');

$scheduler = OmiseCharge::schedule(array(
    'customer'    => 'cust_test_58e7b94d2wfmfn6p2x1',
    'card'        => 'card_test_58eeofcdwl5clmhtyf0',
    'amount'      => 100000,
    'description' => 'Membership fee'
));

$schedule = $scheduler->every(1)
                      ->months('2nd_monday')
                      ->startDate('2017-09-17')
                      ->endDate('2018-09-17')
                      ->start();

const omise = require('omise')({
  secretKey: 'skey_test_no1t4tnemucod0e51mo',
});

const schedule = await omise.schedules.create({
  every: 1,
  period: 'month',
  on: {
    weekday_of_month: '2nd_monday',
  },
  start_date: '2023-05-01',
  end_date: '2025-05-01',
  charge: {
    customer: 'cust_test_no1t4tnemucod0e51mo',
    amount: 100000,
    description: 'Membership fee',
  },
});
console.log(schedule);

require "omise"

Omise.secret_api_key = "skey_test_4xs8breq3htbkj03d2x"

scheduler = Omise::Charge.schedule({
  customer:    "cust_test_57m2wcnfx96k634rkqq",
  card:        "card_test_57m2w8iemdovs4f92m2",
  amount:      100000,
  description: "Membership fee"
})

schedule = scheduler.every(1).month(on: "2nd_monday")
  .start_date("2017-05-01")
  .end_date("2018-05-01")
  .start

var schedule = await Client.Schedules.Create(new CreateScheduleRequest
{
    Every = 1,
    Period = SchedulePeriod.Month,
    StartDate = DateTime.Now,
    EndDate = DateTime.Now.AddYears(2),
    On = new ScheduleOnRequest
    {
        WeekdayOfMonth = "2nd_monday"
    },
    Charge = new ChargeScheduling
    {
        Amount = 2000,
        Currency = "thb",
        Customer = "cust_test_59gbtlbjldnc8651pmp",
    }
});

Console.WriteLine($"created schedule: {schedule.Id}");

Schedule schedule = client.schedules()
  .create(new Schedule.Create()
    .every(1)
    .period(SchedulePeriod.month)
    .on(new ScheduleOn.Params()
      .weekdayOfMonth("2nd_monday"))
    .startDate(new DateTime(DateTime.parse("2017-05-01")))
    .endDate(new DateTime(DateTime.parse("2018-05-01")))
    .charge(new ChargeScheduling.Params()
      .customer("cust_test_57m2wcnfx96k634rkqq")
      .amount(100000)
      .description("Membership fee")
    ));
System.out.printf("created charge schedule: %s", schedule.getId());

import omise

omise.api_secret = "skey_test_no1t4tnemucod0e51mo"

schedule = omise.Schedule.create(
    every=1,
    period="month",
    on={"weekday_of_month": "2nd_monday"},
    start_date="2021-05-01",
    end_date="2022-05-01",
    charge={
        "customer": "cust_test_no1t4tnemucod0e51mo",
        "card": "card_test_no1t4tnemucod0e51mo",
        "amount": 100000,
        "description": "Membership fee",
    },
)

client, _ := omise.NewClient(
	"pkey_test_no1t4tnemucod0e51mo",
	"skey_test_no1t4tnemucod0e51mo",
)

result := &omise.Schedule{}

err := client.Do(result, &operations.CreateChargeSchedule{
	Every:          1,
	Period:         schedule.PeriodMonth,
	WeekdayOfMonth: "2nd_monday",
	StartDate:      "2027-05-01",
	EndDate:        "2028-05-01",
	Customer:       "cust_test_no1t4tnemucod0e51mo",
	Amount:         100000,
	Description:    "Membership fee",
})
if err != nil {
	log.Fatalln(err)
}
log.Println(result)

Omise.configure(secret_key: "skey_test_4xs8breq3htbkj03d2x")

Omise.Schedule.create(
  every:      1,
  period:     "month",
  on:         [weekday_of_month: "2nd_monday"],
  start_date: "2017-05-01",
  end_date:   "2018-05-01",
  charge: [
    customer:    "cust_test_57m2wcnfx96k634rkqq",
    card:        "card_test_57m2w8iemdovs4f92m2",
    amount:      100000,
    description: "Membership fee",
  ]
)

Transfer the whole balance on the second Monday every month

curl
php
node.js
C#
go
elixir

curl https://api.omise.co/schedules \
  -u $OMISE_SECRET_KEY: \
  -d "every=1" \
  -d "period=month" \
  -d "on[weekday_of_month]=2nd_monday" \
  -d "start_date=2022-01-01" \
  -d "end_date=2022-12-31" \
  -d "transfer[recipient]=recp_test_5g03h1x1mbpgxp8h1fh"

<?php

require './omise-php/lib/Omise.php';

define('OMISE_SECRET_KEY', 'skey_test_51fl8dfabe7sqnj8th2');

$scheduler = OmiseTransfer::schedule(array(
    'recipient' => 'recp_test_586lkjci7y1h3a0uce3'
));

$schedule  = $scheduler->every(1)
                       ->months('2nd_monday')
                       ->startDate('2017-09-17')
                       ->endDate('2018-09-17')
                       ->start();

const omise = require('omise')({
  secretKey: 'skey_test_no1t4tnemucod0e51mo',
});

const schedule = await omise.schedules.create({
  every: 1,
  period: 'month',
  on: '2nd monday',
  start_date: '2025-05-01',
  end_date: '2026-05-01',
  charge: {
    recipent: 'recp_test_no1t4tnemucod0e51mo',
    description: 'Membership fee',
  },
});
console.log(schedule);

var recipient = RetrieveRecipient();
var schedule = await Client.Schedules.Create(new CreateScheduleRequest
{
    Every = 1,
    Period = SchedulePeriod.Month,
    StartDate = DateTime.Now,
    EndDate = DateTime.Now.AddYears(2),
    On = new ScheduleOnRequest
    {
        WeekdayOfMonth = "2nd_monday"
    },
    Transfer = new TransferScheduling
    {
        Recipient = recipient.Id,
    },
});

Console.WriteLine($"created schedule: {schedule.Id}");

client, _ := omise.NewClient(
	"pkey_test_no1t4tnemucod0e51mo",
	"skey_test_no1t4tnemucod0e51mo",
)

result := &omise.Schedule{}

err := client.Do(result, &operations.CreateTransferSchedule{
	Every:          1,
	Period:         schedule.PeriodMonth,
	WeekdayOfMonth: "2nd_monday",
	StartDate:      "2027-05-01",
	EndDate:        "2028-05-01",
	Recipient:      "recp_test_no1t4tnemucod0e51mo",
})
if err != nil {
	log.Fatalln(err)
}
log.Println(result)

Omise.configure(secret_key: "skey_test_4xs8breq3htbkj03d2x")

Omise.Schedule.create(
  every:      1,
  period:     "month",
  on:         [weekday_of_month: "2nd_monday"],
  start_date: "2017-05-01",
  end_date:   "2018-05-01",
  transfer: [
    recipient: "recp_test_57m2wcnfx96k634rkqq",
  ]
)

Transfer the whole balance on the 1st every 3 months

curl
php
C#
go
elixir

curl https://api.omise.co/schedules \
  -u $OMISE_SECRET_KEY: \
  -d "every=3" \
  -d "period=month" \
  -d "on[days_of_month][]=1" \
  -d "start_date=2025-01-01" \
  -d "end_date=2026-12-31" \
  -d "transfer[recipient]=recp_test_5tm9g9o8k5qwu5qe4ql"

<?php

require './omise-php/lib/Omise.php';

define('OMISE_SECRET_KEY', 'skey_test_51fl8dfabe7sqnj8th2');

$scheduler = OmiseTransfer::schedule(array(
    'recipient' => 'recp_test_586lkjci7y1h3a0uce3'
));

$schedule  = $scheduler->every(3)
                       ->months(array(1))
                       ->startDate('2017-09-17')
                       ->endDate('2018-09-17')
                       ->start();

var recipient = RetrieveRecipient();
var schedule = await Client.Schedules.Create(new CreateScheduleRequest
{
    Every = 3,
    Period = SchedulePeriod.Month,
    StartDate = DateTime.Now,
    EndDate = DateTime.Now.AddYears(2),
    On = new ScheduleOnRequest
    {
        DaysOfMonth = new[] { 1 }
    },
    Transfer = new TransferScheduling
    {
        Recipient = recipient.Id,
    }
});

Console.WriteLine($"created schedule: {schedule.Id}");

client, _ := omise.NewClient(
	"pkey_test_no1t4tnemucod0e51mo",
	"skey_test_no1t4tnemucod0e51mo",
)

result := &omise.Schedule{}

err := client.Do(result, &operations.CreateTransferSchedule{
	Every:       3,
	Period:      schedule.PeriodMonth,
	DaysOfMonth: schedule.DaysOfMonth{1},
	StartDate:   "2027-05-01",
	EndDate:     "2028-05-01",
	Recipient:   "recp_test_no1t4tnemucod0e51mo",
})
if err != nil {
	log.Fatalln(err)
}
log.Println(result)

Omise.configure(secret_key: "skey_test_4xs8breq3htbkj03d2x")

Omise.Schedule.create(
  every:      3,
  period:     "month",
  on:         [days_of_month: [1],
  start_date: "2017-05-01",
  end_date:   "2018-05-01",
  transfer: [
    recipient: "recp_test_57m2wcnfx96k634rkqq",
  ]
)

Charge every Monday and Friday

curl
php
node.js
ruby
C#
java
python
go
elixir

curl https://api.omise.co/schedules \
  -u $OMISE_SECRET_KEY: \
  -d "every=1" \
  -d "period=week" \
  -d "on[weekdays][]=monday" \
  -d "on[weekdays][]=friday" \
  -d "start_date=2025-01-01" \
  -d "end_date=2025-12-31" \
  -d "charge[customer]=cust_test_5g0221fe8iwtayocgja" \
  -d "charge[amount]=100000" \
  -d "charge[description]=Membership fee"

<?php

require './omise-php/lib/Omise.php';

define('OMISE_SECRET_KEY', 'skey_test_51fl8dfabe7sqnj8th2');

$scheduler = OmiseCharge::schedule(array(
    'customer'    => 'cust_test_58e7b94d2wfmfn6p2x1',
    'card'        => 'card_test_58eeofcdwl5clmhtyf0',
    'amount'      => 100000,
    'description' => 'Membership fee'
));

$schedule = $scheduler->every(1)
                      ->weeks(array('monday', 'friday'))
                      ->startDate('2017-09-17')
                      ->endDate('2018-09-17')
                      ->start();

const omise = require('omise')({
  secretKey: 'skey_test_no1t4tnemucod0e51mo',
});

const schedule = await omise.schedules.create({
  every: 1,
  period: 'week',
  on: {
    weekdays: ['monday', 'friday'],
  },
  start_date: '2023-05-01',
  end_date: '2025-04-01',
  charge: {
    customer: 'cust_test_no1t4tnemucod0e51mo',
    amount: 100000,
    description: 'Membership fee',
  },
});
console.log(schedule);

require "omise"

Omise.secret_api_key = "skey_test_4xs8breq3htbkj03d2x"

scheduler = Omise::Charge.schedule({
  customer:    "cust_test_57m2wcnfx96k634rkqq",
  card:        "card_test_57m2w8iemdovs4f92m2",
  amount:      100000,
  description: "Membership fee"
})

schedule = scheduler.every(1).week(on: ["monday", "friday"])
  .start_date("2017-05-01")
  .end_date("2018-05-01")
  .start

var schedule = await Client.Schedules.Create(new CreateScheduleRequest
{
    Every = 1,
    Period = SchedulePeriod.Week,
    StartDate = DateTime.Now,
    EndDate = DateTime.Now.AddYears(2),
    On = new ScheduleOnRequest
    {
        Weekdays = new[] { Weekdays.Monday, Weekdays.Friday }
    },
    Charge = new ChargeScheduling
    {
        Amount = 2000,
        Currency = "thb",
        Customer = "cust_test_59gbtlbjldnc8651pmp",
    }
});

Console.WriteLine($"created schedule: {schedule.Id}");

Schedule schedule = client.schedules()
  .create(new Schedule.Create()
    .every(1)
    .period(SchedulePeriod.week)
    .on(new ScheduleOn.Params()
      .weekdays(Weekdays.Monday, Weekdays.Friday))
    .startDate(new DateTime(DateTime.parse("2017-05-01")))
    .endDate(new DateTime(DateTime.parse("2018-04-01")))
    .charge(new ChargeScheduling.Params()
      .customer("cust_test_57m2wcnfx96k634rkqq")
      .amount(100000)
      .description("Membership fee")
    ));
System.out.printf("created charge schedule: %s", schedule.getId());

import omise

omise.api_secret = "skey_test_no1t4tnemucod0e51mo"

schedule = omise.Schedule.create(
    every=1,
    period="week",
    on={"weekdays": ["monday", "friday"]},
    start_date="2021-05-01",
    end_date="2022-05-01",
    charge={
        "customer": "cust_test_no1t4tnemucod0e51mo",
        "card": "card_test_no1t4tnemucod0e51mo",
        "amount": 100000,
        "description": "Membership fee",
    },
)

client, _ := omise.NewClient(
	"pkey_test_no1t4tnemucod0e51mo",
	"skey_test_no1t4tnemucod0e51mo",
)

result := &omise.Schedule{}

err := client.Do(result, &operations.CreateChargeSchedule{
	Every:  1,
	Period: schedule.PeriodWeek,
	Weekdays: schedule.Weekdays{
		schedule.Monday,
		schedule.Friday,
	},
	StartDate:   "2027-05-01",
	EndDate:     "2028-05-01",
	Customer:    "cust_test_no1t4tnemucod0e51mo",
	Amount:      100000,
	Description: "Membership fee",
})
if err != nil {
	log.Fatalln(err)
}
log.Println(result)

Omise.configure(secret_key: "skey_test_4xs8breq3htbkj03d2x")

Omise.Schedule.create(
  every:      1,
  period:     "week",
  on:         [weekdays: ["monday", "friday"]],
  start_date: "2017-05-01",
  end_date:   "2018-05-01",
  charge: [
    customer:    "cust_test_57m2wcnfx96k634rkqq",
    card:        "card_test_57m2w8iemdovs4f92m2",
    amount:      100000,
    description: "Membership fee",
  ]
)

Transfer a percentage of the balance every Monday and Friday

curl
php
node.js
C#
go
elixir

curl https://api.omise.co/schedules \
  -u $OMISE_SECRET_KEY: \
  -d "every=1" \
  -d "period=week" \
  -d "on[weekdays][]=monday" \
  -d "on[weekdays][]=friday" \
  -d "start_date=2025-01-01" \
  -d "end_date=2025-12-31" \
  -d "transfer[recipient]=rrecp_test_5tm9g9o8k5qwu5qe4ql" \
  -d "transfer[percentage_of_balance]=75"

<?php

require './omise-php/lib/Omise.php';

define('OMISE_SECRET_KEY', 'skey_test_51fl8dfabe7sqnj8th2');

$scheduler = OmiseTransfer::schedule(array(
    'recipient'             => 'recp_test_586lkjci7y1h3a0uce3',
    'percentage_of_balance' => 75
));

$schedule  = $scheduler->every(1)
                       ->weeks(array('monday', 'friday'))
                       ->startDate('2017-09-17')
                       ->endDate('2018-09-17')
                       ->start();

const omise = require('omise')({
  secretKey: 'skey_test_no1t4tnemucod0e51mo',
});

const schedule = await omise.schedules.create({
  every: 1,
  period: 'week',
  on: {
    weekdays: ['monday', 'friday'],
  },
  start_date: '2025-05-01',
  end_date: '2026-05-01',
  charge: {
    recipient: 'recp_test_no1t4tnemucod0e51mo',
    transfer: 75,
    description: 'Membership fee',
  },
});
console.log(schedule);

var recipient = RetrieveRecipient();
var schedule = await Client.Schedules.Create(new CreateScheduleRequest
{
    Every = 1,
    Period = SchedulePeriod.Week,
    StartDate = DateTime.Now,
    EndDate = DateTime.Now.AddYears(2),
    On = new ScheduleOnRequest
    {
        Weekdays = new[] { Weekdays.Monday, Weekdays.Friday }
    },
    Transfer = new TransferScheduling
    {
        PercentageOfBalance = 75.0f,
        Recipient = recipient.Id,
    }
});

Console.WriteLine($"created schedule: {schedule.Id}");

var schd omise.Schedule
create = operations.CreateTransferSchedule{
	Every:  1,
	Period: schedule.PeriodWeek,
	Weekdays: schedule.Weekdays{
		schedule.Monday,
		schedule.Friday,
	},
	StartDate: "2017-05-01",
	EndDate:   "2018-04-01",

	Recipient:           "recp_test_57m2wcnfx96k634rkqq",
	PercentageOfBalance: 75,
}

if e := client.Do(&schd, &create); e != nil {
	panic(e)
}

fmt.Println("Create a weekly partial transfer schedule:", schd.ID)

Omise.configure(secret_key: "skey_test_4xs8breq3htbkj03d2x")

Omise.Schedule.create(
  every:      1,
  period:     "week",
  on:         [weekdays: ["monday", "friday"]],
  start_date: "2017-05-01",
  end_date:   "2018-05-01",
  transfer: [
    recipient: "recp_test_57m2wcnfx96k634rkqq",
    percentage_of_balance: 75,
  ]
)

Destroy a schedule

- DELETE https://api.omise.co/schedules/{id}

Destroys the schedule matching :id.

Example

Destroy a schedule

curl
php
node.js
ruby
C#
python
go
elixir

curl https://api.omise.co/schedules/schd_test_5g022yhk1zcvkf7zbt7 \
  -X DELETE \
  -u $OMISE_SECRET_KEY:

<?php

require './omise-php/lib/Omise.php';

define('OMISE_SECRET_KEY', 'skey_test_51fl8dfabe7sqnj8th2');

$schedule = OmiseSchedule::retrieve('schd_test_58et0oz1hmczg8foppb');
$schedule->destroy();

const omise = require('omise')({
  secretKey: 'skey_test_no1t4tnemucod0e51mo',
});

const schedule = await omise.schedules.destroy('schd_test_no1t4tnemucod0e51mo');
console.log(schedule);

require "omise"

Omise.secret_api_key = "skey_test_4xs8breq3htbkj03d2x"

schedule = Omise::Schedule.retrieve("schd_test_4xsjvylia03ur542vn6")
schedule.destroy
schedule.destroyed? # => true

var schedule = RetrieveSchedule();
schedule = await Client.Schedules.Destroy(schedule.Id);
Console.WriteLine($"disabled schedule: {schedule.Id} ({schedule.Deleted})");

import omise

omise.api_secret = "skey_test_no1t4tnemucod0e51mo"

schedule = omise.Schedule.retrieve("schd_test_no1t4tnemucod0e51mo")

schedule.destroy()

schedule.destroyed  # => true

client, _ := omise.NewClient(
	"pkey_test_no1t4tnemucod0e51mo",
	"skey_test_no1t4tnemucod0e51mo",
)

result := &omise.Schedule{}

err := client.Do(result, &operations.DestroySchedule{ScheduleID: "schd_test_no1t4tnemucod0e51mo"})
if err != nil {
	log.Fatalln(err)
}
log.Println(result)

Omise.configure(secret_key: "skey_test_4xs8breq3htbkj03d2x")

Omise.Schedule.destroy("schd_test_4xsjvylia03ur542vn6")

List schedules

- GET https://api.omise.co/schedules

Returns a list of charge and transfer schedules belonging to your account.

Request Parameters

Name	Type	Description
from	string	(optional, default: `1970-01-01T00:00:00Z`) Earliest UTC datetime for returned records in ISO 8601 format (`YYYY-MM-DDThh:mm:ssZ`).
limit	integer	(optional, default: `20`) Number of records returned.
offset	integer	(optional, default: `0`) Offset of the first record returned (i.e. how many records to skip from the beginning).
order	string	(optional, default: `chronological`, one of: `chronological`, `reverse_chronological`) Order of records returned.
to	string	(optional) Latest UTC datetime for returned records in ISO 8601 format (`YYYY-MM-DDThh:mm:ssZ`).

Example

List all schedules

curl
php
node.js
ruby
C#
python
go
elixir

curl https://api.omise.co/schedules \
  -u $OMISE_SECRET_KEY:

<?php

require './omise-php/lib/Omise.php';

define('OMISE_SECRET_KEY', 'skey_test_51fl8dfabe7sqnj8th2');

$schedules = OmiseSchedule::retrieve();

const omise = require('omise')({
  secretKey: 'skey_test_no1t4tnemucod0e51mo',
});

const schedule = await omise.schedules.retrieve();
console.log(schedule);

require "omise"

Omise.secret_api_key = "skey_test_4xs8breq3htbkj03d2x"

schedules = Omise::Schedule.list

var schedules = await Client.Schedules.GetList(order: Ordering.ReverseChronological);
Console.WriteLine($"total schedules: {schedules.Total}");

import omise

omise.api_secret = "skey_test_no1t4tnemucod0e51mo"

schedule = omise.Schedule.retrieve()

client, _ := omise.NewClient(
	"pkey_test_no1t4tnemucod0e51mo",
	"skey_test_no1t4tnemucod0e51mo",
)

result := &omise.ScheduleList{}

err := client.Do(result, &operations.ListSchedules{
	List: operations.List{
		Limit: 100,
		From:  time.Now().Add(-1 * time.Hour),
	},
})
if err != nil {
	log.Fatalln(err)
}
log.Println(result)

Omise.configure(secret_key: "skey_test_4xs8breq3htbkj03d2x")

Omise.Schedule.list

List charge schedules for customer

- GET https://api.omise.co/customers/{id}/schedules

Returns a list of schedules belonging to customer matching :id.

Request Parameters

Name	Type	Description
from	string	(optional, default: `1970-01-01T00:00:00Z`) Earliest UTC datetime for returned records in ISO 8601 format (`YYYY-MM-DDThh:mm:ssZ`).
limit	integer	(optional, default: `20`) Number of records returned.
offset	integer	(optional, default: `0`) Offset of the first record returned (i.e. how many records to skip from the beginning).
order	string	(optional, default: `chronological`, one of: `chronological`, `reverse_chronological`) Order of records returned.
to	string	(optional) Latest UTC datetime for returned records in ISO 8601 format (`YYYY-MM-DDThh:mm:ssZ`).

Example

List all charge schedules for a customer

curl
php
node.js
ruby
C#
python
go
elixir

curl https://api.omise.co/customers/cust_test_5g0221fe8iwtayocgja/schedules \
  -u $OMISE_SECRET_KEY:

<?php

require './omise-php/lib/Omise.php';

define('OMISE_SECRET_KEY', 'skey_test_51fl8dfabe7sqnj8th2');

$customer  = OmiseCustomer::retrieve('cust_test_58e7b94d2wfmfn6p2x1');
$schedules = $customer->schedules();

const omise = require('omise')({
  secretKey: 'skey_test_no1t4tnemucod0e51mo',
});

const schedule = await omise.customers.schedules('cust_test_no1t4tnemucod0e51mo');
console.log(schedule);

require "omise"

Omise.secret_api_key = "skey_test_4xs8breq3htbkj03d2x"

customer  = Omise::Customer.retrieve("cust_test_4xtrb759599jsxlhkrb")
schedules = customer.schedules

var customerId = "cust_test_59gbtlbjldnc8651pmp";
var schedules = await Client
    .Customer(customerId)
    .Schedules
    .GetList(order: Ordering.ReverseChronological);

Console.WriteLine($"total schedule for customer: {schedules.Total}");

import omise

omise.api_secret = "skey_test_no1t4tnemucod0e51mo"

customer = omise.Customer.retrieve("cust_test_no1t4tnemucod0e51mo")

schedule = customer.schedule()

client, _ := omise.NewClient(
	"pkey_test_no1t4tnemucod0e51mo",
	"skey_test_no1t4tnemucod0e51mo",
)

result := &omise.ScheduleList{}

err := client.Do(result, &operations.ListCustomerChargeSchedules{
	CustomerID: "cust_test_no1t4tnemucod0e51mo",
	List: operations.List{
		Limit: 100,
		From:  time.Now().Add(-1 * time.Hour),
	}
	if err != nil {
		log.Fatalln(err)
	}
	log.Println(result)

Omise.configure(secret_key: "skey_test_4xs8breq3htbkj03d2x")

Omise.Customer.list_schedules("cust_test_4xtrb759599jsxlhkrb")

List transfer schedules for recipient

- GET https://api.omise.co/recipients/{id}/schedules

Returns a list of transfer schedules belonging to recipient matching :id.

Request Parameters

Name	Type	Description
from	string	(optional, default: `1970-01-01T00:00:00Z`) Earliest UTC datetime for returned records in ISO 8601 format (`YYYY-MM-DDThh:mm:ssZ`).
limit	integer	(optional, default: `20`) Number of records returned.
offset	integer	(optional, default: `0`) Offset of the first record returned (i.e. how many records to skip from the beginning).
order	string	(optional, default: `chronological`, one of: `chronological`, `reverse_chronological`) Order of records returned.
to	string	(optional) Latest UTC datetime for returned records in ISO 8601 format (`YYYY-MM-DDThh:mm:ssZ`).

Example

List all transfer schedules for recipient

curl
php
node.js
C#
go
elixir

curl https://api.omise.co/recipients/recp_test_5g03h1x1mbpgxp8h1fhchedules \
  -u $OMISE_SECRET_KEY:

<?php

require './omise-php/lib/Omise.php';

define('OMISE_SECRET_KEY', 'skey_test_51fl8dfabe7sqnj8th2');

$recipient = OmiseRecipient::retrieve('recp_test_546s722se0adnqfenew');
$schedules = $recipient->schedules();

const omise = require('omise')({
  secretKey: 'skey_test_no1t4tnemucod0e51mo',
});

const schedule = await omise.recipients.schedules('recp_test_no1t4tnemucod0e51mo');
console.log(schedule);

var recipientId = "recp_test_58fkcajowtvy3pax0ak";
var schedules = await Client
    .Recipient(recipientId)
    .Schedules
    .GetList(order: Ordering.ReverseChronological);

Console.WriteLine($"transfer schedule for recipients: {schedules.Total}");

client, _ := omise.NewClient(
	"pkey_test_no1t4tnemucod0e51mo",
	"skey_test_no1t4tnemucod0e51mo",
)

result := &omise.ScheduleList{}

err := client.Do(result, &operations.ListRecipientTransferSchedules{
	RecipientID: "recp_test_no1t4tnemucod0e51mo",
	List: operations.List{
		Limit: 100,
		From:  time.Now().Add(-1 * time.Hour),
	},
})
if err != nil {
	log.Fatalln(err)
}
log.Println(result)

Omise.configure(secret_key: "skey_test_4xs8breq3htbkj03d2x")

Omise.Recipient.list_schedules("recp_test_4xsj4ndi9w22nod68")

Retrieve a schedule

- GET https://api.omise.co/schedules/{id}

Returns the schedule matching :id.

Example

Retrieve a schedule

curl
php
node.js
ruby
C#
python
go
elixir

curl https://api.omise.co/schedules/schd_test_5g022yhk1zcvkf7zbt7 \
  -u $OMISE_SECRET_KEY:

<?php

require './omise-php/lib/Omise.php';

define('OMISE_SECRET_KEY', 'skey_test_51fl8dfabe7sqnj8th2');

$schedule = OmiseSchedule::retrieve('schd_test_58et0oz1hmczg8foppb');

const omise = require('omise')({
  secretKey: 'skey_test_no1t4tnemucod0e51mo',
});

const schedule = await omise.schedules.retrieve('schd_test_no1t4tnemucod0e51mo');
console.log(schedule);

require "omise"

Omise.secret_api_key = "skey_test_4xs8breq3htbkj03d2x"

schedule = Omise::Schedule.retrieve("schd_test_4xsjvylia03ur542vn6")

var scheduleId = "schd_test_58fmj4fpu2zpp2m8s8c";
var schedule = await Client.Schedules.Get(scheduleId);
Console.WriteLine($"charges made on schedule: {schedule.Occurrences.Total}");

import omise

omise.api_secret = "skey_test_no1t4tnemucod0e51mo"

schedule = omise.Schedule.retrieve("schd_test_no1t4tnemucod0e51mo")

client, _ := omise.NewClient(
	"pkey_test_no1t4tnemucod0e51mo",
	"skey_test_no1t4tnemucod0e51mo",
)

result := &omise.Schedule{}

err := client.Do(result, &operations.RetrieveSchedule{ScheduleID: "no1t4tnemucod0e51mo"})
if err != nil {
	log.Fatalln(err)
}
log.Println(result)

Omise.configure(secret_key: "skey_test_4xs8breq3htbkj03d2x")

Omise.Schedule.retrieve("schd_test_4xsjvylia03ur542vn6")