Notify trade order submission resultSignature required
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:
Request parameters
requestId String REQUIRED
The unique ID assigned by the Partner to identify a trade order submission request.
More information:
- This field is an API idempotency field.The Partner can use it to do the idempotent check.
- Maximum length: 64 characters
tradeOrderResults Array <TradeOrderResult> REQUIRED
Indicates the list of the trade order results.
Response parameters
result Result REQUIRED
Indicates whether this API is called successfully.
Request
Response
Result/Error codes
| 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. |
tradeOrderResult.errorCode
| Code | Value | Message | Further action |
|---|---|---|---|
| TRADE_ORDER_SUBMITTED | F | trade order has been submitted before. | Check and verify whether the trade order has been submitted. If so stop submitting it again. |
| RISK_REJECT | F | The trade order is rejected for risk control reasons. | Prompt the user that the request is rejected because the risk control failed. |
| 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. |