Skip to main content
Help us improve Python packaging – donate today!

django-virtual-pos is a module that abstracts the flow of paying in several online payment platforms.

Project Description

Django Virtual Pos

Django module that abstracts the flow of several virtual points of sale including PayPal

What’s this?

This module abstracts the use of the most used virtual points of sale in Spain.



Implemented payment methods


Paypal paypal payment available.


Bitpay bitcoin payments, from wallet to checkout

Spanish Virtual Points of Sale

  • Ceca

CECA is the Spanish confederation of savings banks.

  • RedSyS

RedSyS gives payment services to several Spanish banks like CaixaBank or Caja Rural.

Santander Elavon

Santander Elavon is one of the payment methods of the Spanish bank Santander.

Requirements and Installation


  • Python 2.7 (Python 3 not tested, contributors wanted!)
  • Django
  • BeautifulSoup4
  • lxml
  • pycrypto
  • Pytz
  • Requests


$ pip install django beautifulsoup4 lxml pycrypto pytz


From PyPi

$ pip install django-virtual-pos

From master branch

Master branch will allways contain a working version of this module.

$ pip install git+git://

Add the application djangovirtualpos to your

    # ...


See this manual (currently only in Spanish).

Needed models

You will need to implement this skeleton view using your own Payment model.

This model has must have at least the following attributes: - code: sale code given by our system. - operation_number: bank operation number. - status: status of the payment: “paid”, “pending” (pending is mandatory) or “canceled”. - amount: amount to be charged.

And the following methods: - online_confirm: mark the payment as paid.

Integration examples

  • djshop

Needed views

Sale summary view

def payment_summary(request, payment_id):
    Load a Payment object and show a summary of its contents to the user.

    payment = get_object_or_404(Payment, id=payment_id, status="pending")
    replacements = {
        "payment": payment,
        # ...
    return render(request, '<sale summary template path>', replacements)

Note that this payment summary view should load a JS file called set_payment_attributes.js.

This file is needed to set initial payment attributes according to which bank have the user selected.

Payment_confirm view

def payment_confirmation(request, virtualpos_type):
    This view will be called by the bank.
    # Directly call to confirm_payment view

    # Or implement the following actions

    # Checking if the Point of Sale exists
    virtual_pos = VirtualPointOfSale.receiveConfirmation(request, virtualpos_type=virtualpos_type)

    if not virtual_pos:
            # The VPOS does not exist, inform the bank with a cancel
            # response if needed
            return VirtualPointOfSale.staticResponseNok(virtualpos_type)

    # Verify if bank confirmation is indeed from the bank
    verified = virtual_pos.verifyConfirmation()
    operation_number = virtual_pos.operation.operation_number

    with transaction.atomic():
                    # Getting your payment object from operation number
                    payment = Payment.objects.get(operation_number=operation_number, status="pending")
            except Payment.DoesNotExist:
                    return virtual_pos.responseNok("not_exists")

            if verified:
                    # Charge the money and answer the bank confirmation
                            response = virtual_pos.charge()
                            # Implement the online_confirm method in your payment
                            # this method will mark this payment as paid and will
                            # store the payment date and time.
                    except VPOSCantCharge as e:
                            return virtual_pos.responseNok(extended_status=e)
                    except Exception as e:
                            return virtual_pos.responseNok("cant_charge")

                    # Payment could not be verified
                    # signature is not right
                    response = virtual_pos.responseNok("verification_error")

            return response

Payment ok view

def payment_ok(request, sale_code):
    Informs the user that the payment has been made successfully
    :param payment_code: Payment code.
    :param request: request.

    # Load your Payment model given its code
    payment =  get_object_or_404(Payment, code=sale_code, status="paid")

    context = {'pay_status': "Done", "request": request}
    return render(request, '<payment_ok template>', {'context': context, 'payment': payment})

Payment cancel view

def payment_cancel(request, sale_code):
    Informs the user that the payment has been canceled
    :param payment_code: Payment code.
    :param request: request.

    # Load your Payment model given its code
    payment =  get_object_or_404(Payment, code=sale_code, status="pending")
    # Mark this payment as canceled

    context = {'pay_status': "Done", "request": request}
    return render(request, '<payment_canceled template>', {'context': context, 'payment': payment})

Refund view

def refund(request, tpv, payment_code, amount, description):
    :param request:
    :param tpv: TPV Id
    :param payment_code: Payment code
    :param amount: Refund Amount (Example 10.89).
    :param description: Description of refund cause.

    amount = Decimal(amount)

            # Checking if the Point of Sale exists
            tpv = VirtualPointOfSale.get(id=tpv)
            # Checking if the Payment exists
            payment = Payment.objects.get(code=payment_code, state="paid")

    except Payment.DoesNotExist as e:
            return http_bad_request_response_json_error(message=u"Does not exist payment with code {0}".format(payment_code))

    refund_status = tpv.refund(payment_code, amount, description)

    if refund_status:
            message = u"Refund successful"
            message = u"Refund with erros"

    return http_response_json_ok(message)


Remove REMOVETHIS to contact the authors.

Release history Release notifications

This version
History Node

History Node

History Node

History Node

History Node

History Node

History Node


History Node


History Node


History Node


History Node


History Node


History Node


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
django_virtual_pos- (61.8 kB) Copy SHA256 hash SHA256 Wheel py2.py3 Apr 10, 2018
django-virtual-pos- (55.3 kB) Copy SHA256 hash SHA256 Source None Apr 10, 2018

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page