Create SDK Session Token

Overview

The createSdkSessionToken method initializes wallet payment sessions for Apple Pay, Google Pay, and other SDK-based payments. It sets up the secure context needed for tokenized wallet payments.

Business Use Case: When offering Apple Pay or Google Pay checkout, initialize a session with merchant configuration and payment details.

Purpose

Wallet	Purpose
Apple Pay	Initialize PKPaymentSession
Google Pay	Configure PaymentDataRequest
PayPal SDK	Set up checkout context

Request Fields

Field	Type	Required	Description
merchantSdkSessionId	string	Yes	Your unique SDK session reference
amount	Money	Yes	Payment amount
paymentMethodType	string	No	APPLE_PAY, GOOGLE_PAY
countryCode	string	No	ISO country code
customer	object	No	Customer information

Response Fields

Field	Type	Description
sessionToken	object	Wallet-specific session data
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 = {
    merchantSdkSessionId: "sdk_session_001",
    amount: {
        minorAmount: 10000,
        currency: "USD"
    },
    paymentMethodType: "APPLE_PAY",
    countryCode: "US",
    customer: {
        name: "John Doe",
        email: "[e-mail]"
    }
};

const response = await authClient.createSdkSessionToken(request);

Response

{
    sessionToken: {
        applePay: {
            sessionData: "eyJtZXJjaGFudElkZW50aWZpZXIiOi...",
            displayMessage: "Example Store"
        }
    },
    statusCode: 200
}

Next Steps

• Payment Service - Process wallet payments