JavaScript is disabled. Some features may not work. You can also read the static version: View text version

3. Initiating the SDK

Juspay SDK consists of multiple microapps that needs to be initialized to facilitate payments. The SDK initiation is a fire-and-forget call that can be triggered on the merchant's home screen or when the user adds items to their cart.

To initialise the SDK, client needs to call the initiate SDK API. The initiate api call boots up Express Checkout SDK and makes it ready for all other operations

Follow the below steps to make an initiate SDK call

Initiate is to be called in the onCreate() method of your application's main activity (Home screen). Not following this will lead to increased latency.

Step 3.1.

Create an instance of HyperServices

Step 3.2.

Create Initiate payload

Initiate API takes two parameters as input. One of the parameter is a JSON object referred as InitiatePayloadand other is HyperPaymentsCallbackAdapter.

InitiatePayload contains certain key value pairs used by the SDK to perform a successful initiate

Refer to the following table for information about the request and response payload

Request

Response

                      requestID
                      *
                      

String

Mandatory

Unique uuid-v4 string

Example: abcd-12345-abcd-12345

                      service
                      *
                      

String

Mandatory

Value: in.juspay.hyperapi

                      payload
                      *
                      

JSON

Mandatory

Parameters required to call Hyper SDK API

                      action
                      *
                      

String

Mandatory

Operation to be performed in the SDK. Should be initiate for this call.

Value: initiate

                      merchant_id
                      *
                      

String

Mandatory

The merchant id provided by Juspay

                      client_id
                      *
                      

String

Mandatory

Unique identifier associated with static resources assigned by juspay.

Same as merchant_id

                      environment
                      *
                      

String

Mandatory

Juspay remote environment to be used for completing an operation.

For production, pass production
For sandbox, pass sandbox

Step 3.3.

Create CallbackHandler

Step 3.4.

Call initiate