createExchange
入参
exchangeRequestId String REQUIRED
商户为识别外汇交付请求分配的专属 ID。
更多信息：
- 此为幂等字段。
buyAmount Amount REQUIRED
外汇购买金额。
sellAmount Amount REQUIRED
外汇售出金额。
quote Object REQUIRED
账户外汇交付请求的外汇汇率信息。
exchangeMode String REQUIRED
外汇交付模式。可能的值包括：
APPOINTED：表示指定时间的汇率。
exchangeTradeType String REQUIRED
外汇交付类型。可能的值包括：
SPOT: 实时汇率。
出参
result Object REQUIRED
表明此接口是否调用成功。
exchangeRequestId String
商户为识别外汇交付请求分配的专属 ID。
更多信息：
- 最大长度：64 字符
exchangeTradeType String
外汇交付类型。可能的值包括：
SPOT: 实时汇率。
exchangeMode String
外汇交付模式。可能的值包括：
-
APPOINTED：表示指定时间的汇率。
quote Object
账户外汇交付请求的外汇汇率信息。
buyAmount Amount REQUIRED
购买的外汇金额。
sellAmount Amount REQUIRED
出售的外汇金额。
exchangeStartTime Datetime REQUIRED
外汇交割请求发起的时间。
更多信息：
- 值遵循 ISO 8601 标准格式。例如，“2019-11-27T12:01:01+08:00”。
API Explorer
请求
URL
Method
POST
响应
结果码
| 结果码 | 值 | 结果码信息 | 行动建议 |
|---|---|---|---|
| SUCCESS | S | 成功。 | 交易成功，无需进一步操作。 |
| PROCESSING | S | 转账正在处理中 | 兑换已创建并正在处理。 |
| PARAM_ILLEGAL | F | 存在非法参数 | 检查并验证请求字段（包括头部字段和正文字段）是否正确且有效。有关各接口字段的详细信息，请参阅具体的接口结构部分。 |
| PROCESS_FAIL | F | 业务处理失败 | 通常需要人工干预。建议您联系 Antom 技术支持以解决问题。 |
| UNKNOWN_EXCEPTION | U | 接口因未知原因调用失败 | 服务可能不可用，请稍后重试。如果问题仍然存在，请联系 Antom 技术支持。 |
| REQUEST_TRAFFIC_EXCEED_LIMIT | U | 请求流量超过限制 | 重新调用接口以解决该问题。如果问题仍然存在，请联系 Antom 技术支持。 |
| USER_NOT_EXIST | F | 用户不存在 | 请使用正确的用户信息重试。 |
| USER_NO_PERMISSION | F | 用户无权限 | 请使用其他用户信息重试。 |
| ACCOUNT_STATUS_ABNORMAL | F | 账户状态异常 | 请使用其他用户重试。如果问题仍然存在，请联系 Antom 技术支持以获取更多详情。 |
| REPEAT_REQ_INCONSISTENT | F | 重复请求不一致 | 确保请求中的所有字段一致后重试。 |
| USER_STATUS_ABNORMAL | F | 用户状态异常 | 用户状态异常，请使用其他用户创建新的兑换订单。 |
| BALANCE_NOT_ENOUGH | F | 余额不足 | 请确保余额充足后重试。 |
| AMOUNT_EXCEED_LIMIT | F | 金额超过允许的上限 | 请确保提交的金额正确后重试。 |
| CURRENCY_NOT_SUPPORT | F | 不支持该币种 | 请确保输入的币种正确后重试。 |
| CONTRACT_NOT_EXIST | F | 合同不存在 | 请确保合作伙伴已签署合同，并确认输入信息是否正确。 |
| CONTRACT_CHECK_FAIL | F | 合同检查失败 | 请确保合作伙伴已签署合同，并确认输入信息是否正确。 |
| INVALID_API | F | 调用的接口无效或未启用 | 请确认是否调用了正确的接口。 |
| INVALID_CLIENT | F | 客户端无效 | 客户端 ID 不存在或无效。 |
| INVALID_SIGNATURE | F | 签名无效 | 请确保请求已使用有效的签名正确签名。 |
| METHOD_NOT_SUPPORTED | F | 服务器未实现请求的 HTTP 方法 | 请确保 HTTP 方法为 POST。 |
| QUOTE_EXPIRED | F | 报价已过期 | 调用 createQuote 接口创建新的报价，并使用新报价重试创建结算请求。 |