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.

Create user session

POST https://partners.liquid.com/api/v1/session

Request Body

Name	Type	Description
public_api_key	string	Partner public API key
ancestor_origins	string	Application window ancestor origins
identity	object	Object containing identity proof
user_locale	string	User locale
config	object	Front end application config.

200 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"
      }
    }
  }
}