---
updatedAt: 2026-02-26T13:11:43.000Z
agentTools:
projectIndex: https://docs.ksa.ngenius-payments.com/llms.txt
---
# How to set up the hosted session SDK to support wallets
This guide explains how to enhance your **Hosted Session SDK** integration to support digital wallets such as **Apple Pay**, **Google Pay**, and **Samsung Pay**.
> 📘 Before you begin: This guide assumes you've already integrated the Web SDK component. If not, refer to the [Web SDK Integration Guide.](https://docs.ksa.ngenius-payments.com/ksa/docs/web-sdk-integration-guide)
## Step 1: Load the SDK and Mount the Card Input
Include the SDK in your HTML and use the `mountCardInput()` method to initialize the form.
```html
Hosted Session with Wallets
```
***
## Parameter Overview
| Parameter | Required | Description |
| :----------------------- | :------- | :--------------------------------------------- |
| `apiKey` | ✅ | Your Hosted Session API key (from portal) |
| `outletRef` | ✅ | Outlet reference (from portal) |
| `language` | ✅ | UI language (`en` or `ar`) |
| `style` | ✅ | Object defining visual styles |
| `multiplePaymentMethods` | ✅ | Enables digital wallets tab |
| `orderDetails` | ✅\* | Required if `multiplePaymentMethods` is `true` |
| `onChangePaymentMethod` | ✅ | Callback when wallet or card tab is switched |
| `onChangeValidStatus` | ✅ | Callback for field-level validation |
> 📘 You can only use Apple Pay on Safari.
***
## Step 2: Supporting Samsung Pay
Samsung Pay requires an additional session flow via `generateSessionId()`.
### HTML Setup
```html
```
### JavaScript Example
```javascript
async function createSession() {
try {
const response = await window.NI.generateSessionId({
mountId: 'wallet_iframe',
containerId: 'wallet_modal' // Optional, used to make hidden modal visible
});
const sessionId = response.session_id;
console.log('Session ID:', sessionId);
} catch (err) {
console.error('Failed to create session:', err);
}
}
```
**Parameters for `generateSessionId()`**:
* `mountId` (required): ID of the element where the Samsung Pay iframe will render.
* `containerId` (optional): If passed, this element's `display` is set to `block` to reveal the modal.
***
## Need Help?
If you're unsure how to enable wallet support or retrieve credentials:
* Visit your [N-Genius Portal](https://portal.sandbox.ksa.ngenius-payments.com/)
* Reach out to your Relationship Manager or [onboarding team](mailto:ecom-integration@network.global)