Skip to main content

Saferpay payment integration for django.

Project description


Saferpay integration for django

This packages uses the saferpay json api and the saferpay payment page interface. This is NOT an offical package from SIX Payment Services.

See the official saferpay json api for more information. Take also a look at

django setup

This django package in used in cunjunction with django-oscar. It can work with other django shop systems, nothing is tied to django-oscar.

It's used with dango 1.11 but should/could work with django 2.0, 2.1.

first update

from django.urls import reverse_lazy
from django.utils.translation import ugettext_lazy as _


SAFERPAY_CUSTOMERID = 'xxxxxx'  # a number
SAFERPAY_TERMINALID = 'xxxxxx'  # a number
SAFERPAY_SUCCESS_CAPTURE_URL = reverse_lazy('yourshop:payment-capture')  # your callback after getting the money
SAFERPAY_SUCCESS_URL = reverse_lazy('yourshop:thank-you')  # your callback after a successfull order
SAFERPAY_FAIL_URL = reverse_lazy('yourshop:payment-failed')  # your callback after a failed payment
SAFERPAY_ORDER_TEXT_NR = _('Payment for the company XXX, Order nr. %s.')
SAFERPAY_DO_NOTIFY = True  # default: False

You need to provide three URLs from your shop app for providing callbacks for the saferpay gateway.

  • SAFERPAY_SUCCESS_CAPTURE_URL - saferpay callback for a successfull capture of the amount after PAYMENTPAGE_INIT and PAYMENTPAGE_ASSERT
  • SAFERPAY_SUCCESS_URL - everything went fine, saferpay callback to shop success url
  • SAFERPAY_FAIL_URL - something went wrong, saferpay callback to shop failure url

in your project

        url(r'', include('saferpay.urls')),

create the db models

./ migrate

django oscar setup

If you use django oscar got to django-oscar-saferpay to procced with the setup process and see an sample usage implementation.

sample usage

You can use this code as example. You need to integrate it into your own views in the shop system.

  1. Intizialize the service
from saferpay.gateway import SaferpayService
from saferpay import execptions as sp_execptions

def billing_address_for_saferpay(billing_address):
    """Transform you shop billing address to 
    a format that saferpay uses.
    Your billing_address object can be totaly differnt, 
    adjust it to your needs.
    data = {}
    data['FirstName'] = billing_address.first_name
    data['LastName'] = billing_address.last_name
    data['Street'] = billing_address.line1
    if billing_address.line2:
        data['Street2'] = billing_address.line2
    data['Zip'] = billing_address.postcode
    data['City'] =
    return data

def payment_init(request, order):
    Intizialize a new SaferpayService instance, with your
    order data. Adjust the the order calls for your shop.

    The init payload is created and after success you get
    redirected to the saferpay PayementPage.
    saferpay_service = SaferpayService(
        order_id=order.number,,, language_code=language_code

    payload = saferpay_service.payload_init(billing_address=billing_address_data)

        token = saferpay_service.paymentpage_init(payload)
        request.session['saferpay_token'] = token
        raise RedirectRequired(saferpay_service.paymentpage_redirect().url)
    except sp_execptions.GatewayError as e:
        # do your rollback in case of payment failure 
        return redirect(reverse_lazy('yourshop:payment-failed'))
  1. Assert and Capture the money and place the order
from saferpay.gateway import SaferpayService
from saferpay import execptions as sp_execptions

def payment_capture(request):
    token = request.session['saferpay_token']
    saferpay_service = SaferpayService.init_from_transaction(token=token)
        status = saferpay_service.paymentpage_assert()
    except (
        sp_execptions.GatewayError, sp_execptions.TransactionDeclined,
        sp_execptions.UnableToTakePayment, sp_execptions.PaymentError
    ) as e:
        # do your rollback in case of payment failure 
        return redirect(reverse_lazy('yourshop:payment-failed'))
    if status == 'CAPTURED':
        # register the payment in you shop"Order #%s: payment successful, placing order", saferpay_service.order_id)

            # place the order
        except UnableToPlaceOrder as e:
            # go back to preview

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-saferpay-0.1.1.tar.gz (9.6 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page