Notify trade order submission resultSignature required

2024-01-25 07:41

After trade orders are submitted, Worldfirst will call this API to notify the B2C Partners of the trade order submission result.

Structure

A message consists of a header and body. The following sections are focused on the body structure. For the header structure, see:

The unique ID assigned by the Partner to identify a trade order submission request.

More information about this field

This field is an API idempotency field.The Partner can use it to do the idempotent check.
Maximum length: 64 characters

Indicates the list of the trade order results.

Show child parameters

Indicates whether this API is called successfully.

Show child parameters

API Explorer

Request Body

Response Body

tradeOrderResult.errorCode

errorCode	errorMessage	Further action
PARAM_ILLEGAL	Illegal parameters exist. For example, a non-numeric input, or an invalid date.	Check and verify whether the request fields, including the header fields and body fields, are correct and valid. For details on the fields of each API, see the specific API Structure section.
TRADE_ORDER_SUBMITTED	trade order has been submitted before.	Check and verify whether the trade order has been submitted. If so stop submitting it again.
RISK_REJECT	The trade order is rejected for risk control reasons.	Prompt the user that the request is rejected because the risk control failed.
PROCESS_FAIL	A general business failure occurred. Do not retry.	Human intervention is usually needed. It is recommended that you contact WorldFirst Technical Support to resolve the issue.

Code	Value	Message	Further action
SUCCESS	S	Success
UNKNOWN_EXCEPTION	U	The API call failed, which is caused by unknown reasons.	The service might be down, retry later. If the issue persists, contact WorldFirst Technical Support.
PROCESS_FAIL	F	A general business failure occurred. Do not retry.	Human intervention is usually needed. It is recommended that you contact WorldFirst Technical Support to resolve the issue.