Receive association result notificationSignature required
After trade orders are submitted, Worldfirst will call this API to notify the B2B 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
notifyRequestId String REQUIRED
The notification number of trade submission results defined by WorldFirst
More information:
- This field is an API idempotency field.
- Maximum length: 64 characters
extRequestId String REQUIRED
The request number of trade submission results assigned by the Partner
More information about this field:
- This field is identical to the requestId defined by submitTradeOrder API.
- Maximum length: 64 characters
associationResult Result REQUIRED
The trade submission result
notificationType String
The dimension of risk audit results or order association results.
Valid values are:
ASSOCIATION_RESULT: indicates whether the association of trade orders to the fund order is successful.ASSOCIATION_DETAIL_RESULT: indicates whether the risk control review of the trade order has passed.
referenceOrderNo String CONDITIONAL
Indicates the trade order number provided by the partner.
This parameter is required when notificationType is
ASSOCIATION_DETAIL_RESULT.
More information:
- Maximum length: 64 characters
Response parameters
result Result REQUIRED
Result of API calling
Request
Response
Request processing logic
In the request message:
- associationResult.resultCode: indicates the trade submission result, see AssociationResult section in result code for details.
Note: After the Partner calls submitTradeOrder API, WorldFirst create, associate, and verify trade orders, which are asynchronous operations. In the process, it can not be retrieved by retrying, in the case that the operation fails due to the change of trade or collection order, for example, a collection order is refunded. The Partner needs to update the order, change the reqeustId, and retry calling submitTradeOrder API to submit the order.
After receiving the notification, you need to send a response message to acknowledge the receipt of the notification.
Make sure you properly sign the message before sending the response. For details, refer to the Sign a request and validate the signature chapter.
For more details on the response header, refer to the API overview chapter.
The response body has the following fixed value:
In the absense of an ackowledgement reponse from the Partner, WorldFirst will resend the result.
The following policy represents how WorldFirst makes retry attempts:
- WorldFirst retries notifications 7 times.
- Intervals between notifications: 2m, 10m, 10m, 1h, 2h, 6h, and 15h.
AssociationResult.resultCode
| Code | Value | Message | Further action |
|---|---|---|---|
| ASSOCIATION_FAILED | F | Invalid parameter exists (wrong data type, wrong data length, or unspecified parameter). | Update the trade order or its associated information, change order reqeustId, and retry. |
| ASSOCIATION_FAILED | F | Invalid amount parameter exists. | Update the trade order or its associated information, change order reqeustId, and retry. |
| ASSOCIATION_FAILED | F | tradeType values are inconsistent for trade orders. | Update the trade order or its associated information, change order reqeustId, and retry. |
| ASSOCIATION_FAILED | F | Abnormal collection order. | The refunded collection order can not be synchronized in batch or associated. Verify the collection order is in success status. |
| ASSOCIATION_FAILED | F | Access denied. | The order can not be synchronized in batch or associated. Contact WorldFirst technical support for a specific reason. |
| ASSOCIATION_FAILED | F | tradeType of a trade order is not supported. | This type of order can not be submitted or associated. Contact WorldFirst technical support for a specific reason. |
| ASSOCIATION_FAILED | F | Abnormal trade order exists. | The order is abnormal. Contact WorldFirst technical support for a specific reason. |
| ASSOCIATION_FAILED | F | The number of associated trade orders exceeds the limit. | Update the number of order associations, change order reqeustId, and retry. |
| ASSOCIATION_FAILED | F | The intended association amount is incorrect. | Update the associated order amount, change order reqeustId, and retry. Note: The submitted order amount can not be modified. |
| ASSOCIATION_FAILED | F | tradeType values are inconsistent for partial associations of the same collection order. | Update order type, change order reqeustId, and retry. |
| ASSOCIATION_FAILED | F | An internal system error has occurred. Do not retry. | Contact WorldFirst technical support. |
| ORDER_SUBMISSION_FAILED | F | Invalid parameter exists (wrong data type, wrong data length, or unspecified parameter). | Update the order or its associated information, change order reqeustId, and retry. |
| ORDER_SUBMISSION_FAILED | F | Invalid amount parameter exists. | Update the order or its associated information, change order reqeustId, and retry. |
| ORDER_SUBMISSION_FAILED | F | tradeType values are inconsistent for trade orders. | Update the order or its associated information, change order reqeustId, and retry. |
| ORDER_SUBMISSION_FAILED | F | Abnormal collection order. | The refunded collection order can not be synchronized in batch or associated. Verify if it is in the status of success. |
| ORDER_SUBMISSION_FAILED | F | Access denied. | The order can not be associated in batch or associated. Contact WorldFirst technical support for a specific reason. |
| ORDER_SUBMISSION_FAILED | F | tradeType of a trade order is not supported. | This type of order can not be submitted or associated. Contact WorldFirst technical support for a specific reason. |
| ORDER_SUBMISSION_FAILED | F | Abnormal trade order exists. | The order is abnormal. Contact WorldFirst technical support for a specific reason. |
| ORDER_SUBMISSION_FAILED | F | The number of associated trade orders exceeds the limit. | Update the number of order associations, change order reqeustId, and retry. |
| ORDER_SUBMISSION_FAILED | F | The intended association amount is incorrect. | Update the associated order amount, change order reqeustId, and retry. Note: The submitted order amount can not be modified. |
| ORDER_SUBMISSION_FAILED | F | tradeType values are inconsistent for partial associations of the same collection order. | Update order type, change order reqeustId, and retry. |
| ORDER_SUBMISSION_FAILED | F | An internal system error has occurred. Do not retry. | Contact WorldFirst technical support. |
| VERIFICATION_DENIED | F | The verification has been denied. | The order synchronization fails. The order update is denied. Contact WorldFirst technical support. |
| ADDITIONAL_FILE_NEEDED | F | An additional file is needed for the verification. | An additional file is in need of order association. Log in WorldFirst and provide supplemental materials manually. |
| VERIFICATION_PASSED | S | The verification has passed. |
Result.resultCode
| Code | Value | Message |
|---|---|---|
| SUCCESS | S | Success |
| PROCESS_FAIL | F | A general business failure occurred. Do not retry. |
| UNKNOWN_EXCEPTION | U | The API call fails, which is caused by unknown reasons. |