Schedule API

Schedule API ใช้ในการสร้าง, เรียกดู และลบรายการรับชำระเงินหรือราย การโอนเงิน ที่ได้มีการตั้งค่าให้ดำเนินการแบบอัตโนมัติไว้ล่วงหน้า ตัวอย่างเช่น การรับชำระเงินค่าสมาชิกรายเดือนหรือการโอนเงินออกรายสัปดาห์

ในส่วนของการเรียกดูข้อมูลความถี่ในการดำเนินการที่ได้ตั้งค่าไว้ สามารถเรียกใช้ Occurrence API

Attribute

Name Type Description
object string

The string schedule.

id object_id

The SCHEDULE_ID 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.

charge charge_schedule
created datetime

UTC datetime of the creation of the schedule in ISO 8601 format (YYYY-MM-DDThh:mm:ssZ).

deleted boolean

Whether schedule is deleted.

end_date date

End date of schedule in ISO 8601 format.

every integer

How often the schedule runs. E.g.: Every 3 weeks.

in_words string

The schedule, in english. E.g.: Every 2 months on the 15th, Every 3 days, Every week on monday and friday.

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 on

An object specifying the schedule. "On" object.

period string

day, week or month. E.g.: Every 3 weeks.

start_date date

Start date of the schedule in ISO 8601 format.

status string

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.
  • suspended: The schedule could not be completed and was stopped.
.

transfer transfer_schedule

Example

  • Json Response

List all schedules

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

Returns a list of all schedule objects belonging to your account.

Request Parameter

Name Type Description
offset integer

(optional, default: 0) Offset of the first record returned (i.e. how many records to skip from the beginning).

limit integer

(optional, default: 20, maximum: 100) Number of records to return.

from datetime

(optional, default: 1970-01-01T00:00:00Z) Earliest UTC date and time for returned records in ISO 8601 format (YYYY-MM-DDThh:mm:ssZ).

to datetime

(optional, default: current UTC datetime) Latest UTC datetime for returned records in ISO 8601 format (YYYY-MM-DDThh:mm:ssZ).

order string

(optional, default: chronological) Order in which to return records. One of chronological (earliest to latest) or reverse_chronological (latest to earliest).

Example

  • List all schedules

Create a schedule

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

See the specific documentation page for charge schedules or transfer schedules.

Retrieve a schedule

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

Returns an existing schedule object

Example

  • Retrieve a schedule

Destroy a schedule

- DELETE https://api.omise.co/schedules/SCHEDULE_ID

Destroys and returns an existing schedule object

Example

  • Destroy a schedule