kbourgoin / hiicart

Please note the official branch for HiiCart has been moved to the Hiidef organization account

HiiCart - Django Shopping Cart

A simple shopping cart implementation with support for PayPal, Google Checkout, and Amazon Payments.

Installation and Setup

Installation is as easy as installing with easy_install or pip and adding the appropriate settings for the gateways you want to use. Please see the documentation in hiicart/settings.py for more details about the settings available.

Once set up, create LineItem and HiiCart objects to submit payments:

def foo():
    cart = HiiCart.objects.create() 
    LineItem.objects.create(
        cart=cart, description="foo", name="bar",
        quantity=1, sku="12345", thankyou="thanks!",
        unit_price=9.99)
    return cart.submit("google")

This returns an object containing the redirect URL for you user.

Example App

An example app is included that shows very generally how to get everything set up and working. Right now it really needs a lot of work, but is functional for the most basic case.

hiicart's Issues

Can't cancel recurring items in paypal2

Paypal subscriptions aren't cancellable

The support for this in the current is quite poor. HiiCart needs to implement Website Payments Pro, which will allow greater control over subscription terms.

https://cms.paypal.com/us/cgi-bin/?cmd=_render-content&content_ID=developer/howto_api_reference

https://cms.paypal.com/us/cgi-bin/?cmd=_render-content&content_ID=developer/e_howto_api_WPWebsitePaymentsPro#id0d434473-8817-4a4e-822a-bb23730a17e7

CART_COMPLETE setting is incomplete

This remains a largely incomplete idea. The goal was to have all return pages go to HiiCart, which would then redirect based on this setting. This would obviate the need for each gateway to have a setting for the return url.

Google Checkout subscriptions aren't cancellable

The Problem

Google Checkout can't cancel subscriptions programmatically. This is similar to #1, but a bit more complex. For this, we an either change how subscriptions are handled by HiiCart or add a new lineitem to all Checkout carts.

Change Subscription Handling

Google offers merchant handled subscriptions which seem a good method. This would follow the same model that Amazon does right now, which would be great. The principle drawback is that there's still no clear way to cancel a subscription. We'd just stop billing the subscription, which would be a de facto cancel, but it'd still be technically 'active'.

Adding LineItem to all Carts

The second method is to add a non-recurring LineItem to all carts going out. Why this works isn't immediately obvious:

The mechanism that Google provides to programmatically cancel a subscription is to on the recurring item. The problem that arises is that it must be refunded before it can be cancelled. If we add the lineitem, we can cancel the subscription without having to issue the refund.

This table illustrates the options when creating a subscription. The proposed solution corresponds to the third row of that table.

It isn't currently known if this 'refund first' policy affects subscriptions with recurring payments made (e.g. cancelling a subscription two years out).

Combined Approach

Ultimately, it may be a good idea to move to merchant handled subscriptions AND some method of being able to cancel subscriptions properly. If nothing else, it would be very nice to have the control over billing times and move it to a similar system as Amazon.

Wiki pages for gateways

Need setup information, with screenshots, for all supported gateways. Settings comments are already in markdown, so should be able to copypasta part of the doc.

Credit Card support in paypal2

We should be able to accept credit card numbers directly in the paypal2 gateway. Need to investigate what we need to be regulatory compliant, however.