---
title: "InitiateSession"
method: POST
path: "/v2/InitiateSession"
tags: ["Payments (V2)"]
---

# InitiateSession

`POST /v2/InitiateSession`

## Request

- Base URL: `https://apitest.myfatoorah.com`
- URL: `https://apitest.myfatoorah.com/v2/InitiateSession`
- Auth: HTTP bearer

Initiates a session for Embedded Integration

## Request body

- object
  - `CustomerIdentifier` string: Must be unique for each of your customers. This identifier is used to retrieve saved tokens.
  - `SaveToken` boolean: If you need to tokenize card and use it for future charges. Note: Tokenization feature must be enabled for your account
  - `IsRecurring` boolean: If you need to create payment with standard recurring.

## Response `200`

Session initiated successfully

- object
  - `IsSuccess` boolean: Indicates if the request was successful.
  - `Message` string: Response message associated with the request.
  - `ValidationErrors` object[]: List of validation errors, if any.
    - `Name` string: The name of the field with validation error.
    - `Error` string: The validation error message.
  - `Data` object
    - `SessionId` string: The unique session identifier
    - `CountryCode` string: The country code associated with your account.
    - `CustomerTokens` object[]: List of saved payment tokens for the customer.
      - `Token` string: The tokenized card for future payments.
      - `CardNumber` string: Masked card number (512345xxxxxx0008).
      - `CardBrand` string: The card brand (Visa, Master, Amex).
      - `Is3DSVerified` boolean: Indicates if the card has been verified with 3D Secure.
      - `TokenType` string: The type of token.

---

[API](https://skmtc.dev/myfatoorah/apis/myfatoorah-api-v2.md) - [All operations](https://skmtc.dev/myfatoorah/apis/myfatoorah-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/myfatoorah/apis/myfatoorah-api-v2/revisions/4c0c2a3af558?raw)