django-oscar-paypal 0.8

PayPal payment module for django-oscar
`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.

django-oscar-paypal is a Django app that provides integration between PayPal Express and django-oscar.

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.

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.

Settings

There's a smorgasboard of options that can be used, as there's many ways to customised the Express Checkout experience.  Most of these are handled by simple settings.

* ``PAYPAL_SANDBOX_MODE`` - whether to use PayPal's sandbox.  Defaults to ``True``.
* ``PAYPAL_CURRENCY`` - the currency to use for transactions.  Defaults to ``GBP``.
* ``PAYPAL_API_VERSION`` - the version of API used (defaults to ``60.0``)
* ``PAYPAL_ALLOW_NOTE`` - whether to allow the customer to enter a note (defaults to ``True``)
* ``PAYPAL_CUSTOMER_SERVICES_NUMBER`` - customer services number to display on the PayPal review page.
* ``PAYPAL_HEADER_IMG`` - the absolute path to a header image
* ``PAYPAL_HEADER_BACK_COLOR`` - background color (6-char hex value) for header background
* ``PAYPAL_HEADER_BORDER_COLOR`` - background color (6-char hex value) for header border
* ``PAYPAL_CALLBACK_TIMEOUT`` - timeout in seconds for the instant update callback

Some of these options, like the display ones, can be set in your PayPal merchant profile.

last updated on:
September 4th, 2012, 10:03 GMT
price:
FREE!
developed by:
David Winterbottom
homepage:
github.com
license type:
BSD License 
category:
ROOT \ Internet \ Django Plugins
django-oscar-paypal
Download Button

In a hurry? Add it to your Download Basket!

user rating

UNRATED
0.0/5
 

0/5

Rate it!
What's New in This Release:
  • Support Oscar 0.6
  • Fix bug with offers not being applied to basket on return from PayPal site.
read full changelog

Add your review!

SUBMIT