{"sections":[],"html":""},{"_uid":"d3f8beab-fa81-466c-aef3-ce2b531972a8","name":{"type":"doc","content":[{"type":"paragraph","content":[{"text":"sub_startdate","type":"text","marks":[{"type":"code"}]}]}]},"component":"parameter___item","description":{"type":"doc","content":[{"type":"paragraph","content":[{"text":"Description:","type":"text","marks":[{"type":"bold"}]},{"text":" Subscription start date. Useful if you'd like to offer a free trial period, or to force subscriptions to process on specific dates (the 1st, 15th, 18th, etc.).","type":"text"},{"type":"hard_break"},{"text":"Default:","type":"text","marks":[{"type":"bold"}]},{"text":" If this value is left empty, the subscription will start on the date of the transaction.","type":"text"},{"type":"hard_break"},{"text":"Accepts:","type":"text","marks":[{"type":"bold"}]},{"text":" You can pass through a full date in the ","type":"text"},{"text":"YYYYMMDD","type":"text","marks":[{"type":"code"}]},{"text":" format or just pass in the day of this month in the ","type":"text"},{"text":"DD","type":"text","marks":[{"type":"code"}]},{"text":" or ","type":"text"},{"text":"D","type":"text","marks":[{"type":"code"}]},{"text":" format. If you pass through a day that has already past, it will start on that day next month. For a relative date from today, you can also specify an integer followed by a single character denoting the unit of time.","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"YYYYMMDD","type":"text","marks":[{"type":"code"}]},{"text":" = Example: ","type":"text"},{"text":"20150131","type":"text","marks":[{"type":"code"}]},{"text":" = January, 31 2015.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"DD","type":"text","marks":[{"type":"code"}]},{"text":" = Example: ","type":"text"},{"text":"10","type":"text","marks":[{"type":"code"}]},{"text":" = will run on the 10th of this month or the 10th of next month if today's date is after the 10th.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"D","type":"text","marks":[{"type":"code"}]},{"text":" = Same as ","type":"text"},{"text":"DD","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"60d","type":"text","marks":[{"type":"code"}]},{"text":" = 60 days from today.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"2w","type":"text","marks":[{"type":"code"}]},{"text":" = 2 weeks from today. For date calculations, ","type":"text"},{"text":"1w","type":"text","marks":[{"type":"code"}]},{"text":" = ","type":"text"},{"text":"7d","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"1m","type":"text","marks":[{"type":"code"}]},{"text":" = 1 month from today.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"1y","type":"text","marks":[{"type":"code"}]},{"text":" = 1 year from today.","type":"text"}]},{"type":"paragraph","content":[{"text":"Notes:","type":"text","marks":[{"type":"bold"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"This is an optional field. Not indicating a “sub_startdate” would automatically assign it its default value.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Subscription start and end dates are not currently tied to a store's timezone settings. Test your start and end dates thoroughly or ","type":"text"},{"text":"contact us","type":"text","marks":[{"type":"link","attrs":{"href":"https://foxy.io/contact","uuid":null,"anchor":null,"target":"_blank","linktype":"url"}}]},{"text":" if you have questions about them.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"The day of the ","type":"text"},{"text":"sub_startdate","type":"text","marks":[{"type":"code"}]},{"text":" will generally be used for all subsequent billing attempts when used with a monthly frequency, but in cases where the date doesn't exist in a month, it will be moved ","type":"text"},{"text":"ahead","type":"text","marks":[{"type":"italic"}]},{"text":" for that month. So if you have a subscription with a start date on Jan-31, it will run on the Feb-28, Mar-31, Apr-30, and etc.","type":"text"}]}]}]}]},"_editable":""},{"_uid":"00d6ef0f-5b70-4054-b423-f5c5866e0019","name":{"type":"doc","content":[{"type":"paragraph","content":[{"text":"sub_enddate","type":"text","marks":[{"type":"code"}]}]}]},"component":"parameter___item","description":{"type":"doc","content":[{"type":"paragraph","content":[{"text":"Description:","type":"text","marks":[{"type":"bold"}]},{"text":" The date a subscription should ","type":"text"},{"text":"end","type":"text","marks":[{"type":"italic"}]},{"text":".","type":"text"},{"type":"hard_break"},{"text":"Accepts:","type":"text","marks":[{"type":"bold"}]},{"text":" ","type":"text"},{"text":"YYYYMMDD","type":"text","marks":[{"type":"code"}]},{"text":" formatted date value ","type":"text"},{"text":"in the future","type":"text","marks":[{"type":"italic"}]},{"text":". For a relative date from today, you can also specify an integer followed by a single character denoting the unit of time.","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"YYYYMMDD","type":"text","marks":[{"type":"code"}]},{"text":" = Example: ","type":"text"},{"text":"20150131","type":"text","marks":[{"type":"code"}]},{"text":" = January, 31 2015.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"60d","type":"text","marks":[{"type":"code"}]},{"text":" = 60 days from today.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"2w","type":"text","marks":[{"type":"code"}]},{"text":" = 2 weeks from today. For date calculations, ","type":"text"},{"text":"1w","type":"text","marks":[{"type":"code"}]},{"text":" = ","type":"text"},{"text":"7d","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"1m","type":"text","marks":[{"type":"code"}]},{"text":" = 1 month from today.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"1y","type":"text","marks":[{"type":"code"}]},{"text":" = 1 year from today.","type":"text"}]},{"type":"paragraph","content":[{"text":"Notes:","type":"text","marks":[{"type":"bold"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"This is an optional field. Not indicating a “sub_enddate” would make the subscription run indefinitely.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"If a subscription is scheduled to run on the 4th, and the ","type":"text"},{"text":"sub_enddate","type":"text","marks":[{"type":"code"}]},{"text":" is the 4th, the subscription will end before it is billed to the customer. So, this parameter should be set to a date ","type":"text"},{"text":"after","type":"text","marks":[{"type":"italic"}]},{"text":" the date you want the last transaction in the subscription to run. For example, if you have a monthly subscription starting on January 1st, 2015 that is supposed to run for six months and then stop, set ","type":"text"},{"text":"sub_endate","type":"text","marks":[{"type":"code"}]},{"text":" to 20150602 (June 2nd, 2015) so that the transaction on June 1st is not cancelled by the end date.","type":"text"}]}]}]}]},"_editable":""},{"_uid":"5d453910-bc4d-4616-af43-268f75b9aec7","name":{"type":"doc","content":[{"type":"paragraph","content":[{"text":"sub_token","type":"text","marks":[{"type":"code"}]}]}]},"component":"parameter___item","description":{"type":"doc","content":[{"type":"paragraph","content":[{"text":"Description:","type":"text","marks":[{"type":"bold"}]},{"text":" Unique URL per subscription for loading your subscription up into a cart and modifying its contents. Very useful when used in conjunction with the ","type":"text"},{"text":"redirect","type":"text","marks":[{"type":"code"}]},{"text":" feature as you can load up a customer's subscription and then redirect them back to your product page so they can add something to it.","type":"text"},{"type":"hard_break"},{"text":"Accepts:","type":"text","marks":[{"type":"bold"}]},{"text":" A valid ","type":"text"},{"text":"sub_token","type":"text","marks":[{"type":"code"}]},{"text":" (retrieved from the API, XML datafeeds, or admin).","type":"text"},{"type":"hard_break"},{"text":"Notes:","type":"text","marks":[{"type":"bold"}]},{"text":" When a ","type":"text"},{"text":"sub_token","type":"text","marks":[{"type":"code"}]},{"text":" is loaded by the customer, the customer's cart is ","type":"text"},{"text":"emptied and replaced","type":"text","marks":[{"type":"italic"}]},{"text":" by the content of the subscription represented by the ","type":"text"},{"text":"sub_token","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]}]},"_editable":""},{"_uid":"1f9c53d0-5dd5-4a54-8cc0-f9de50decd1e","name":{"type":"doc","content":[{"type":"paragraph","content":[{"text":"sub_cancel","type":"text","marks":[{"type":"code"}]}]}]},"component":"parameter___item","description":{"type":"doc","content":[{"type":"paragraph","content":[{"text":"Description:","type":"text","marks":[{"type":"bold"}]},{"text":" A flag indicating the subscription in question (as retrieved from the ","type":"text"},{"text":"sub_token","type":"text","marks":[{"type":"code"}]},{"text":") should be cancelled. By “canceling”, the subscription gets a ","type":"text"},{"text":"sub_enddate","type":"text","marks":[{"type":"code"}]},{"text":" set, on which day it will be ended and made inactive.","type":"text"},{"type":"hard_break"},{"text":"Accepts:","type":"text","marks":[{"type":"bold"}]},{"text":" ","type":"text"},{"text":"true","type":"text","marks":[{"type":"code"}]},{"text":" to set the end date to tomorrow, or ","type":"text"},{"text":"next_transaction_date","type":"text","marks":[{"type":"code"}]},{"text":" to set the end date to the subscriptions next transaction date.","type":"text"},{"type":"hard_break"},{"text":"Notes:","type":"text","marks":[{"type":"bold"}]}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Requires a ","type":"text","marks":[{"type":"textStyle","attrs":{"color":"inherit"}}]},{"text":"sub_token","type":"text","marks":[{"type":"code"}]},{"text":" to function. Otherwise there will not be any subscription to cancel.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Foxy native email receipts will include links for the customer to be able to update or cancel their subscription. The cancel link will by default be set to ","type":"text"},{"text":"sub_cancel=true","type":"text","marks":[{"type":"code"}]},{"text":", so the subscription will end the following day. If you want to instead default these links to cancel on the next transaction date, you can edit the language strings for your store. On the “language” page of the Foxy administration, expand the “email” section and search for “sub_cancel=true”. There will be two instances of it - simply update ","type":"text"},{"text":"true","type":"text","marks":[{"type":"code"}]},{"text":" to ","type":"text"},{"text":"next_transaction_date","type":"text","marks":[{"type":"code"}]},{"text":" to change the links.","type":"text"}]}]}]}]},"_editable":""},{"_uid":"8ecfff96-83d4-4e11-949f-95bb375016fd","name":{"type":"doc","content":[{"type":"paragraph","content":[{"text":"sub_restart","type":"text","marks":[{"type":"code"}]}]}]},"component":"parameter___item","description":{"type":"doc","content":[{"type":"paragraph","content":[{"type":"hard_break","marks":[{"type":"bold"}]},{"text":"Description:","type":"text","marks":[{"type":"bold"}]},{"text":" A flag that makes the subscription products payable “now”, when used with a ","type":"text"},{"text":"sub_token","type":"text","marks":[{"type":"code"}]},{"text":" URL. This can (and generally ","type":"text"},{"text":"should","type":"text","marks":[{"type":"italic"}]},{"text":") be used instead of relying on past-due amounts.","type":"text"},{"type":"hard_break"},{"text":"Accepts:","type":"text","marks":[{"type":"bold"}]}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"true","type":"text","marks":[{"type":"code"}]},{"text":": Collect payment “right now”.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"auto","type":"text","marks":[{"type":"code"}]},{"text":": Collect payment “right now” if and only if the subscription's past-due amount is greater than 0. Adding ","type":"text"},{"text":"sub_restart=auto","type":"text","marks":[{"type":"code"}]},{"text":" will eventually be the default Foxy behavior for updating subscriptions.","type":"text"}]},{"type":"paragraph","content":[{"text":"Notes:","type":"text","marks":[{"type":"bold"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"This must be passed in with a ","type":"text"},{"text":"sub_token","type":"text","marks":[{"type":"code"}]},{"text":" or it will have no effect.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Normally if you load up a ","type":"text"},{"text":"sub_token","type":"text","marks":[{"type":"code"}]},{"text":" URL, it will allow modifying the subscription, but will ","type":"text"},{"text":"not","type":"text","marks":[{"type":"italic"}]},{"text":" change the subscription's next date, ","type":"text"},{"text":"nor will it charge the customer immediately","type":"text","marks":[{"type":"italic"}]},{"text":" for the products in the cart. (A past-due amount will still be payable “now”, but the rest of the products will simply bill according to the subscription's next transaction date.) This flag makes the subscription charge “now”.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"This flag is almost always going to be preferable to customers paying the single lump sum past-due amount, as it ensure taxes, shipping, and product details are maintained.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"If the “reset the next transaction date on payment (past due or restart)” option on the “advanced” setting page of the Foxy administration is checked, then the next date will be updated to be one frequency ahead of todays date. If unchecked, the next date will remain as it currently is.","type":"text"}]}]}]}]},"_editable":""},{"_uid":"fac41923-a0af-4bb4-bd47-1a8348fe15d9","name":{"type":"doc","content":[{"type":"paragraph","content":[{"text":"sub_modify","type":"text","marks":[{"type":"code"}]}]}]},"component":"parameter___item","description":{"type":"doc","content":[{"type":"paragraph","content":[{"text":"Description:","type":"text","marks":[{"type":"bold"}]},{"text":" Allows the “add to cart” link or form to completely replace the existing subscription loaded (in the same or a previous cart request) via the ","type":"text"},{"text":"sub_token","type":"text","marks":[{"type":"code"}]},{"text":". (The default behavior is to add new products to the existing subscription, and set the frequency and dates to match.)","type":"text"},{"type":"hard_break"},{"text":"Accepts:","type":"text","marks":[{"type":"bold"}]},{"text":" ","type":"text"},{"text":"replace","type":"text","marks":[{"type":"code"}]},{"type":"hard_break"},{"text":"Notes:","type":"text","marks":[{"type":"bold"}]}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"This is an ","type":"text"},{"text":"optional","type":"text","marks":[{"type":"italic"}]},{"text":" parameter. If omitted, it will default to an “append” behavior.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Upgrading/Downgrading: This can be useful in upgrading or downgrading subscriptions, or otherwise modifying subs. For instance, if you had a monthly membership service, you could create an upgrade link that replaces the currently loaded subscription (loaded via the ","type":"text"},{"text":"sub_token","type":"text","marks":[{"type":"code"}]},{"text":") with the upgraded subscription.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Changing “Auto-Ship” Subscriptions: Similarly, you could use this functionality to replace an auto-ship order that may have multiple different products. Let's say the customer has a subscription for Product A and B, and wants to change it to Product B and 2 Product Cs, you could build an order form that includes the ","type":"text"},{"text":"sub_modify=replace","type":"text","marks":[{"type":"code"}]},{"text":" param, and it would replace the customer's currently loaded subscription.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Removing End Dates: To ","type":"text"},{"text":"clear","type":"text","marks":[{"type":"italic"}]},{"text":" an end-date from a subscription you're replacing, pass ","type":"text"},{"text":"sub_enddate=00000000","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Prorating?","type":"text","marks":[{"type":"textStyle","attrs":{"color":""}}]},{"text":" At present, this ","type":"text"},{"text":"does not prorate","type":"text","marks":[{"type":"italic"}]},{"text":" a subscription. So if you're halfway through a subscription period and replace the subscription, any change in the price between the old and new subscription total ","type":"text"},{"text":"will not","type":"text","marks":[{"type":"italic"}]},{"text":" be prorated. We may add an additional possibilities for this parameter in the future.","type":"text"}]}]}]}]},"_editable":""}],"component":"help_center_parameter","_editable":""},"slug":"subscription-parameters","full_slug":"help/parameters/subscription-parameters","sort_by_date":null,"position":-40,"tag_list":[],"is_startpage":false,"parent_id":5328381,"meta_data":null,"group_id":"fec005a9-92af-4911-a3c3-d8cc88764cc9","first_published_at":"2024-04-06T23:37:12.226Z","release_id":null,"lang":"default","path":null,"alternates":[],"default_full_slug":null,"translated_slugs":null,"_stopResolving":true},"items":[],"component":"help___parameters","_editable":""}\" data-blok-id=\"5f589744-c0af-418f-afab-ac558aae6f37\" style=\"display: none\">"}

Need Help?

Subscription Parameters

Need Help?