notifyTradeOrder (Only for B2C)

2023-09-22 17:24

万里汇会调用此接口将交易订单的上传结果通知给集成商。

接口结构

万里汇接口的报文结构包括：请求头、请求体、响应头和响应体。该章节主要介绍请求体和响应体的结构。关于请求头和响应头的更多信息，参见：

请求体

字段名

数据类型

是否必传

描述

requestId

字符串

是

针对单次交易订单上传请求，由集成商指定的唯一请求号。

更多信息：

此字段为业务幂等字段，可用于实现幂等检查。
字段最大长度：64

tradeOrderResults

字符串

是

针对单次交易订单上传请求，由集成商指定的唯一请求号。

更多信息：

此字段为业务幂等字段，可用于实现幂等检查。
字段最大长度：64

响应体

字段名	数据类型	是否必传	描述
result	Result 对象	是	API 调用结果，即交易订单上传的请求结果，包括结果状态和结果详情。

结果码

result.resultCode

resultCode	resultStatus	resultMessage
SUCCESS	S	Success
UNKNOWN_EXCEPTION	U	The API call is failed, which is caused by unknown reasons.
PROCESS_FAIL	F	A general business failure occurred. Do not retry.

tradeOrderResult.errorCode

errorCode	errorMessage	处理建议
PARAM_ILLEGAL	Illegal parameters exist. For example, a non-numeric input, or an invalid date.	检查并确认请求字段是否正确有效，包括请求头和请求体字段。
TRADE_ORDER_SUBMITTED	trade order has been submitted before.	检查并确认交易订单先前是否上传过。如果是，请停止重复上传。
TRADE_ORDER_NOT_EXIST	The trade order does not exist.	使用正确的交易订单信息重传。
RISK_REJECT	The trade order is rejected for risk control reasons.	请联系万里汇技术支持以解决此问题。
PROCESS_FAIL	A general business failure occurred. Do not retry.	请联系万里汇技术支持以解决此问题。

代码示例

请求体

copy
{
    "requestId": "20230222191210001100300007*****",
    "tradeOrderResults": [
      {
        "referenceOrderNo": "50957342066*****",
        "orderStatus": "ACCEPT",
        "resultMessage": "Can be use for declaration.",
        "tradeAmount": {
                "currency": "USD",
                "value": "500"
        },
        "transAmount": {
            "currency": "USD",
            "value": "400"
        },
        "remainAmount": {
            "currency": "USD",
            "value": "400"
        }
      }
    ]
}

响应体

copy
{
    "result": {
        "resultStatus": "S",
        "resultCode": "SUCCESS",
        "resultMessage": "success."
    }
}