Skip to main content

PayU integration for Django.

Project description

https://codeclimate.com/github/michalwerner/django-payu-payments/badges/gpa.svg https://img.shields.io/pypi/v/django-payu-payments.svg https://img.shields.io/pypi/dm/django-payu-payments.svg https://img.shields.io/pypi/l/django-payu-payments.svg

Installation

  1. Install via pip:

    pip install django-payu-payments
  2. Add payu to INSTALLED_APPS:

    INSTALLED_APPS = [
        ...
        'payu',
        ...
    ]
  3. Add URLs to URLConf:

    url(r'^payments/', include('payu.urls', namespace='payu')),
  4. 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.

  1. run migrations: python manage.py migrate payu.

  2. 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

django-payu-payments-0.1.3.tar.gz (9.5 kB view details)

Uploaded Source

Built Distribution

django_payu_payments-0.1.3-py3-none-any.whl (13.4 kB view details)

Uploaded Python 3

File details

Details for the file django-payu-payments-0.1.3.tar.gz.

File metadata

File hashes

Hashes for django-payu-payments-0.1.3.tar.gz
Algorithm Hash digest
SHA256 fb99f27cbc89e72c1b1a4ab2a979b40e1323987d6ca3b9677360c2794f4db227
MD5 0591ee60998ca6fb3070abc1beb35a9c
BLAKE2b-256 5d979dcdd4a9474e5de3afca514e4c7d0f8e47cc63301eabd00fee16e62eda39

See more details on using hashes here.

Provenance

File details

Details for the file django_payu_payments-0.1.3-py3-none-any.whl.

File metadata

File hashes

Hashes for django_payu_payments-0.1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 e51b1480f405733c0612070134d48ea622fe7b1085a55120c3eabf970c52aa35
MD5 1514d662d1208b86a4db64e6a8406bbd
BLAKE2b-256 138e5bd0cdc7fad0e4c5c9321a776b66a262baa4495f166b4592e1a995201900

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page