createDeal需要签名验签

2024-07-15 08:15

POST /amsin/api/v1/business/fund/createDeal

集成商调用此接口创建远期外汇交易。

在调用本接口之前，确保您已调用createQuote接口获取汇率报价相关信息。

远期外汇交易为异步。调用此接口后，万里汇返回集成商本次API调用结果。集成商需调用inquiryDeal接口查询远期交易结果，或等待万里汇用notifyDeal接口发送通知。

报文结构

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

入参

customerId String REQUIRED

由万里汇定义，用于唯一标识某万里汇账户。

更多信息：

最大长度：64 字符

dealRequestId String REQUIRED

由集成商定义的外汇交易唯一单号。

更多信息：

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

sell Amount object REQUIRED

外汇交易卖出金额。

该字段取值与createQuote响应报文中的sell 字段一致。

Show child parameters

buy Amount object REQUIRED

外汇交易购买金额。

该字段取值与createQuote响应报文中的buy 字段一致。

Show child parameters

exchangeTradeType String

外汇交易类型。

可取值如下：

FORWARD: 指该笔外汇交易的类型为资金不充足的远期交易。
UNFUNDED_SPOT: 指该笔外汇交易的类型为资金不充足的即期交易。

如果该字段未赋值，则默认为FORWARD。

marginCurrency String CONDITIONAL

代表保证金币种，为符合ISO-4217规范的三字母货币代码。如：USD。

当 exchangeTradeType 字段取值为 FORWARD 时，此字段为必传。

更多信息：

最大长度：3 字符

quote Quote object REQUIRED

本次外汇交易的汇率信息。

Show child parameters

forwardType String CONDITIONAL

远期外汇交易的汇率类型。

可取值如下：

FIXED：固定日期
WINDOWED：窗口模式
FLEXIBLE：灵活日期

当 exchangeTradeType 字段取值为FORWARD 时，此字段为必传。

windowStartTime DateTime CONDITIONAL

窗口模式下汇率的开始时间。

字段格式：YYYYMMDD，如 20220212

当forwardType 字段取值为WINDOWED时，此字段为必传。

expiredTime DateTime REQUIRED

汇率过期时间，也即完成本次外汇交易的最晚时间。

字段格式：YYYYMMDD，如 20220212

出参

result Result object REQUIRED

代表API接口的调用结果。

Show child parameters

responseId String REQUIRED

由万里汇定义，用于唯一标识某次响应的ID。

该字段只有当 result.resultStatus =S 时才会按需返回。

更多信息：

最大长度：32 字符

deal Deal object REQUIRED

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

Show child parameters

API Explorer

请求

URL

请求体

响应

响应体

响应处理

集成商调用接口后，万里汇返回集成商API调用结果。result.resultStatus 字段取值范围为：

result.resultCode：系统结果码

结果码	值	结果码信息	行动建议
PROCESSING	S	Create deal successfully.
PARAM_ILLEGAL	F	Illegal parameters exist. For example, a non-numeric input, or an invalid date.	参考API文档页面，确认请求头和传参是否正确
PROCESS_FAIL	F	A general business failure occurred. Do not retry.	需要人工介入，联系万里汇技术支持以解决此问题
UNKNOWN_EXCEPTION	U	API failed due to unknown reason.	服务器错误，若稍后重试问题依旧，联系万里汇技术支持以解决问题
REQUEST_TRAFFIC_EXCEED_LIMIT	U	The request traffic exceeds the limit.	重试，若问题依旧，联系万里汇技术支持
INVALID_API	F	The called API is invalid or not active.	确认是否调用正确的API
INVALID_CLIENT	F	The client is invalid.	Client ID不存在或无效
INVALID_SIGNATURE	F	The signature is invalid.	确认请求正确加签，具体参见：请求头签名部分生成签名
METHOD_NOT_SUPPORTED	F	The server does not implement the requested HTTP method.	确认HTTP请求方法为`POST`

result.resultCode：业务结果码

结果码	值	结果码信息	行动建议
UN_SUPPORT_BUSINESS	F	Unsupported business.	包含无效参数（如货币代码错误），使用正确的参数重试
INVALID_ACCESS_TOKEN	F	Invalid access token	确认使用正确的 accessToken 访问令牌
REPEAT_REQ_INCONSISTENT	F	Repeated requests are inconsistent.	确认请求中所有参数一致重试
CONTRACT_CHECK_FAIL	F	The contract check has failed. 检查合约状态后重试	检查合约状态后重试

result.resultStatus	描述
S	API请求成功。如果 result.resultStatus 为`S`，表示万里汇已接受本次API请求，远期外汇交易正在处理中。调用inquiryDeal以查询远期外汇交易结果。
F	API请求失败。失败原因参见结果码（即 result.resultCode 和 result.resultMessage ）
U	API响应结果为`UNKNOWN`（未知）时，集成商需调用inquiryDeal接口以检查远期外汇交易请求状态。