API Version
Product Catalog
Library

Payment schedules for an invoice refer to a payment structure where the amount_due on an invoice is divided into smaller, more manageable parts, each of which is paid over a specified period.

Sample payment schedule [ JSON ]

{ "entity_type": "invoice", "scheme_id": "__dev__3Nl7O2OURL9Ph52C", "created_at": 1713242812, "id": "__dev__3Nl7O2OURL9Suc2r", "entity_id": "1", "schedule_entries": [ { "date": 1713242812, "amount": 150000, "id": "__dev__3Nl7O2OURL9Sui2s", "status": "paid", "object": "schedule_entry" }, { "date": 1713502012, "amount": 150000, "id": "__dev__3Nl7O2OURL9Suk2t", "status": "posted", "object": "schedule_entry" }, { "date": 1713761212, "amount": 150000, "id": "__dev__3Nl7O2OURL9Suk2u", "status": "posted", "object": "schedule_entry" } ], "object": "payment_schedule" }

API Index URL

https://{site}.chargebee.com/api/v2/payment_schedules

Model Class

id
string, max chars=40

An auto-generated unique identifier for the payment schedule.


scheme_id
string, max chars=40

The identifier of the payment_schedule_scheme , used to create the payment schedules.


entity_type
enumerated string

Specifies the types of entity this payment schedule is based on.


Possible values are
invoice

Indicates the invoice entity type

Show all values[+]
entity_id
string, max chars=50

The identifier of the entity this payment schedule is based on.


amount
optional, in cents, min=0

The part of the invoice.amount_due to be distributed across the payment schedules. If not specified, the entire invoice.amount_due is considered by default.


created_at
timestamp(UTC) in seconds

The timestamp at which the payment_schedule was created.


resource_version
optional, long

Version number of this resource. The resource_version is updated with a new timestamp in milliseconds for every change made to the resource. This attribute will be present only if the resource has been updated after 2016-09-28.


updated_at
optional, timestamp(UTC) in seconds

Specifies when these payment schedules are updated recently.


currency_code
optional, string, max chars=3

The currency code (ISO 4217 format) of the transaction amount.


schedule_entries
Show attributes [+]
optional, list of schedule_entry

List of schedule entries

id id
string, max chars=40

An auto-generated unique identifier for the payment schedule.


scheme_id scheme_id
string, max chars=40

The identifier of the payment_schedule_scheme , used to create the payment schedules.


entity_type entity_type
enumerated string

Specifies the types of entity this payment schedule is based on.


Possible values are
invoice

Indicates the invoice entity type

Show all values[+]
entity_id entity_id
string, max chars=50

The identifier of the entity this payment schedule is based on.


amount amount
optional, in cents, min=0

The part of the invoice.amount_due to be distributed across the payment schedules. If not specified, the entire invoice.amount_due is considered by default.


created_at created_at
timestamp(UTC) in seconds

The timestamp at which the payment_schedule was created.


resource_version resource_version
optional, long

Version number of this resource. The resource_version is updated with a new timestamp in milliseconds for every change made to the resource. This attribute will be present only if the resource has been updated after 2016-09-28.


updated_at updated_at
optional, timestamp(UTC) in seconds

Specifies when these payment schedules are updated recently.


currency_code currency_code
optional, string, max chars=3

The currency code (ISO 4217 format) of the transaction amount.


schedule_entries
optional, list of schedule_entry

List of schedule entries