PayU integration for Django.
Project description
Installation
Install via pip:
pip install django-payu-payments
Add payu to INSTALLED_APPS:
INSTALLED_APPS = [ ... 'payu', ... ]
Add URLs to URLConf:
url(r'^payments/', include('payu.urls', namespace='payu')),
Run migrations:
python manage.py migrate
Configuration
Configuration is done via Django’s settins.py file.
PAYU_POS_ID
Your POS ID. If not provided the test payment value will be used.
PAYU_MD5_KEY
Your MD5 key. If not provided the test payment value will be used.
PAYU_SECOND_MD5_KEY
Your second MD5 key. If not provided the test payment value will be used.
PAYU_CONTINUE_PATH
Specifies path on your website, where user should be redirected after payment (successful, or not). May be absolute path, like /some-page/ or reverse('some:thing'). This view should handle GET parameters error=501 in case of failed payment and no_payment=1 in case of payment with total equals 0, which is registered, but actually sent to PayU.
PAYU_VALIDITY_TIME
Payment validity time (in seconds), after which it’s canceled, if user did not take action. If not provided 600 will be used.
Create payment
To create payment object you have to call Payment.create method:
from payu.models import Payment description = 'Some stuff' products = [ { 'name': 'Some product', 'unitPrice': 14.99, 'quantity': 1 }, { 'name': 'Some other product', 'unitPrice': 3.19, 'quantity': 4 } ] buyer = { 'email': 'john.doe@domain.com', 'firstName': 'John', 'lastName': 'Doe' } notes = 'This client is important for us, we should prioritize him.' payment = Payment.create(request, description, products, buyer, validity_time=300, notes)
request is just Django HTTP request object, we need it to get buyer IP, and absolute URLs.
validity_time is optional and overrides PAYU_VALIDITY_TIME setting.
notes is optional, and used for storing internal information about payment.
Payment.create will return two-key dictionary, containing Payment object and URL where buyer should be redirected, or False if not successful.
{ 'object': <Payment object>, 'redirect_url': 'https://...' }
Fetch payment’s data
To get data associated with payment you just need to retrieve Payment object:
Payment.objects.get(...)
There are also few helpful methods, which you can call on Payment object:
get_total_display()
Returns pretty formatted total value.
get_products_table()
Returns pretty formatted table of products associated with payment.
is_successful()
For status equal COMPLETED returns True, otherwise False.
is_not_successful()
For status equal CANCELED or REJECTED returns True, otherwise False.
Changelog
0.1.3
PEP8 fixes
0.1.2
changelog added
get_total_display(), get_products_table(), is_successful() and is_not_successful() methods added
JSONField is not Postgres-only anymore
Payment.create() now returns two-key dictionary instead of just redirect URL
Payment objects are now ordered from newest to oldest, by default
compiled translation is now included in package
settings moved to settings.py
settings is not dictionary anymore
validity time added
JSONField and ordering related changes requires you to take some action when upgrading.
run migrations: python manage.py migrate payu.
run following code, using Django shell (python manage.py shell):
import json from payu.models import Payment for p in Payment.objects.all(): if isinstance(p.products, str): p.products = json.loads(p.products) p.save()
0.1.1
sum added to products table
0.1.0
initial version
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file django-payu-payments-0.1.3.tar.gz
.
File metadata
- Download URL: django-payu-payments-0.1.3.tar.gz
- Upload date:
- Size: 9.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | fb99f27cbc89e72c1b1a4ab2a979b40e1323987d6ca3b9677360c2794f4db227 |
|
MD5 | 0591ee60998ca6fb3070abc1beb35a9c |
|
BLAKE2b-256 | 5d979dcdd4a9474e5de3afca514e4c7d0f8e47cc63301eabd00fee16e62eda39 |
Provenance
File details
Details for the file django_payu_payments-0.1.3-py3-none-any.whl
.
File metadata
- Download URL: django_payu_payments-0.1.3-py3-none-any.whl
- Upload date:
- Size: 13.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | e51b1480f405733c0612070134d48ea622fe7b1085a55120c3eabf970c52aa35 |
|
MD5 | 1514d662d1208b86a4db64e6a8406bbd |
|
BLAKE2b-256 | 138e5bd0cdc7fad0e4c5c9321a776b66a262baa4495f166b4592e1a995201900 |