Authentication

​

Authentication

All API endpoints are authenticated using Bearer tokens. The token must be included in the Authorization header of each request.

You can generate this token using Basic Authentication with your API key and secret:

const basicAuthToken = btoa(`${API_KEY}:${API_SECRET}`);

​

Hashing

hash value can be "none" for v2 API

Hashing is a process of generating a unique value or a fixed-length string representation of data. This technique is used to store and retrieve data more efficiently and securely. Below is the explanation of how to create a hash for v1 and v2 APIs.

​

How to Create a Hash?

Follow these steps to create a hash:

1. Sort all the parameters.
2. Join all the parameter string values using a | sign.
3. Append the key secret at the end.
4. Convert this string into a hash using the SHA512() function.

​

Example Code

const params = {
    amount: "100",
    currency: "INR",
    callback_url: "https://httpbin.org/post",
    cname: "John Doe",
    email: "johndoe@email.com",
    key: "YOUR_API_KEY",
    phone: "8930395227",
    receipt_id: "TXN0438400150988993",
    notes: {
        udf1: "udf1",
        udf2: "udf2"
    },
};

// Step 1: Sort the object
const sortedParams = Object.keys(params).sort().reduce((accumulator, key) => {
    accumulator[key] = params[key];
    return accumulator;
}, {});

// Step 2: Join all string values with |
let valueString = "";
const allValues = Object.values(sortedParams);
for (let i = 0; i < allValues.length; i++) {
    if (typeof allValues[i] !== "object") {
        valueString += allValues[i] + "|";
    }
}

// Step 3: Append key secret
valueString += "API_SECRET";

// Step 4: Create hash and add to the params
const hash = CryptoJS.SHA512(valueString).toString();
params.hash = hash;

​

Steps to Create a Hash

1. Sort all the parameters.
   • Skip all object values.
2. Join all the string values using a | sign.
3. Add KEY_SECRET at the end of the string.
4. Convert this string into a hash using the SHA512() function.