https://github.com/juspay/blaze-sdk-web
https://github.com/juspay/blaze-sdk-web
Last synced: 6 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/juspay/blaze-sdk-web
- Owner: juspay
- Created: 2024-05-05T10:59:53.000Z (about 2 years ago)
- Default Branch: release
- Last Pushed: 2025-09-22T17:40:06.000Z (10 months ago)
- Last Synced: 2025-10-05T13:02:57.263Z (10 months ago)
- Language: TypeScript
- Size: 198 KB
- Stars: 0
- Watchers: 4
- Forks: 4
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Blaze SDK Web
Blaze SDK Web is a Javascript library which enables you to seamlessly integrate and use [Breeze 1 Click Checkout](https://breeze.in/) in your Web app built using any kind of web technology.
## Web SDK Integration
Follow the below steps to integrate Blaze SDK into your web app written in any framework.
### Step 1: Obtaining the Blaze SDK
Run following command in your node project to install the Blaze SDK Web package:
```sh
npm install @juspay/blaze-sdk-web
```
This will install the Blaze SDK Web package in your project.
_Note: You can use pnpm, yarn or any other package manager of your choice to install the package._
### Step 2: Initialize the SDK
#### 2.2.1: Import the SDK
Import BlazeSDK using the following code in TS/JS project:
```javascript
import BlazeSDK from '@juspay/blaze-sdk-web';
```
#### 2.2.1: Construct the Initiate Payload
Create a Json with correct parameters to initiate the SDK. This is the data that will be used to initialize the SDK.
```javascript
const initiatePayload = {
merchantId: '',
shopUrl: '',
environment: 'production'
};
const initSDKPayload = {
requestId: '',
service: 'in.breeze.onecco',
payload: initiatePayload
}
```
#### 2.2.2: Construct the Callback Method
Create a callback method to handle the response from the SDK. This method will be called when the SDK has processed the request.
```javascript
// response will be an json object
const callbackMethod = (response>) => {
console.log('Response from SDK:', response);
};
```
#### 2.2.3: Call the initiate method on Blaze
Call the `initiate` method on Blaze SDK with the initiate payload and the callback method.
```javascript
BlazeSDK.initiate(initSDKPayload, callbackMethod);
```
### Step 3: Start processing your requests
Once the SDK is initiated, you can start processing your requests using the initialized instance of the SDK.
The SDK will call the callback method with the result of the SDK operation.
#### 3.1: Construct the Process Payload
Create a Json payload with the required parameters to process the request.
The process payload differs based on the request.
Refer to schemas sections to understand what kind of data is required for different requests
```javascript
// 3.1 Create SDK Process Payload
// Create a JSONObject for the Process data
let processPayload = {
"action": "",
// and more parameters required as per the action
};
// Place Process Payload into SDK Payload
let processSDKPayload = {
requestId: '',
service: 'in.breeze.onecco',
"payload": processPayload
};
```
#### 3.2: Call the process method on Blaze Instance
Call the process method on the Blaze instance with the process payload to start the user journey or a headless flow.
```javascript
BlazeSDK.process(processSDKPayload)
```
## Backend SDK Integration
For server-side integration using Node.js, please refer to the [Backend SDK Documentation](./BACKEND_README.md).
The Backend SDK is designed for server-to-server communication and includes features like:
- Secure authentication with auth tokens
- Server-side payment initiation
- Direct API communication with Breeze platform
[View Backend SDK Documentation →](./BACKEND_README.md)