notifyAssociationResult需要签名验签

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

报文结构

万里汇接口报文结构包括:请求头和请求体。

入参

notifyRequestId String  REQUIRED

万里汇定义的交易信息上传结果通知编号

更多信息:

  • 此为幂等字段。
  • 最大长度:64 字符

extRequestId String  REQUIRED

集成商指定的交易信息上传请求编号

有关此字段的更多信息:

  • 本字段与 submitTradeOrder 接口定义的 requestId 相同
  • 最大长度:64 字符

associationResult Result object REQUIRED

交易信息上传结果

Show child parameters

notificationType String  

标识风控审核结果或交易单关联结果的维度。

可选值为以下之一:

  • ASSOCIATION_RESULT:整体维度,即多笔交易单关联至收款单的任务是否成功。
  • ASSOCIATION_DETAIL_RESULT:明细维度,即单笔交易单的风控审核是否通过。

referenceOrderNo String  CONDITIONAL

集成商提交的订单参考编号。

notificationType = ASSOCIATION_DETAIL_RESULT时,此字段为必传

更多信息:

  • 最大长度:64 字符

出参

result Result object REQUIRED

代表接口调用结果

Show child parameters
API Explorer

请求

请求体

响应

响应体

请求处理

在请求报文中:

  • 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


响应体范例:

Sample Code


如果电商端不向万里汇发送响应信息,万里汇会重新发送请求通知。万里汇重发通知的规则为:

  • 重试总数:7次
  • 两次重发请求之间的间隔:2分钟,10分钟,10分钟,1小时,2小时,6小时,15小时

Result.resultCode

结果码结果码信息行动建议
SUCCESSSSuccess
PROCESS_FAILFA general business failure occurred. Do not retry.

需要人工介入,联系万里汇技术支持以解决此问题

UNKNOWN_EXCEPTIONUThe API call is failed, which is caused by unknown reasons.

服务器错误,若稍后重试问题依旧,联系万里汇技术支持以解决问题

AssociationResult.resultCode

结果码结果码信息行动建议
ASSOCIATION_FAILEDFInvalid parameter exists (wrong data type, wrong data length, or unspecified parameter).

修改订单或关联信息,更换订单 reqeustId,发起重试。

ASSOCIATION_FAILEDFInvalid amount parameter exists.

修改订单或关联信息,更换订单 reqeustId,发起重试。

ASSOCIATION_FAILEDFtradeType values are inconsistent for trade orders.

修改订单或关联信息,更换订单 reqeustId,发起重试。

ASSOCIATION_FAILEDFAbnormal collection order.

已退款的入账单无法发起订单批量同步和订单关联。

确认该入账单处于入账成功状态。

ASSOCIATION_FAILEDFAccess denied.

无法进行订单批量同步和订单关联。联系万里汇技术支持,咨询具体原因。

ASSOCIATION_FAILEDFtradeType of trade order is not supported.

该类型订单无法进行交易信息上传和订单关联。

联系万里汇技术支持,咨询具体原因。

ASSOCIATION_FAILEDFAbnormal trade order exists.

订单状态异常,联系万里汇技术支持,咨询具体原因。

ASSOCIATION_FAILEDFThe number of associated trade orders exceeds limit.

修改订单同步条数,更换订单reqeustId,发起重试。

ASSOCIATION_FAILEDFThe intended association amount is incorrect.

修改订单关联金额,更换订单reqeustId,发起重试。

注:不可修改已上传成功的订单金额

ASSOCIATION_FAILEDFtradeType values are inconsistent for partial associations of the same collection order.

修改订单类型后,更换订单reqeustId,发起重试。

ASSOCIATION_FAILEDFAn internal system error has occurred. Do not retry.

联系万里汇技术支持以解决该问题。

ORDER_SUBMISSION_FAILEDFInvalid parameter exists (wrong data type, wrong data length, or unspecified parameter).

修改订单或关联信息,更换订单 reqeustId,发起重试。

ORDER_SUBMISSION_FAILEDFInvalid amount parameter exists.

修改订单或关联信息,更换订单 reqeustId,发起重试。

ORDER_SUBMISSION_FAILEDFtradeType values are inconsistent for trade orders.

修改订单或关联信息,更换订单 reqeustId,发起重试。

ORDER_SUBMISSION_FAILEDFAbnormal collection order.

已退款的入账单无法发起订单批量同步和订单关联。

确认该入账单处于入账成功状态。

ORDER_SUBMISSION_FAILEDFAccess denied.

无法进行订单批量同步和订单关联。联系万里汇技术支持,咨询具体原因。

ORDER_SUBMISSION_FAILEDFtradeType of trade order is not supported.

该类型订单无法进行交易信息上传和订单关联。

联系万里汇技术支持,咨询具体原因。

ORDER_SUBMISSION_FAILEDFAbnormal trade order exists.

订单状态异常,联系万里汇技术支持,咨询具体原因。

ORDER_SUBMISSION_FAILEDFThe number of associated trade orders exceeds limit.

修改订单同步条数,更换订单reqeustId,发起重试。

ORDER_SUBMISSION_FAILEDFThe intended association amount is incorrect.

修改订单关联金额,更换订单reqeustId,发起重试。

注:不可修改已上传成功的订单金额

ORDER_SUBMISSION_FAILEDFtradeType values are inconsistent for partial associations of the same collection order.

修改订单类型后,更换订单reqeustId,发起重试。

ORDER_SUBMISSION_FAILEDFAn internal system error has occurred. Do not retry.

联系万里汇技术支持以解决该问题。

VERIFICATION_DENIEDFThe verification has been denied.

本次订单同步失败,无法通过修改订单内容再次重试。

联系万里汇技术支持以解决该问题。

ADDITIONAL_FILE_NEEDEDFAdditional file is needed for the verification.

本次订单同步需要补件。登录WF网站,人工补充材料。

VERIFICATION_PASSEDSThe verification has passed.

@2024 WorldFirst