| Both sides previous revisionPrevious revisionNext revision | Previous revision |
| v:1.0:products:subscriptions [2012/09/05 14:43] – [Charge past due amounts] foxyjosh | v:1.0:products:subscriptions [2017/04/26 07:02] (current) – external edit 127.0.0.1 |
|---|
| - FoxyCart does not (at this version) send customers emails if their payment fails or if their payment method is soon to expire. FoxyCart attempts to minimize any assumptions about a merchant's business processes, so we encourage you to create your own billing reminder emails and notifications using the [[..:subscription_xml_datafeed|Subscription XML Datafeed]] and something like [[:integration:subscription_datafeed|PHP Subscription XML Datafeed Processor]]. If you have questions please post in [[http://forum.foxycart.com/|our forum]]. | - FoxyCart does not (at this version) send customers emails if their payment fails or if their payment method is soon to expire. FoxyCart attempts to minimize any assumptions about a merchant's business processes, so we encourage you to create your own billing reminder emails and notifications using the [[..:subscription_xml_datafeed|Subscription XML Datafeed]] and something like [[:integration:subscription_datafeed|PHP Subscription XML Datafeed Processor]]. If you have questions please post in [[http://forum.foxycart.com/|our forum]]. |
| - Some gateways may have additional steps to allow FoxyCart to process subscriptions. Please see the notes below for explanation, and **//always test, test, test//** before going live. | - Some gateways may have additional steps to allow FoxyCart to process subscriptions. Please see the notes below for explanation, and **//always test, test, test//** before going live. |
| | |
| | <wrap important>Custom shipping snippets do not work for subscriptions.</wrap> The reason for this is because the snippets are done as Javascript modifications and run in the browser, while subscriptions run completely on the server side and never touch the browser. Subscriptions will always calculate on the server side based on how the category is configured. |
| | |
| |
| <WRAP tip round> | <WRAP tip round> |
| Testing is a **REQUIRED STEP** when using subscriptions with FoxyCart. Check [[..:getting_started:testing|the testing page]] for more details. | Testing is a **REQUIRED STEP** when using subscriptions with FoxyCart. Check [[..:getting_started:testing|the testing page]] for more details. |
| |
| Important to note is that while your FoxyCart store is in test mode, any subscriptions you process will immediately be set to "inactive", and will //not// be processed. This is intentional, since the last thing you want to do is a bunch of testing with subs, then to go live and have dozens or hundreds of test subscriptions running and erroring and causing problems. | Important to note is that while your FoxyCart store is in test mode, any subscriptions you process will be set to "active", and will be processed once you switch over to the Live Servers. |
| |
| If you do want to test, just run the transaction, go into the FC admin and activate the subs (there's a checkbox). Then they'll run as expected. | Before you switch over to the Live Servers, make sure that you set all the subs you have created while on the Test Servers to inactive. You can do that by using the [[v:1.0:api|API]] or by changing them individually. To change them individually, go to the Manage Subscriptions section in the FoxyCart admin, click on the Edit link of the desired subscription, deactivate the sub by unchecking the **Active?** checkbox and then update the subscription. |
| |
| | It's recommended to create a separate store for testing and one for production so that you wouldn't need to deactivate all the test subs when you switch over to a Live Store. |
| |
| |
| |
| ==== The ''sub_token'': What It Is and How To Use It ==== | ==== The ''sub_token'': What It Is and How To Use It ==== |
| Every subscription in a FoxyCart store has a unique ''sub_token'', which is used both to identify the subscription (independent of customer or transaction) and to load the subscription into a customer's cart (to modify or cancel). This token is available in the [[..:subscription_xml_datafeed|Subscription XML Datafeed]], from [[..:api|the API]], and also in your FoxyCart admin (right-click and copy the URL from the "Sub Token URL" link). | Every subscription in a FoxyCart store has a unique ''sub_token'', which is used both to identify the subscription (independent of customer or transaction) and to load the subscription into a customer's cart (to modify or cancel). This token is available in the [[..:subscription_xml_datafeed|Subscription XML Datafeed]], from [[..:api|the API]], and also in your FoxyCart admin subscriptions page, within the expanded details of a given subscription (right-click and copy the URL from the "Sub Token URL" link), or from the edit page of a subscription. |
| |
| When the ''sub_token'' parameter is passed to the cart, it will blow away any previous cart data and load in a "template" of what the subscription is. There are a few common use cases for this: | When the ''sub_token'' parameter is passed to the cart, it will blow away any previous cart data and load in a "template" of what the subscription is. There are a few common use cases for this: |
| |
| <wrap important>FoxyCart's current implementation requires that customers attempting to cancel subscriptions pay any past due amount before they can cancel their account.</wrap> If a customer needs to cancel a subscription with a past due balance you will have to do this for them through the subscription page in the FoxyCart admin. | <wrap important>FoxyCart's current implementation requires that customers attempting to cancel subscriptions pay any past due amount before they can cancel their account.</wrap> If a customer needs to cancel a subscription with a past due balance you will have to do this for them through the subscription page in the FoxyCart admin. |
| |
| ===== Subscription Options ===== | ===== Subscription Options ===== |
| ==== Charge past due amounts ==== | ==== Charge past due amounts ==== |
