Adding One-Time (à la Carte) Items on Subscriptions

operators can add one time or à la carte items to customer subscriptions these items can either be added to your next installment order along with your subscribed items or can replace the subscribed items in your next installment order in both cases, these items will automatically be removed afterwards this is useful if, for example, you want to add free items to a customer’s upcoming subscription renewal or can be used to allow for customers to deviate from their regularly scheduled programming briefly to try a new line item the options are outlined below via chord oms including line items to add as an admin user, you can add and edit one time items when viewing a customer's subscription page in the line items section scroll to the for next installment only section, select the variant to add, the "add" option, specify the quantity, and click update once added, the item will be present on the subscription and added to the next upcoming installment including line items to replace as an admin user, you can include items and specify which subscribed items to replace in a given subscription when viewing a customer's subscription page in the line items section scroll to the for next installment only section, select the variant(s) to include, select the "replace" option, specify which product the new lien item will replace (or as a shortcut select "all"), specify the quantity, and click update when the "replace" option is selected, the replaces option will populate with all of the current subscription line items this way, you can specifically pinpoint which particular line item the line item you are adding will replace if you are looking to replace all current subscribed line items, select "all items " via api you can also add one time add or one time replacement items via api here patch /api/users/\ user id/subscriptions/\ id an example payload would be { subscription { line items attributes \[ { subscribable id 999, quantity 1, one time true, one time replace false, replaces subscribable id null //only required when one time replace is true } ] } } relevant attributes one time will flag whether the item is a new addition one time replace will flag whether the item is a replacment item replaces subscribable id is only required when one time replace is true note the api will fail with a validation error if one time replace and one time share the same value should you have any questions or need further assistance, please do not hesitate to reach out to help\@chord co !