django-virtual-pos 1.7.1

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

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.

License

MIT LICENSE.

Implemented payment methods

Paypal

Paypal paypal payment available.

Bitpay

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

Requirements

• Python 2.7 (Python 3 not tested, contributors wanted!)

• Django

• BeautifulSoup4

• lxml

• pycrypto

• Pytz

• Requests

Type:

$ pip install django beautifulsoup4 lxml pycrypto pytz

Installation

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://github.com/intelligenia/django-virtual-pos.git

settings.py

Add the application djangovirtualpos to your settings.py:

INSTALLED_APPS = (
    # ...
    "djangovirtualpos",
)

Use

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

@csrf_exempt
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():
            try:
                    # 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
                    try:
                            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.
                            payment.online_confirm()
                    except VPOSCantCharge as e:
                            return virtual_pos.responseNok(extended_status=e)
                    except Exception as e:
                            return virtual_pos.responseNok("cant_charge")

            else:
                    # 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
    payment.cancel()

    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.
    :return:
    """

    amount = Decimal(amount)

    try:
            # 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"
    else:
            message = u"Refund with erros"

    return http_response_json_ok(message)

Authors

• Mario Barchéin [e-mail]

• Diego J. Romero [e-mail]

Remove REMOVETHIS to contact the authors.