Key obtaining

Obtaining of the session key

This section explains how to authenticate API requests using keys. It details the process of obtaining and securely managing authentication credentials to ensure that only authorized requests are processed.

Request address

https://carouseller.com/v1/get_session_key/

Headers

{“Content-Type: “application/json”}

Main parameters of a key request

{
    "site_id": 24,
    "site_login": "443122443122",
    "customer_ip": "185.56.232.170",
    "currency": "usd",
    "signature": "1234566443"
}

Parameter	Mandatory	Format	Description	Example
site_id	Yes	integer	Client id provided by support with documentation	1
site_login	Yes	varchar(256)	User id	user_test
customer_ip	Yes	inet (ipv4 or ipv6) string	User IP address	8.8.8.8
currency	Yes	alpha-3 ISO 4217	Purchase currency	USD
signature	Yes	SHA-1	Request signature, see Request signature generating rules	d9f5713990de5c6e32169dba1f0102f540018975

Additional parameters of key request

Parameter	Mandatory	Format	Description	Example
language	No	ISO 639-1	Cashier language. Supported languages: ru, en, fi, ja, lv, no, sv, uk, zh	en
user_email	No	email	User’s e-mail on the site	[email protected]
timezone	No	timezone	User’s timezone	UTC
force_action	No	integer	Menu item to display without other tabs	1 - Deposit, 2 - Withdraw, 3 - Transaction history
birthdate	No	date	User’s birthday	01-01-1980
user_name	No	string	User’s First and Last Name	John Doe
first_name	No	string	User’s First name	John
last_name	No	string	User’s Last name	Doe
user_country	No	string(2)	User‘s country ISO-code	UK
user_city	No	string	User’s City	London
user_address	No	string	User’s address	16 Grand Avenue Street, bldg. 1a
user_postal	No	string	User’s postal	121552
user_phone	No	string	User’s phone number	[phone]
document_id	No	string	User’s ID number	32000000008
user_preset_id	No	integer	Preset ID number	1

Response examples

200: Response example

{
    "success": true,
    "session_key": "eyJybmQiOiAiMGQ2OTljNzktODg4YS00MGIyLTkyODQtZjJmNjVmNjI0ZTcwIn0.ZNYWig.-KqQllOh_-5-spvFvz4s8Qka7tM",
    "site_login": "1234567890"
}

400: Response example

403: Response example