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

# InitiateSession

`POST /v2/InitiateSession`

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.net/myfatoorah/apis/myfatoorah-api-v3.md) · [All operations](https://skmtc.net/myfatoorah/apis/myfatoorah-api-v3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/myfatoorah/myfatoorah-api-v3/revisions/994a74287a16/schema)