notifyExchange需要签名验签

万里汇使用此接口向集成商发送外汇交割结果通知。

报文结构

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

入参

exchangeResult Result  REQUIRED

外汇交割到户请求结果。参见:请求处理

Show child parameters

exchangeId String  REQUIRED

由万里汇定义的,本次外汇交割到户请求的唯一ID。

更多信息:

  • 最大长度:64 字符

exchangeRequestId String  REQUIRED

由集成商定义,代表本次外汇交割到户请求的唯一ID。

更多信息:

  • 最大长度:128 字符

sell QuoteAmount  REQUIRED

卖出外汇金额。

Show child parameters

buy QuoteAmount  REQUIRED

买入外汇金额。

Show child parameters

exchangeCreateTime DateTime  CONDITIONAL

外汇交割到户请求的发起时间。

createExchange API中的 exchangeRequestTime 字段不为空时,此字段为必传

更多信息:

  • 值遵循 ISO 8601 标准格式。例如,“2019-11-27T12:01:01+08:00”。

exchangeFinishTime DateTime  REQUIRED

外汇交割到户请求的完成时间。

更多信息:

  • 值遵循 ISO 8601 标准格式。例如,“2019-11-27T12:01:01+08:00”。

quote Quote  REQUIRED

本次外汇交割到户请求的外汇汇率信息。

Show child parameters

exchangeMode String  REQUIRED

外汇交割模式。

可取值范围:

  • REALTIME:实时交割
  • APPOINTED:指定日期交割

exchangeTradeType String  REQUIRED

外汇交割类型。

可取值范围:

  • SPOT:即时汇率
  • FORWARD:远期汇率
  • UNFUNDED_SPOT: 远期汇率

exchangeUnfundedInfo ExchangeForwardInfo  CONDITIONAL

外汇交割相关信息。

result.resultStatus =SexchangeTradeType取值为UNFUNDED_SPOT时,此字段为必传

Show child parameters

exchangeForwardInfo ExchangeForwardInfo  CONDITIONAL

外汇交割相关信息。

result.resultStatus =SexchangeTradeType取值为FORWARD时,此字段为必传

Show child parameters

出参

result Result  REQUIRED

代表API接口的调用结果。

Show child parameters
API Explorer

请求

请求体

响应

响应体

处理逻辑

万里汇通过在请求中指定 exchangeResult.result 参数向集成商发送创建本次外汇交易订单的结果。有关详细信息,请参阅以下 exchangeResult.resultCode 部分。

在收到万里汇的请求之后,集成商需要向万里汇发送响应信息,以确认信息已收到。

发送响应信息前,集成商需正确加签。详见:生成签名及加验签 章节。

关于响应信息的头参数,详见:API概览-响应报文结构

响应体范例:

Sample Code
如果集成商不向万里汇发送响应信息,万里汇会重新发送请求通知。

万里汇重发通知的规则为:

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

exchangeResult.resultCode

结果码结果码信息行动建议
SUCCESSSThe deal is successfully completed.
PROCESS_FAILFA general business failure occurred. Do not retry.

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

@2024 WorldFirst