Integrate CommercePro Checkout using Response Handler
This section describes the procedure to integrate CommercePro Checkout using Response Handler in your website and start accepting payments.
Step 1: Load the JS-SDK on the page
Load the the following URL using script tag on the page:
https://jssdk.payu.in/bolt/bolt.min.js
Note:
To test your integration of CommercePro on UAT environment, use the following URL:
https://jssdk-uat.payu.in/bolt/bolt.min.js
<script src='https://jssdk.payu.in/bolt/bolt.min.js'></script>
Step 2: Pass the transaction request object
Use the following snippet to construct the initialisation object :
// Create the express object. Refer to the table for a full list of parameters
const expressData = {
key: '<merchant_key>',
txnid: '<merchant_transaction_ID>',
amount: '<total_transaction_amount>',
phone: '<user_mobile_number>',
firstname: '<user_first_name>',
lastname: '<user_last_name>',
email: '<user_email>',
udf1: '<user_defined_parameter1>',
udf2: '<user_defined_parameter2>',
udf3: '<user_defined_parameter3>',
udf4: '<user_defined_parameter4>',
udf5: '<user_defined_parameter5>',
isCheckoutExpress: true,
icp_source: "express",
productinfo: '<merchant_product_info>',
surl: '<merchant_success_url>',
furl: '<merchant_failure_url>',
orderid: '<merchant_orider_ID>',
cart_details: {
'amount': '<total_transaction_amount>',
'items': '<total_items_in_cart>',
'sku_details': [
{
'offer_key': ['<offer_key1>', '<offer_key2>', '<offer_key3>', ... (do this for the offers configure for SKU)],
'amount_per_sku': '<sku_amount>',
'quantity': '<quantity_of_sku>',
'sku_id': '<sku_ID>',
'sku_name': '<sku_name>',
'logo': '<url_of_sku_image>'
},
... (do this for each SKU)
]
},
{
"shipping_charges": '<shipping_charges>',
"cod_fee": '<cod_fee>',
"other_charges": '<other_charges>',
"tax_info": {
"breakup": {
<tax_name> : '<tax_amount>'
},
"total": '<total_Amount_sum_all_charges>'
}
}}
// Get date;
const date = new Date().toGMTString();
// Authentication hash supported
const AUTH_TYPE = 'sha512';
// Stringigy the express object
const stringifiedExpressData = JSON.stringify(expressData);
// Construct hash input on the backend by '|'(pipe) seperating parts
const hash_string = stringifiedExpressData + '|' + date + '|' + <merchant_salt>;
// Construct hash using SHA512 and encoding in hexadecimal
const hash = merchant_function_that_calculates_hash(hash_string)
// Construct authentication header with merchant key, authentication type, v2 hash received from the BE
const authHeader = 'hmac username="' + key + '", ' + 'algorithm="' + AUTH_TYPE + '", headers="date", signature="' + hash + '"';
Transaction Parameters
Field | Description |
---|---|
keymandatory | string The merchant key generated from the PayU. |
txnidmandatory | string The unique ID of the transaction. |
amountmandatory | string The transaction amount, expressed in the currency subunit, such as paise (in case of INR). For example, for an actual amount of โ299.35โ. |
firstnamemandatory | string The customer first name. |
lastnameoptional | string The customer last name. |
emailoptional | string The email address of the customer. |
phonemandatory | string The mobile number of the customer. In case mobile number is not available, send empty string. |
productinfooptional | string The brief details of the product. |
surlmandatory | string The success URL provided by merchant. |
furlmandatory | string The failure URL provided by merchant. |
isCheckoutExpress mandatory | boolean This value is always true |
icp_sourcemandatory | string This value is always โexpressโ |
orderidmandatory | string Use this parameter to create new order or edit existing order. |
cart_detailsmandatory | object Use this parameter to create cart for express transaction and to load SKU offers. The amount passed must be equal to the cart amount when there no extra charges. In case of extra charges, totalย |
udf1optional | String User-defined fields1 |
udf2optional | String User-defined fields2 |
udf3optional | String User-defined fields3 |
udf4 optional | String User-defined fields4 |
udf5optional | String User-defined fields5 |
custom_noteoptional | String Any custom note that you want to display on the checkout screen |
note_categoryoptional | String CC, NB will show the custom_note for Credit Card & Net banking only |
offer_auto_applyoptional ย | Boolean If value is true then best offer will be applied for user for the payment mode from which payment is being done. |
editPhoneAllowedย optional ย | String The value will be either true or false. In case true then phone number edit would not be allowed on express screen, and user would be allowed to login from merchant passed phone number only. |
editEmailAllowedoptional | String The value will be either true or false. In case true then email edit would not be allowed on express screen. |
emailRequiredoptional | String The value will be either true or false.In case true then email entry, would be mandatory on login page . |
extraChargesย optional ย | Static The extra charges object will be required if merchant want to show extra charges to user on express screen.ย |
Step 3: Fetch the response using response handler
On successful or failure payment, the response handler passed to the launch function is executed. The response handler accepts the success/failure object as an input parameter.
The customer remains on the page where they begun the payment process.
The responseHandler()
function fetches the response from PayU once the transaction is completed. In case of a successful, failed, or canceled transaction, the response parameters will be returned to the responseHandler()
function based on the corresponding logic defined by the merchant.
bolt.launch({
data: stringifiedExpressData,
date: date,
isCheckoutExpress: true,
v2Hash: authHeader
}, {
responseHandler: function(express) {
if(express.response.txnStatus == "SUCCESS"){
console.log('Your payment has been successful');
}
if (express.response.txnStatus == "FAILED") {
console.log('Payment failed. Please try again.');
}
if(express.response.txnStatus == "CANCEL"){
console.log('Payment Cancelled.');
}
},
catchException: function(express) {
console.log('Exception occured');
}
})
Response parameters description
Parameter | Descruiption |
---|---|
mihpayid | It is a unique reference number created for each transaction at PayUโs end which is used to identify a transaction in case of a refund. |
mode | This parameter describes the payment category by which the transaction was completed/attempted by the customer.ย The values are:โจย Credit Card โ CCโจ Debit Card โ DCโจ Net Banking โ NB Cash Card โ CASH EMI โ EMIโจ Cardless EMI โ CLEMI * Buy Now Pay Later - BNPL |
bankcode | This parameter contains the code indicating the payment option used for the transaction. For example, Visa Debit Card โ VISA, Master Debit Card โ MAST. |
txnStatus | This parameter returns the status of the transaction and must be used to map the order status. Possible values are SUCCESS, FAILED and CANCEL |
unmappedstatus | This parameter holds the status of a transaction in PayU's internal database, which can include intermediate states. Possible values include: dropped, bounced, captured, auth, failed, usercancelled, or pending. For information on status description, refer to Payment State Explanations. |
key | This parameter contains the merchant key. |
error | For the failed transactions, this parameter provides the reason for failure. |
error_Message | This parameter contains the error message. For the list of error message, refer to Error Codes. |
bank_ref_num | For eachย successfulย transaction โ this parameter contains theย bank reference numberย generated by the bank. |
txnid | This parameter contains the transaction ID value posted by the merchant during the transaction request. |
amount | This parameter contains the original amount which was sent in the transaction request by the merchant. |
productinfo | This parameter contains the same value ofย product informationย which was sent in the transaction request from the merchantโs end to PayU. |
firstname | This parameter contains the same value ofย first nameย which was sent in the transaction request from the merchantโs end to PayU. |
lastname | This parameter contains the same value ofย last nameย which was sent in the transaction request from the merchantโs end to PayU. |
This parameter contains the same value ofย emailย which was sent in the transaction request from the merchantโs end to PayU. | |
phone | This parameter contains the same value of phone which was sent in the transaction request from the merchantโs end to PayU. |
hash | This parameter is crucial and is similar to the hash parameter used in the transaction request. For more information, refer toย Generate Hash. |
udf1 | This parameter contains the same value ofย udf1ย which was sent in the transaction request from the merchantโs end to PayU. |
udf2 | This parameter contains the same value ofย udf2ย which was sent in the transaction request from the merchantโs end to PayU. |
udf3 | This parameter contains the same value ofย udf3ย which was sent in the transaction request from the merchantโs end to PayU. |
udf4 | This parameter contains the same value ofย udf4ย which was sent in the transaction request from the merchantโs end to PayU. |
udf5 | This parameter contains the same value ofย udf5ย which was sent in the transaction request from the merchantโs end to PayU. |
shipping_address | This parameter is an object containing address the customer chose to make payment with. Example: { ย ย "name": "<name_with_saved_address>", ย ย "email": "<email_with_the_saved_address>", ย ย "addressLine": "<address_string>", ย ย "addressPhoneNumber": "<address_number>", ย ย "landmark": โ<landmark_with_address>โ, ย ย "pincode": <pincode_with_address>, ย ย "city": "<city_with_address>", ย ย "state": โ<state_with_address>" } |
Step 4: Catch Exceptions
The catchException
() function captures the transaction message in case of any exceptions.
Next Steps
You can use the Get Order Details API if you want to fetch the order details and order status for a given transaction id (txn id).
Updated 2 months ago