notifyAssociationResult需要签名验签
交易单提交成功后,万里汇会调用此接口将交易订单的上传结果通知给B2B集成商。
报文结构
万里汇接口报文结构包括:请求头和请求体。
入参
notifyRequestId String REQUIRED
万里汇定义的交易信息上传结果通知编号
更多信息:
- 此为幂等字段。
- 最大长度:64 字符
extRequestId String REQUIRED
associationResult Result REQUIRED
交易信息上传结果
notificationType String
标识风控审核结果或交易单关联结果的维度。
可选值为以下之一:
ASSOCIATION_RESULT
:整体维度,即多笔交易单关联至收款单的任务是否成功。ASSOCIATION_DETAIL_RESULT
:明细维度,即单笔交易单的风控审核是否通过。
referenceOrderNo String CONDITIONAL
集成商提交的订单参考编号。
当 notificationType =
ASSOCIATION_DETAIL_RESULT
时,此字段为必传。
更多信息:
- 最大长度:64 字符
出参
result Result REQUIRED
代表接口调用结果
请求
响应
请求处理
在请求报文中:
- associationResult.resultCode:代表交易信息上传结果,具体参见结果码 AssociationResult 部分。
- 注:集成商调用 submitTradeOrder 接口后,万里汇后续订单创建、订单关联和审核订单操作均为异步操作。上述异步任务过程中,由于订单或者入帐单变化(如入帐单已退款)导致的执行失败,无法通过重试恢复。集成商需更新订单信息、更换reqeustId,重新调用 submitTradeOrder 接口进行交易信息上传。
在收到万里汇的请求之后,电商端需要向万里汇发送响应信息,以确认信息已收到。
发送响应信息前,需要正确加签。
响应头信息包括:
响应头参数 | 是否必填 | 范例 |
Signature | 是 | Signature: algorithm=RSA256, keyVersion=2, signature=**** |
Content-Type | 是 | Content-Type: application/json; charset=UTF-8 |
Client-Id | 是 | Client-Id: **** |
Response-Time | 是 | Response-Time: 2019-04-04T12:08:56+08:00 |
响应体范例:
如果电商端不向万里汇发送响应信息,万里汇会重新发送请求通知。万里汇重发通知的规则为:
- 重试总数:7次
- 两次重发请求之间的间隔:2分钟,10分钟,10分钟,1小时,2小时,6小时,15小时
Result.resultCode
结果码 | 值 | 结果码信息 | 行动建议 |
---|---|---|---|
SUCCESS | S | Success | |
PROCESS_FAIL | F | A general business failure occurred. Do not retry. | 需要人工介入,联系万里汇技术支持以解决此问题 |
UNKNOWN_EXCEPTION | U | The API call is failed, which is caused by unknown reasons. | 服务器错误,若稍后重试问题依旧,联系万里汇技术支持以解决问题 |
AssociationResult.resultCode
结果码 | 值 | 结果码信息 | 行动建议 |
---|---|---|---|
ASSOCIATION_FAILED | F | Invalid parameter exists (wrong data type, wrong data length, or unspecified parameter). | 修改订单或关联信息,更换订单 reqeustId,发起重试。 |
ASSOCIATION_FAILED | F | Invalid amount parameter exists. | 修改订单或关联信息,更换订单 reqeustId,发起重试。 |
ASSOCIATION_FAILED | F | tradeType values are inconsistent for trade orders. | 修改订单或关联信息,更换订单 reqeustId,发起重试。 |
ASSOCIATION_FAILED | F | Abnormal collection order. | 已退款的入账单无法发起订单批量同步和订单关联。 确认该入账单处于入账成功状态。 |
ASSOCIATION_FAILED | F | Access denied. | 无法进行订单批量同步和订单关联。联系万里汇技术支持,咨询具体原因。 |
ASSOCIATION_FAILED | F | tradeType of trade order is not supported. | 该类型订单无法进行交易信息上传和订单关联。 联系万里汇技术支持,咨询具体原因。 |
ASSOCIATION_FAILED | F | Abnormal trade order exists. | 订单状态异常,联系万里汇技术支持,咨询具体原因。 |
ASSOCIATION_FAILED | F | The number of associated trade orders exceeds limit. | 修改订单同步条数,更换订单reqeustId,发起重试。 |
ASSOCIATION_FAILED | F | The intended association amount is incorrect. | 修改订单关联金额,更换订单reqeustId,发起重试。 注:不可修改已上传成功的订单金额 |
ASSOCIATION_FAILED | F | tradeType values are inconsistent for partial associations of the same collection order. | 修改订单类型后,更换订单reqeustId,发起重试。 |
ASSOCIATION_FAILED | F | An internal system error has occurred. Do not retry. | 联系万里汇技术支持以解决该问题。 |
ORDER_SUBMISSION_FAILED | F | Invalid parameter exists (wrong data type, wrong data length, or unspecified parameter). | 修改订单或关联信息,更换订单 reqeustId,发起重试。 |
ORDER_SUBMISSION_FAILED | F | Invalid amount parameter exists. | 修改订单或关联信息,更换订单 reqeustId,发起重试。 |
ORDER_SUBMISSION_FAILED | F | tradeType values are inconsistent for trade orders. | 修改订单或关联信息,更换订单 reqeustId,发起重试。 |
ORDER_SUBMISSION_FAILED | F | Abnormal collection order. | 已退款的入账单无法发起订单批量同步和订单关联。 确认该入账单处于入账成功状态。 |
ORDER_SUBMISSION_FAILED | F | Access denied. | 无法进行订单批量同步和订单关联。联系万里汇技术支持,咨询具体原因。 |
ORDER_SUBMISSION_FAILED | F | tradeType of trade order is not supported. | 该类型订单无法进行交易信息上传和订单关联。 联系万里汇技术支持,咨询具体原因。 |
ORDER_SUBMISSION_FAILED | F | Abnormal trade order exists. | 订单状态异常,联系万里汇技术支持,咨询具体原因。 |
ORDER_SUBMISSION_FAILED | F | The number of associated trade orders exceeds limit. | 修改订单同步条数,更换订单reqeustId,发起重试。 |
ORDER_SUBMISSION_FAILED | F | The intended association amount is incorrect. | 修改订单关联金额,更换订单reqeustId,发起重试。 注:不可修改已上传成功的订单金额 |
ORDER_SUBMISSION_FAILED | F | tradeType values are inconsistent for partial associations of the same collection order. | 修改订单类型后,更换订单reqeustId,发起重试。 |
ORDER_SUBMISSION_FAILED | F | An internal system error has occurred. Do not retry. | 联系万里汇技术支持以解决该问题。 |
VERIFICATION_DENIED | F | The verification has been denied. | 本次订单同步失败,无法通过修改订单内容再次重试。 联系万里汇技术支持以解决该问题。 |
ADDITIONAL_FILE_NEEDED | F | Additional file is needed for the verification. | 本次订单同步需要补件。登录WF网站,人工补充材料。 |
VERIFICATION_PASSED | S | The verification has passed. |