WorldFirst DocsWorldFirst DocsDOCS

notifyDeal需要签名验签

万里汇使用此接口向集成商发送远期外汇交易结果通知。集成商收到通知后需做出回应。

报文结构

万里汇接口报文结构包括：请求头，请求体。关于头信息，详见：

入参

deal Deal object REQUIRED

远期外汇交易的交易明细。

Show child parameters

dealResult Result object REQUIRED

代表远期外汇交易结果。

Show child parameters

出参

result Result object REQUIRED

代表API接口的调用结果。

Show child parameters
API Explorer

请求

请求体

响应

响应体

处理逻辑

万里汇通过在请求中指定 dealResult.result 参数向集成商发送创建本次外汇交易订单的结果。有关详细信息，请参阅以下 dealResult.resultCode 部分。在收到万里汇的请求之后，集成商需要向万里汇发送响应信息，以确认信息已收到。

发送响应信息前，集成商需正确加签。请参考以下示例。

详见：生成签名及加验签 及 响应头 章节。

Sample Code

如果集成商不向万里汇发送响应信息，万里汇会重新发送请求通知。万里汇重发通知的规则为：

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

dealResult.resultCode

结果码值结果码信息
SUCCESSSThe deal is successfully completed.
PROCESSINGSThe forward deal is being processed.
CANCELLEDFThe forward deal is canceled.
FAILFThe forward deal has failed.

result.resultCode：系统结果码

结果码值结果码信息行动建议
SUCCESSSSuccess
PARAM_ILLEGALFIllegal parameters exist. For example, a non-numeric input, or an invalid date.

参考API文档页面，确认请求头和传参是否正确

PROCESS_FAILFA general business failure occurred. Do not retry.

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

UNKNOWN_EXCEPTIONUAPI failed due to unknown reason.

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

REQUEST_TRAFFIC_EXCEED_LIMITUThe request traffic exceeds the limit.

重试，若问题依旧，联系万里汇技术支持

INVALID_APIFThe called API is invalid or not active.

确认是否调用正确的API

INVALID_CLIENTFThe client is invalid.

Client ID不存在或无效

INVALID_SIGNATUREFThe signature is invalid.

确认请求正确加签，具体参见：

METHOD_NOT_SUPPORTEDFThe server does not implement the requested HTTP method.

确认HTTP请求方法为​POST​

result.resultCode：业务结果码

结果码值结果码信息行动建议
UN_SUPPORT_BUSINESSFUnsupported business.

包含无效参数（如货币代码错误），使用正确的参数重试

AUTHORIZATION_NOT_EXISTFThe authorization does not exist.

当前授权关系不存在，请联系万里汇技术支持检查授权关系

CONTRACT_CHECK_FAILFThe contract check has failed.

检查合约状态后重试

@2024 WorldFirst