django-billdesk 0.0.1

A tool to integrate BillDesk in Django Site

django-billdesk

Usage

An tool to ease the process to integrate billdesk payment gateway with your django project. All you need to do is to create these variables in your settings.py file.

MID = '<merchant-id>'
SEC_ID = '<sercet-id>'

BILL_URL = 'https://uat.billdesk.com/pgidsk/PGIMerchantPayment'
CONF_BILL_URL = 'https://uat.billdesk.com/pgidsk/PGIQueryController'
CHECKSUM_KEY = '<checksum-key>'
REVERSE_URL = '<reverse url>'

To know excatly what these variables mean have at look at my gist

STEP 1

Now to use this in your project,you simply need to do

from django_billdesk import ResponseMessage, GetMessage

STEP 2

Now GetMessage gives the message to be posted in the required format along with the checksum. All you need to do is

msg = GetMessage().message(uniqueID, amount, ExInfo1, ExInfo2, ExInfo3, ExInfo4)

NOTE:

1. uniqueID mentioned above should be truely unique for all the transactions requested by you.If not, the transaction will be declined by billdesk.
2. The order of arguments being passed should not be changed.
3. Atleast 4 (billdesk says 3 but for extra security) ExtraInfo should be passed about the transaction. For ex - emailId of person making transaction, his phone number, his name, his ID in your company or website.
   

Suggested format

msg = GetMessage().message(uniqueID, amount, some_id, email, name, mnumber)

Important : some_id shouldn't be confused with uniqueID. uniqueID will be created by you everytime a transaction is requested and is ensured that it is truely unique and never before has any request been made with the same id, whereas some_id is the id which you allocate to a user when he or she registers on your site. So a same person, when will make multiple transactions, will have same 'some_id' but different uniqueID

STEP 3

Now make a 'POST' request to the billdesk url with the msg you obtained. You can obtain the template and complete code to do so from my gist

STEP 4

Now you will receive a response at the return url. You will send that resposne to ResponseMessage as shown:

values = ResponseMessage.respMsg(<The response msg>)

Note :

1. Make sure your function which is called at response url is csrf exempted as you are receiving a POST request from a website outside of your domain.
2. You will get a dictionary in the variable 'values' as mentioned above. But before doing anything make sure the variable 'values' is not False.

if values not False:
    <do everything in here>

cuz if the value is false, it means there had been a breach as Checksum verification failed.

STEP 4

Now you can update your database based on the response and values in the variable 'values'
Structure of 'values':

{'MID': '', 'OrderID': '', 'TaxnNo': '', 'AMNT': '', 'TStat': '', 'DnT': '', 'TMode': ''}

All the variables in the dictionary above will hold values as received in the response message from billdesk

1. MID = will hold the merchant ID to which payment was made
2. OrderID = will hold the unique order id for the transaction
3. TaxnNo = will hold the unique taxation number generated by the respective bank
4. AMNT = will hold the amount for which the transaction was made
5. TStat = will hold the transaction status number. See the possible outcomes and their meaning
6. DnT = will hold the date and time at which the transaction was made.
7. TMode = will hold the mode of transaction. For ex- UPI, Internet Banking.