Skip to content
Structured Product Trading

Run Structured Product Pre-Order Check

Call it when the Client taps Buy on the product detail page. It checks whether the Client and product meet the order conditions: product status, account status, risk level match, derivatives knowledge assessment, and risk assessment validity. It only checks and creates no order. Handle the result in this order:

  1. error_type is 4: the Client has not completed the derivatives knowledge assessment. Let the Client complete it, record the result through POST /v1/record/questionnaire with type set to derivatives.HK, then call this operation again.
  2. error_type is 7: the risk assessment has expired. Show message and guide the Client to reassess.
  3. error_type is 3: the risk level does not match. An empty risk_level means the Client has not completed a risk assessment. Show message and guide the Client to take or retake the assessment.
  4. Any other non-empty validate_list: show message and block the order.
  5. Empty validate_list: the check passed. If the product is a complex product (complex_product=1 from GET /v2/wms/product/detail), let the Client confirm the complex product declaration first, then open the order page and call GET /v1/wms/orders/data_info.

If the request fails, show message and do not open the order page.

GEThttps://api.lbkrs.com/v1/wms/orders/check

Parameters

counter_idstringqueryRequired

Structured product code

idea_idstringquery

Product idea ID from the product list

Responses

HTTP 200The request succeeded. The response body contains the result of the “Run Structured Product Pre-Order Check” operation.
Standard response envelopecodemessagedata
dataobjectdata structure
validate_listarray<object>

Failed check items. Empty means the check passed

Child attributes
keystring

Check item key

messagestring

Reason the check failed. Show it to the Client as is

is_forceboolean

Whether the item is mandatory

error_typeinteger

Type of the failed check. 0 or absent means passed:

  • 1 - Product check failed
  • 2 - Account check failed
  • 3 - Risk level check failed
  • 4 - Derivatives knowledge assessment not completed
  • 7 - Risk assessment expired
risk_levelstring

Client's current risk level. Empty means the Client has not completed a risk assessment

Whale Docs