DEVELOPERS GUIDE

Sample Code for Sending Payment Request to SabPaisa

The following is a sample code to send a request to SabPaisa.

$ spURL = null;

$spDomain = “”; //URL provided by SabPaisa (Mandatory)

$username = “”; //Username provided by Sabpaisa (Mandatory)

$password = “”; //Password provided by Sabpaisa (Mandatory)

$txnId = “”; //Transaction ID (Mandatory)

$clientCode = “”;           //Provided by Sabpaisa (Mandatory)

$authKey = “”;           //Authentication Key Provided By Sabpaisa 

$authIV = “”;           //Authentication IV Provided by Sabpaisa 

$txnAmt = “”;           //Transaction Amount (Mandatory)

$URLsuccess = “”;                     //Return URL upon successful transaction (Optional)

$URLfailure = “”; //Return URL upon failed Transaction (Optional)

$payerFirstName = “”; //Payer’s First Name (Optional)

$payerLastName = “”; //Payer’s Last Name (Optional)

$payerContact = “”; //Payer’s Contact Number (Mandatory)

$payerEmail = “”;           //Payer’s Email Address (Mandatory)

$payerAddress = “”; //Payer’s Address (Optional)

$spURL=”?clientName=”.$clientCode.“&usern=”.$username.“&pass=”.$password.“&amt=”.$txnAmt.“&txnId=”.$txnId.“&firstName=”.$payerFirstName.“&lstName=”.$payerLastName.“&contactNo=”.$payerContact.“&Email=”.$payerEmail.“&Add=”.$payerAddress.“&ru=”.$URLsuccess.“&failureURL=”.$URLfailure;

Note: Import Authentication.php class in your working class and then use the method “encrypt ()” and “decrypt ()” for data encryption and decryption respectively.

$EncryptDecrypt = new EncryptDecrypt();

$spURL = $EncryptDecrypt -> encrypt($spURL,$authIV,$authKey);

$spURL = str_replace(“+”, “%2B”,$spURL);

$spURL=”?query=”.$spURL.”&clientName=”.$clientCode;

$spURL = $spDomain.$spURL;

Redirect $spURL parameter to reach Payment Option through SabPaisa.

Sample Code for Parsing SabPaisa Response:

Following sample code is used to receive and parse the response from Sabpaisa.

$query=$_REQUEST[‘query’];

$authKey=<< retrieve from your configurations>>;

$authIV=<< retrieve from your configurations>>; 

$decText = null;

$EncryptDecrypt = new EncryptDecrypt();

$ decText = $EncryptDecrypt -> decrypt ($query,$authIV,$authKey);

The following is a sample code to send a request to Sabpaisa. 

String spURL = null;  

 spURL = “?clientName=” + clientCode + “&usern=” + username + “&pass=” + password + “&amt=”txnAmt + “&txnId=” + txnId + “&firstName=” + payerFirstName + “&lstName=” + payerLastName “&contactNo=” + payerContact + “&Email=” + payerEmail + “&Add=” + payerAddress + “&ru=” + URLsuccess + “&failureURL=” + URLfailure;  

 spURL = Encryptor.encrypt(query, authIV, authKey); spURL = spURL.Replace(“+”,”%2B”);  spURL=“?query=”+spURL+”&clientName=”+clientCode; spURL= spDomain+spURL; 

Response.Redirect(spURL); 

Sample Code for Parsing SabPaisa Response:

String query=Request[“query”]; query = query.Replace(“%2B”, “+”); 

String authKey=<< retrieve from your configurations>>; 

String authIV=<< retrieve from your configurations>>; String decText = null; 

decText = SabPaisa1.decrypt1(query, authIV, authKey); 

Dictionary<string, string> queryDictonary = new Dictionary<string, string> ();

queryDictonary= AdmissionDeskWebUI.EncryptionDecryption. quearyParser(decText);

After that you can get out parameters from Dictionary and get their value, for example like following:

foreach (KeyValuePair<string, string> pair in queryDictonary)

{

Console.WriteLine(pair.Key.ToString ()+ ”  – ” + pair.Value.ToString () );

}

HttpServletResponse response = null; //Initialize your ServletResponse Object Here 

String spURL = null;

String spDomain = “”; //URL provided by SabPaisa (Mandatory)

String username = “”; //Username provided by Sabpaisa (Mandatory)

String password = “”; //Password provided by Sabpaisa (Mandatory)

String txnId = “”; //Transaction ID (Mandatory)

String clientCode = “”; //Client Code Provided by Sabpaisa (Mandatory)

String authKey = “”; //Authentication Key Provided By Sabpaisa 

String authIV = “”; //Authentication IV Provided by Sabpaisa 

String txnAmt = “”; //Transaction Amount (Mandatory)

String URLsuccess = “”; //Return URL upon successful transaction (Optional)

String URLfailure = “”; //Return URL upon failed Transaction (Optional)

String payerFirstName = “”; //Payer’s First Name (Optional)

String payerLastName = “”; //Payer’s Last Name (Optional)

String payerContact = “”; //Payer’s Contact Number (Optional)

String payerEmail = “”; //Payer’s Email Address (Optional)

String payerAddress = “”; //Payer’s Address (Optional)

boolean auth = false; //Set this bit if authentication is enabled

spURL = “?clientName=” + clientCode + “&usern=” + username + “&pass=” + password + “&amt=”txnAmt + “&txnId=” + txnId + “&firstName=” + payerFirstName + “&lstName=” + payerLastName “&contactNo=” + payerContact + “&Email=” + payerEmail + “&Add=” + payerAddress + “&ru=” + URLsuccess + “&failureURL=” + URLfailure; 

spURL = Encryptor.encrypt(authKey, authIV,spURL);

spURL = spURL.Replace(“\\+”,”%2B”); 

spURL=“?query=”+spURL+”&clientName=”+clientCode;

spURL= spDomain+spURL;

response.sendRedirect(spURL);

Sample Code for Parsing SabPaisa Response:

String query=request.getParameter(“query”);

String authKey= << retrieve from your configurations>>;

String authIV= << retrieve from your configurations>>;

String decText = null;

decText = Encryptor.decrypt(authKey, authIV, query);

—————————————————————————————

Sample Response

If your ‘ru’ & ‘failureURL’ was https://www.example.com then the user will be redirected to something like: 

https://example.com/ReturnPage.jsp?query=X6cexw9gkDhQnLnnNYPdV/clX%2BGfJ1NqdJ0%2BCZTZrpgtZrsU3yl1d4F3xzwHYYDY02WDAe2rmpiSVELTJx9VT16dAzQZccgTvYO72y1qc8K%2BAGxYv8tS9YCitm8KCzKdk%2BxDyh1TsS7%h33H0YLgBciJgbvazRGAsUwYxirzfr1vM7C60qZFruOIR4kb9oRY6MY9v5TaX7SRuQ==&clientCode=XXXXX

Now using the ‘txnId’ you can query our gateway to get the details related to the Payment Request.

Response Processing: 

The Merchant has to decrypt the value and parse it in order to save the transaction data and status to its application