django-oscar-paypal 0.1

Overview

PayPal Express is an API for integrating PayPal payments into an ecommerce site. A typical implementation involves redirecting the user to PayPal’s site where they enter their shipping and billing information before arriving back on the merchant site to confirm the order. It can also be used purely for payment, with shipping details being collected on the merchant site.

This library provides integration between PayPal Express and django-oscar.

See the PDF documentation for the gory details of PayPal Express.

Installation

First, you’ll need to create a sandbox merchant account with PayPal - this will provide a username, password and ‘signature’ which are used to authenticate API requests. I

If you want to test your installation in a browser (which you should), then you’ll need to also create a sandbox buyer account so you can checkout.

Fetch package (not ready just yet):

pip install django-oscar-paypal

Add the following settings using the details from your sandbox buyer account:

PAYPAL_API_USERNAME = 'test_xxxx.gmail.com'
PAYPAL_API_PASSWORD = '123456789'
PAYPAL_API_SIGNATURE = '...'

Augment your INSTALLED_APPS to include paypal.express and run syncdb to create the appropriate models.

Next, you need to add the PayPal URLs to your URL config. This can be done as follows:

from django.contrib import admin
from oscar.app import shop

urlpatterns = patterns('',
    (r'^admin/', include(admin.site.urls)),
    (r'^checkout/paypal/', include('paypal.express.urls')),
    (r'', include(shop.urls)),

Finally, you need to modify oscar’s basket template to include the button that links to PayPal. This can be done by creating a new template templates/basket/basket.html with content:

{% extends 'templates/basket/basket.html' %}

{% block formactions %}
<div class="form-actions">
    <a href="{% url paypal-redirect %}"><img src="https://www.paypal.com/en_US/i/btn/btn_xpressCheckout.gif" align="left" style="margin-right:7px;"></a>
    <a href="{% url checkout:index %}" class="pull-right btn btn-large btn-primary">Proceed to checkout</a>
</div>
{% endblock %}

Note that we extending the basket/basket.html template from oscar and overriding the formactions block. For this trick to work, you need to ensure that you have OSCAR_PARENT_TEMPLATE_DIR in your TEMPLATE_DIRS setting:

import os
location = lambda x: os.path.join(os.path.dirname(os.path.realpath(__file__)), x)
from oscar import OSCAR_PARENT_TEMPLATE_DIR
TEMPLATE_DIRS = (
    location('templates'),
    os.path.join(OSCAR_PARENT_TEMPLATE_DIR, 'templates'),
    OSCAR_PARENT_TEMPLATE_DIR,
)

If anything is unclear or not workin as expected then review how the ‘sandbox` installation is set-up. This is a working oscar install that uses PayPal Express.

Contribute

Do this:

mkvirtualenv oscar-paypal
git clone git://github.com/tangentlabs/django-oscar-paypal.git
cd django-oscar-paypal
pip install -r requirements.txt

then you should be able to run the tests using:

./run_tests.sh

There is also a sandbox site for exploring a sample oscar site. Set it up:

cd sandbox
./manage.py syncdb --noinput
./manage.py migrate
./manage.py oscar_import_catalogue data/books-catalogue.csv

and run it:

./manage.py runserver

Use the Github issue tracker for any problems.