User Session

Liquid is obliged to impost first party KYC on end users from the first dollar. To achieve this, the api has implemented user sessions, to track users between KYC/authentication and creating a transaction.

post
Create user session

https://partners.liquid.com/api/v1/session
Request
Response
Request
Body Parameters
public_api_key
required
string
Partner public API key
ancestor_origins
optional
string
Application window ancestor origins
identity
optional
object
Object containing identity proof
user_locale
optional
string
User locale
config
optional
object
Front end application config.
Response
200: OK
New user session
{
"success": true,
"payload": {
"session_id": "e750928c-ef64-4206-9345-ac8d743feb1a",
"session_secret": "201e04f5-03e1-41c2-8245-fc6e54be0e51",
"environment": "PRODUCTION",
"client_info": {
"suggested_country": "JP"
},
"default_transaction": {
"funding_settlement": {
"currency": "JPY",
"quantity": "50"
},
"payout_settlement": {
"currency": "BTC"
}
},
"widget_configuration": null,
"_links": {
"terms_of_service": {
"href": "https://help.liquid.com/en/articles/3969828-quick-exchange-by-liquid-end-user-terms-of-use"
}
}
}
}