Hi! We're very interested in using FoxyCart for subscriptions on our site. We currently use Amazon simplepay, which is coming to end of life soon. I'm having a little difficulty figuring out what I need to do. I like what documentation there is, but I would like to see a few additions. Let me know if I should put this under "General Reqests" please.
First of all, there is a lot of repetition of "FoxyCart is different," followed by description of what it isn't and what features it boasts. But there isn't much explicit description of exactly what it is beyond the features/advantages. I think it would be very helpful (at least for me) to have an overview of not only why it's good or what it's good for, but what it does. I want to see how it is meant to work, flow of data/information, what happens in the browser when items are added to the cart and during checkout. I'd like a clear description of the sequence of events and communication between my servers, the user's browser, the foxycart servers, the payment gateway, etc. Some diagrams might be particularly useful for this, and it would be helpful to discuss/highlight differences in this regard between different gateways, how subscription payments and subscription updates work, and how they differ from products.
I'd also like to see complete examples. The explanations of the product parameters are good overall, but it would help to see them put together, how the parameters could be combined for various use cases.
The subscription parameters aren't as well documented. For example, there is not much explanation of sub_token and I haven't found an example on the wiki. The documentation says it's a url, but it isn't clear whether that's supposed to be the url on my site or on my foxycart subdomain, or what's supposed to happen when the url is accessed. Also the docs state that sub_token is "[v]ery useful when used in conjunction with the redirect 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." I am having some trouble grasping what exactly is meant by this. It's good to know *why* I might want to do this, but the docs don't state clearly *how* to use these together or *what* actually happens when I do. Perhaps a data flow diagram as I suggested above would help. Also I found very little description elsewhere of the redirect feature. It doesn't seem to be in the list of documented parameters. Should it be?
Another topic that isn't covered as fully in the documentation as I'd like is customers and authentication. The SSO documentation seems to indicate that customer sign-on is required for subscriptions, but there's no mention of this at all in the subscriptions documentation (SSO isn't even in the list of 'related documentation' links). Another thing that isn't stated clearly is whether customers' foxycart credentials are specific to my foxycart subdomain or work for all foxycart subdomains. When we process a subscription with amazon, the user has to sign in to amazon, but most users probably have amazon accounts already and the credentials are the same. If we send a user to foxycart, s/he is less likely to have foxycart credentials and (without SSO) might have to create a foxycart account as well. But if the foxycart account is specific to my foxycart subdomain, then the user is guaranteed not to have a foxycart account, so SSO integration essentially becomes a requirement for processing subscriptions.
Thanks for reading. Looking forward to more explanation/documentation.