Update Recurring Billing

Use this API to update the recurring billing, any changes made to the cycle will only be effective at the end of the current cycle.

Headers

X-BUSINESS-API-KEY

string

required

Example:

"b286daabf9921b5a01a4621f026c111e046f8911feba212996c92159b98427d"

Path Parameters

recurring_billing_id

string

required

id value from the create recurring billing API

Body

application/json

plan_id

string

The plan ID, if plan_id is not null it will update [cycle, cycle_repeat, cycle_frequency and amount] with the values from Subscription plan. if plan_id is null you can update each field individually. When save_card is true, you disallow to set plan_id

name

string

Plan name

Maximum length: 255

description

string

The description of subscription plan

cycle

enum<string>

Billing frequency (weekly / monthly / yearly / custom)

Available options:

weekly,

monthly,

yearly,

custom

cycle_repeat

integer

It is required field when cycle is custom. New cycle will only be affective at the end of the current cycle. Min:1, Max: 999

cycle_frequency

enum<string>

It is required field when the cycle is custom. For cycle = custom, set the frequency for cycle repeat field options [day, week, month, year]

Available options:

day,

week,

month,

year

save_card

enum<string>

Only set the value “true” if you wish to save the card and charge the customer later on. More details in “Save Card” section

Available options:

true,

false

customer_email

string

customer_name

string

Maximum length: 255

start_date

string

The start date must be a date after or equal to today and Billing start date (YYYY-MM-DD) in SGT, only possible to change start date for recurring billing ID with status = scheduled or active

Example:

"2025-12-31"

redirect_url

string

URL where HitPay redirects the user after the users enters the card details and the subscription is active. Query arguments reference (subscription id) and status are sent along

reference

string

Arbitrary reference number that you can map to your internal reference number. This value cannot be edited by the customer

Maximum length: 255

amount

number

New amount, customer will be charged the new amount on the next cycle. Min: 0.01, Max 999999.99

webhook

string

Optional URL value to which HitPay will send a POST request when there is a new charge or if there is an error charging the card

send_email

enum<string>

default:false

Send the email

Available options:

true,

false

Response

200

application/json

200

id

string

Example:

"9741164c-06a1-4dd7-a649-72cca8f9603a"

business_recurring_plans_id

string

Example:

"973ee344-6737-4897-9929-edbc9d7bf433"

customer_name

string

Example:

"Paul"

customer_email

string

Example:

"[e-mail]"

name

string

Example:

"Spotify Premium"

description

string

Example:

"Spotify Monthly Subscription"

reference

string

Example:

"cust_id_123"

cycle

string

Example:

"monthly"

cycle_repeat

any

cycle_frequency

any

currency

string

Example:

"sgd"

amount

number

default:0

Example:

12.9

times_to_be_charged

integer

default:0

Example:

9

times_charged

integer

default:0

Example:

2

status

string

Example:

"active"

send_email

integer

default:0

Example:

0

save_card

integer

default:0

Example:

0

redirect_url

string

Example:

"https://newexamaple.com/completed"

payment_methods

string[]

created_at

string

Example:

"2022-09-13T21:32:00"

updated_at

string

Example:

"2022-09-13T21:32:00"

expires_at

any

url

string

Example:

"https://securecheckout.sandbox.hit-pay.com/973ee344-6737-4897-9929-edbc9d7bf433/recurring-plan/9741164c-06a1-4dd7-a649-72cca8f9603a"

webhook

string

Example:

"http://newwebhoo.site/test"