INTEGRATIONS

Getting Started

Web Integration

Accept payments from your customers in a secure and quick manner with Cashlesso. Your customers get a streamlined flow with the ‘Checkout’ form for initiating payments. The payment details shared by your customer are tokenised by Cashlesso. tag as data attributes. You can submit additional fields, visible or hidden, along with the form.

With this sample code given below, Cashlesso ‘Checkout’ options  will be passed as the HTML data attributes.

After the completion of the checkout process, an additional field <name=id> will be added to the form containing the script tag. Post this, the form is submitted automatically. With the authorisation of the payment made, the form along with the Cashlesso_payment_id to the action url. 

Note: In the below mentioned code, replace the URL with the success callback URL of your website.

Cashlesso provides its customers with the ‘Retry’ option in case of a failure.

Getting Started

Web integration is the simplest, quick and easy way to integrate the Cashlesso in your Website. When using this mode of integration customers will be redirected from your checkout page to the Cashlesso payment page to collects payment details which has built-in support for Saved Cards, Credit and Debit Cards, UPI wallets and much more.

Payment page is Hosted at Cashlesso Servers which are PCI DSS compliant so that the merchant does not have to worry about the PCI DSS.

Enforce payment mode(RFU)

Payment Flow

Sample Flow diagram

Generating Test Credentials

  1. Login to your merchant account
  2. Click on My Account Tab
  3. Click on My Profile 
  4. You can find Salt key and PAY_ID value under Integration Tab

 

Alternatively, you can contact the integration support team/RM to get the keys.

Checkout API

Create the order form

Request URls

Integration: https://uat.cashlesso.com/pgui/jsp/paymentrequest

Production: https://www.cashlesso.com/pgui/jsp/paymentrequest

 

Generating Secure Hash

Every request is accompanied by a secure Hash that verifies the request’s Integrity as well as merchant identity. The secure Hash algorithm is SHA-256.

To generate secure Hash use the following method: Take all the request parameters that are to be
sent to cashlesso and sort them in ascending order according to the name of each field.

Now prepare a String of these sorted name value params with Tiled (~) as the separator like:

 

Next step is to append the Salt Key at the end of the parameter string given by Cashlesso Payment
Gateway to you. After adding you will get the following output (If salt key is b6200e78557e4e55)

 

Note: Please append the secret key in lower case without any separator after the last value.

After completing the above-mentioned process, you will have to call SHA 256 algorithm and pass the parameter string to the same and the SHA will return you the desired result as below

Hash value= {6797f1842deb4f3ebaead53e1bafd5a535d322b9fa3893f201fdb03933eeae09}


Now you must convert the generated value to the Upper Case, and you will get the final result as hash value


Hash value = 6797F1842DEB4F3EBAEAD53E1BAFD5A535D322B9FA3893F201FDB03933EEAE09

 

Submitting Form

Once you have prepared the form the user can click on the submit button or you can implement an automatic javascript for form auto submit and user will be redirected to Cashlesso payment page.

Note: To maximize conversion, Cashlesso recommends that you redirect customers to the Payment Gateway in the same browser window.


Note: Amount format is in the least parts without decimals like INR 1200.23 will be written as 120023 and INR 1.00 as 100

Test Cards

You use these cards in your test suite.

Validating response

The merchant application must validate the transaction response in the status response. This can be done as follows:

Match the response hash that is present in the response against the merchant application calculated hash value using the response params. In case the merchant hash does not match that transaction must not be considered a successful transaction.

For successful transaction RESPONSE_CODE is 000 and STATUS is “Captured” or “Approved”.

Note: Please ensure that response Hash is validated in your production system.

Call the status API and verify the result received real time.

Request Params

 

Field name

Description

Required

Type^

Min

Max

Example

Merchant Details

PAY_ID

Pay ID  is a unique merchant identifier provided by Cashlesso 

YES

NU

16

16

160234578452178

ORDER_ID

Merchant reference number

YES

AN

1

50

ESN78452

RETURN_URL

Url of merchant website to get the response after transaction is processed

YES

CH

5

1024

http://www.response.com

HASH

Unique value generated by SHA 256 hashing algorithm

YES

AN

64

64

7995156CE4C40C44C41BECA3B9CE09B9

 

Customer Details

CUST_NAME

Customer name

NO

CH

1

150

John Pal

CUST_FIRST_NAME

Customer first name

NO

CH

2

150

John

CUST_LAST_NAME

Customer last name

NO

CH

2

150

Pal

CUST_STREET_ADDRESS1

Customer address

NO

CH

2

250

House no-101

CUST_CITY

Customer city

NO

CH

2

50

Gurgaon

CUST_STATE

Customer state

NO

CH

2

100

Haryana

CUST_COUNTRY

Customer country

NO

CH

2

100

India

CUST_ZIP

Customer zip

NO

AN

6

9

TWQ 123

CUST_PHONE*

Customer phone

NO

NU

8

15

07417456565

CUST_ID*

Unique ID assigned to customer

NO

CH

5

250

CUST109328

CUST_EMAIL*

Customer email

NO

CH

6

120

john@test.com

CUST_SHIP_LAST_NAME

Customer Shipping last name

NO

CH

2

150

Pal

CUST_SHIP_FIRST_NAME

Customer shipping first name

NO

CH

2

150

John

CUST_SHIP_NAME

Customer shipping name

NO

CH

2

150

John Pal

CUST_SHIP_STREET_ADDRESS1

Customer shipping address

NO

CH

2

250

House no-101

CUST_SHIP_STREET_ADDRESS2

Customer shipping address

NO

CH

2

250

Block A

CUST_SHIP_CITY

Customer shipping city

NO

CH

2

50

Gurgaon

CUST_SHIP_STATE

Customer shipping state

NO

CH

2

100

Haryana

CUST_SHIP_COUNTRY

Customer shipping country

NO

CH

2

100

India

CUST_SHIP_ZIP

Customer shipping zip

NO

AN

6

9

122001

CUST_SHIP_PHONE

Customer shipping phone

NO

NU

8

15

07417456565

       

 

Payment Details

AMOUNT**

Total Sale Amount

YES

NU

3

12

100

       

CURRENCY_CODE

3-digit code of the currency 

YES

NU

3

3

826 (ISO 4217 numeric code)

 

Item Level Details

PRODUCT_DESC

Description of product

NO

CH

1

1024

xyz

^Abbreviation NU – Numeric, CH – Character, AN – Alphanumeric

Response Params

 

Field name

Description

Example value

CUST_NAME 

Customer name

John Pal

TXNTYPE

Type of transaction processed

SALE/AUTH

AMOUNT

Total Sale Amount

100

CURRENCY_CODE *

3-digit code of the currency

826

ORDER_ID

Merchant reference number

ESN78452

PAY_ID

Pay ID is given by Cashlesso 

160234578452178

TXN_ID

Transaction Id generated by Cashlesso to identify the current step

150611417421130

PAYMENT_TYPE

Type of payment mode used by customer

CC/DC/NB

MOP_TYPE

Method of payment 

VI/MC/SBI

CARD_MASK

Masked card number for card txns

401200******1234

PG_REF_NUM

Id generated by Cashlesso. Use for further communication with Cashlesso, for tracking the full order

150611417421129

RESPONSE_CODE *

Code for transaction status

000

RESPONSE_MESSAGE *

Response message for transaction status

SUCCESS

HASH*

Unique value generated by SHA 256 hashing algorithm

7995156CE4C40C44C41BECA3B9CE09B9

ECI

Bank issued ECI flag

 

AUTH_CODE

Authorization code

123456

RRN

Bank reference number

789456132

AVR

Address verification flag

Y/N

ACQ_ID

Bank reference number

KJDNI4UT873

STATUS

Transaction status

Approved/Captured/Declined

CUST_EMAIL

Echo back field

john@gmail.com

CUST_ID

Echo back field

 

CUST_PHONE

Echo back field

 

PG_TXN_MESSAGE

Detailed message for transaction 

 

RETURN_URL

Merchant return URL in request

www.merchantsite.com/paymentresponse

RESPONSE_DATE

Date of response

12102019

RESPONSE_TIME

Time of response

10:35:10

PRODUCT_DESC

Description of product

xyz

CARD_ISSUER_BANK

Card issuing bank

SBI

CARD_ISSUER_COUNTRY

Issuing country of the customer card

India

TOTAL_AMOUNT

Total amount debited to customer in case of surcharge model

10134

Response Codes

You can use these codes for your test suite.

Ecommerce Plugins

Following are the various available Ecommerce plugins you can use:

cs-cart logo

CS-Cart

Get Plugin

Coming Soon
wix logo

Wix.com

Get Plugin

Coming Soon
arastta logo

Arastta

Get Plugin

Coming Soon
wordpress logo

Wordpress

Get Plugin

Coming Soon
opencart logo

OpenCart

Get Plugin

Coming Soon
woocommerce logo

WooCommerce

Get Plugin

Click Here
Magento logo

Magento

Get Plugin

Coming Soon
shopify logo

Shopify

Get Plugin

Coming Soon

Language Toolkits

Following are the various resources you can use:

php logo

PHP

Get Plugin

Coming Soon
Java logo

Java

Get Plugin

Coming Soon
Node js logo

Wordpress

Get Plugin

Coming Soon
Ruby logo

Ruby

Get Plugin

Coming Soon
.net logo

.Net

Get Plugin

Coming Soon
Python logo

Python

Get Plugin

Coming Soon
Follow Us
© 2020 All Rights Reserved