Update specific subscription. Change plan, status, items etc.

Request Params

AttributeTypeDescription
idtextSubscription Id - A globally-unique identifier of subscription
customerobjectObject containing details of the customer associated with the subscription. See Customer - Object
statusobjectObject containing status of the subscription with the additional info. See Subscription Status - Object
planobjectObject containing details of the plan associated with the subscription. See Plan - Object
originOrderobjectObject containing order payload. The same payload will be used to create renewal orders. See Order - Object
shipping_addressobjectObject containing shipping address of the subscription. See Shipping - Object
billing_addressobjectObject containing billing address of the subscription. See Billing - Object
transactionobjectObject containing transaction details of the subscription. See Transaction - Object
renewalobjectObject containing renewal details of the subscription. See Renewal - Object
ordersobjectAll orders of the subscription. See Order - Object
subscribed_atdatetimeDate and time when subscription was created.

Subscription Status Object

AttributeTypeDescription
stateenumSubscription state. It can be either active, halted, paused, trial, cancelled.
cancellationobjectObject containing details of cancellation. See Cancellation - Object

Cancellation Object

AttributeTypeDescription
cancelled_reasonstringReason of the subscription cancellation.

Renewal Object

AttributeTypeDescription
last_renewaldatetimeDate and time of the last renewal of subscription
next_renewaldatetimeDate and time of the next renewal of subscription
pending_renewalintegerCount of the remaining renewals, applicable only for prepaid subscriptions.

Origin Order Object

AttributeTypeDescription
line_itemsobjectA list of line item objects, each containing information about an item in the subscription. See Line Items - Object
note_attributesobjectAttributes to pass additional information in order. See Note attributes - Object
notestringAdditional note which can be passed as an order note.

Line Items

AttributeTypeDescription
variant_idstringVariant id of the line item.
quantityintegerQuantity of the line item.
propertiesobjectAdditional information which needs to be passed along with the line item on order. See Properties - Object

Properties

You can capture line item properties to collect customization information for products, such as engraving text, color etc.

Eg: [{"name":"Custom Engraving","value":"Recurpay"}]

AttributeTypeDescription
namestringKey name that needs to be passed as an additional info for specific line item.
valuestringValue of the additional key being passed on the line item.

Note Attributes

Extra information that is added to the order. Each array entry must contain a hash with name and value keys.

Eg: [{"name":"colour","value":"red"}]

AttributeTypeDescription
namestringKey name that needs to be passed as an additional info in order.
valuestringValue of the additional key being passed in the order.
Language
Authorization
Basic
base64
:
Click Try It! to start a request and see the response here!