Payment schedule schemes

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. Payment schedule scheme is a configuration or set of rules for creating payment schedules. After creating a payment schedule scheme, you can use it to generate payment schedules for multiple invoices.

Sample payment schedule scheme [ JSON ]

{
    "id": "__dev__HvFwO7xUND2MBa3x",
    "number_of_schedules": 3,
    "period_unit": "month",
    "period": 1,
    "created_at": 1709371975,
    "updated_at": 1709371975,
    "resource_version": 1709371975988,
    "object": "payment_schedule_scheme"
}

API Index URL GET

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

id

string, max chars=40
An auto-generated unique identifier for the payment schedule scheme.

name

optional, string, max chars=100
The name of a payment schedule scheme.

description

optional, string, max chars=200
A brief description for this payment schedule scheme.

number_of_schedules

integer, min=1, max=52
Specifies the total number of payment schedules for the invoice. The maximum number_of_schedules varies based on the period_unit:

Day: Up to 30 schedules
Week: Up to 52 schedules
Month: Up to 12 schedules

period_unit

enumerated string
Defines the time unit for intervals between payment schedules. Possible values are: day, week, and month.

Possible values are

dayWhen the time unit for intervals between payment schedules is set as dayweekWhen the time unit for intervals between payment schedules is set as weekmonthWhen the time unit for intervals between payment schedules is set as month

period

optional, integer, min=1, max=30
The time period between the effective dates of two consecutive payment schedules, expressed in period_units. Use this parameter to have fixed intervals between payment schedules. The maximum period varies based on the period_unit:

Day: Up to 30 days
Week: Up to 6 weeks
Month: Up to 6 months

created_at

timestamp(UTC) in seconds
The timestamp at which the payment_schedule_scheme 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
Defines the timestamp when the config was last updated

id

string, max chars=40
An auto-generated unique identifier for the payment schedule scheme.

name

optional, string, max chars=100
The name of a payment schedule scheme.

description

optional, string, max chars=200
A brief description for this payment schedule scheme.

number_of_schedules

integer, min=1, max=52
Specifies the total number of payment schedules for the invoice. The maximum number_of_schedules varies based on the period_unit:

Day: Up to 30 schedules
Week: Up to 52 schedules
Month: Up to 12 schedules

period_unit

enumerated string
Defines the time unit for intervals between payment schedules. Possible values are: day, week, and month.

Possible values are

period

Day: Up to 30 days
Week: Up to 6 weeks
Month: Up to 6 months

created_at

timestamp(UTC) in seconds
The timestamp at which the payment_schedule_scheme was created.

resource_version

updated_at

optional, timestamp(UTC) in seconds
Defines the timestamp when the config was last updated

Creates a payment schedule scheme. After creating a payment schedule scheme, you can use it to generate payment schedules for multiple invoices.

Sample Request

Try in API Explorer

Only for Java

copy full code

Click to Copy

curl  https://{site}.chargebee.com/api/v2/payment_schedule_schemes \
     -u {site_api_key}:\
     -d name="Scheme2" \
     -d number_of_schedules=3 \
     -d period_unit="MONTH" \
     -d period=1

copy

Click to Copy

Create 3 payment schedules collected monthly

curl  https://{site}.chargebee.com/api/v2/payment_schedule_schemes \
     -u {site_api_key}:\
     -d name="Scheme2" \
     -d number_of_schedules=3 \
     -d period_unit="MONTH" \
     -d period=1

Sample Response [ JSON ]

{
    "payment_schedule_scheme": {
        "id": "__dev__HvFwO7xUND2MBa3x",
        "number_of_schedules": 3,
        "period_unit": "month",
        "period": 1,
        "created_at": 1709371975,
        "updated_at": 1709371975,
        "resource_version": 1709371975988,
        "object": "payment_schedule_scheme"
    }
}

URL Format POST

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

number_of_schedules[]

required, integer, min=1, max=52
Specifies the total number of payment schedules for the invoice. The maximum number_of_schedules varies based on the period_unit:

Day: Up to 30 schedules
Week: Up to 52 schedules
Month: Up to 12 schedules

period_unit[]

required, enumerated string
Defines the time unit for intervals between payment schedules. Possible values are: day, week, and month.

Possible values are

period[]

Day: Up to 30 days
Week: Up to 6 weeks
Month: Up to 6 months

name[]

required, string, max chars=100
The name of a payment schedule scheme.

flexible_schedules

Parameters for flexible_schedules. Multiple flexible_schedules can be passed by specifying unique indices.
pass parameters as flexible_schedules[<param name>][<idx:0..n>]

flexible_schedules[period][0..n]

optional, integer, min=0, max=52
The interval after which this payment schedule should be collected.

flexible_schedules[amount_percentage][0..n]

optional, bigdecimal, min=1, max=100
The percentage amount that this specific payment schedule should collect.

payment_schedule_scheme

always returned
Resource object representing payment_schedule_scheme

This endpoint retrieves an existing payment schedule.

Sample Request

Try in API Explorer

Only for Java

copy full code

Click to Copy

curl  https://{site}.chargebee.com/api/v2/payment_schedule_schemes/__dev__HvFwO7xUND2MBa3x \
     -u {site_api_key}:

copy

Click to Copy

Retrieve a payment schedule scheme

curl  https://{site}.chargebee.com/api/v2/payment_schedule_schemes/__dev__HvFwO7xUND2MBa3x \
     -u {site_api_key}:

Sample Response [ JSON ]

{
    "payment_schedule_scheme": {
        "id": "__dev__HvFwO7xUND2MBa3x",
        "number_of_schedules": 3,
        "period_unit": "month",
        "period": 1,
        "created_at": 1709371975,
        "updated_at": 1709371975,
        "resource_version": 1709371975988,
        "object": "payment_schedule_scheme"
    }
}

URL Format GET

https://{site}.chargebee.com/api/v2/payment_schedule_schemes/{payment-schedule-scheme-id}

payment_schedule_scheme

always returned
Resource object representing payment_schedule_scheme

This endpoint deletes a payment schedules created for an invoice.

Sample Request

Try in API Explorer

Only for Java

copy full code

Click to Copy

curl  https://{site}.chargebee.com/api/v2/payment_schedule_schemes/__dev__HvFwO7xUND2MBa3x/delete \
     -X POST  \
     -u {site_api_key}:

copy

Click to Copy

Delete a payment schedule scheme

curl  https://{site}.chargebee.com/api/v2/payment_schedule_schemes/__dev__HvFwO7xUND2MBa3x/delete \
     -X POST  \
     -u {site_api_key}:

Sample Response [ JSON ]

{
    "payment_schedule_scheme": {
        "id": "__dev__HvFwO7xUND2MBa3x",
        "number_of_schedules": 3,
        "period_unit": "month",
        "period": 1,
        "created_at": 1709371975,
        "updated_at": 1709371975,
        "resource_version": 1709371975988,
        "object": "payment_schedule_scheme"
    }
}

URL Format POST

https://{site}.chargebee.com/api/v2/payment_schedule_schemes/{payment-schedule-scheme-id}/delete

payment_schedule_scheme

always returned
Resource object representing payment_schedule_scheme

Sample payment schedule scheme [ JSON ]

API Index URL GET

Model Class

Payment schedule scheme attributes

Consent Fields for Payment schedule scheme

Custom Fields for Payment schedule scheme

Create a payment schedule scheme ¶

Notes

Sample Response [ JSON ]

URL Format POST

Method

Input Parameters

Filter Params

For operator usages, see the Pagination and Filtering section.

Returns

Sample admin console URL

Retrieve a payment schedule scheme ¶

Notes

Sample Response [ JSON ]

URL Format GET

Method

Input Parameters

Filter Params

For operator usages, see the Pagination and Filtering section.

Returns

Sample admin console URL

Delete a payment schedule scheme ¶

Notes

Sample Response [ JSON ]

URL Format POST

Method

Input Parameters

Filter Params

For operator usages, see the Pagination and Filtering section.

Returns

Sample admin console URL