Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/tschellenbach/Django-ogone

Python implementation for the ogone payment interface aimed at Django
https://github.com/tschellenbach/Django-ogone

Last synced: 3 months ago
JSON representation

Python implementation for the ogone payment interface aimed at Django

Awesome Lists containing this project

README

        

# Django Ogone - No longer maintained #

By: Thierry Schellenbach (http://www.mellowmorning.com)

This project aims to provide an easy to use client interface in python to the
Ogone payment interface.

It is Django specific in nature, but hopefully the clean seperation will allow
for easy porting to other frameworks.

## Installation instructions ##

### Step 1 - settings ###

Look at the ogone settings file and define the required settings in your
django settings file:

- `OGONE_PSPID`
- `OGONE_SHA_PRE_SECRET`
- `OGONE_SHA_POST_SECRET`

The secrets are just for hashing purposes. Fill in the same random value here
as in the ogone admin. While you are in the ogone admin set the sha method to
sha512. Furthermore enable the send parameters option for the payment
feedback.

### Step 2 - adding the form ###

The form needs to be integrated in your checkout page.
Ogone's manual explains this quite well.
Note though that you need to be able to sign the data in the form.
Therefore your form must be generated dynamically.
This project provides an easy dynamic form to help you with that.
Here an example implementation:

from django_ogone.ogone import Ogone

def checkout(request):
data = {}
#transaction data
data['PSPID'] = 'mypspid'
data['orderID'] = '1'
data['amount'] = '500'
data['currency'] = 'EUR'
data['language'] = 'en'

context['form'] = Ogone.get_form(data)
context['action'] = Ogone.get_action()

This form enables you to send a secured payment request to ogone.
To support more form field requests to ogone simply add them to the data dict.

### Step 3 - handling payments ###

After the user pays you he is redirected back to your page. If you enabled the
send parameters option in the ogone admin the payment status will be sent to
your system. Usually you would want to use this data to mark the transaction
as payed.

Here an example implementation. Use this to roll your own.

from django_ogone.ogone import Ogone
def order_status_update(request):
'''
Updates the order status with ogone data.
There are two ways of reaching this flow

- payment redirect (user gets redirected through this flow)
- ogone server side call (in case of problems ogone will post to our server
with an updated version ofo the payment status)
'''
ogone = Ogone(request)

# This tests validity of the signature and
# converts some types to Python stuff
ogone.parse_params()

product_id = ogone.get_productid()
status = ogone.get_status()
status_description = ogone.get_status_description()
status_category = ogone.get_status_category()

# DO STUFF WITH INFO

## Resources ##

This older implementation made my life easier. Many thanks to jsmits.
[Django payment ogone](http://github.com/jsmits/django-payment-ogone)