Create Session Token

Overview

The createSessionToken method creates a session token for payment processing. This token maintains state across multiple payment operations, enabling secure tracking for multi-step payment flows.

Business Use Case: When processing payments that require multiple steps (3DS authentication, redirect flows), you need to maintain session state between requests.

Purpose

Scenario	Benefit
3DS authentication	Maintain context through challenge flow
Redirect payments	Preserve state during bank redirects
Multi-step checkout	Track progress across pages

Request Fields

Field	Type	Required	Description
merchantSessionId	string	Yes	Your unique session reference
amount	Money	Yes	Payment amount for this session
metadata	object	No	Additional metadata
testMode	boolean	No	Use test environment

Response Fields

Field	Type	Description
sessionToken	string	Token for subsequent operations
statusCode	number	HTTP status code

Example

SDK Setup

const { MerchantAuthenticationClient } = require('hyperswitch-prism');

const authClient = new MerchantAuthenticationClient({
    connector: 'stripe',
    apiKey: 'YOUR_API_KEY',
    environment: 'SANDBOX'
});

Request

const request = {
    merchantSessionId: "session_001",
    amount: {
        minorAmount: 10000,
        currency: "USD"
    },
    testMode: true
};

const response = await authClient.createSessionToken(request);

Response

{
    sessionToken: "sess_1234567890abcdef",
    statusCode: 200
}

Next Steps

• createSdkSessionToken - Initialize wallet sessions

• Payment Service - Process payments using session