收单/付款汇率查询
- Endpoint:
POST /aggregate-pay/api/gateway/queryClientExchangeRate - Tags: 外汇(新)
Description
本接口支持根据收单或付款业务查询相应的汇率信息，为您的外汇交易决策提供参考。请注意，查询到的汇率仅供参考，不构成交易承诺。 注：调用此接口前，请确保您已开通相关的业务产品服务。
Parameters
| Field | Type | Required | Description |
|---|---|---|---|
Content-Type (header) | string | Yes | |
sign (header) | string | Yes | 签名信息请参考技术文档 |
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
version | string | Yes | 接口版本，当前值为：1.5 |
keyVersion | string | Yes | 密钥版本，当前值为：1 |
requestTime | string | Yes | 请求时间，符合rfc3339规范，格式：yyyy-MM-dd'T'HH:mm:ss.SSSXXX 时间需要在当前时间两分钟内 |
appId | string | Yes | 商户应用Id，PayerMax分配给商户应用的唯一标识 |
merchantNo | string | Yes | 商户号，商户与PayerMax业务签约时生成的唯一标识 |
data | object | Yes | 请求数据体 |
data.ccyPairList | array[object] | Yes | 货币对列表，最大支持80个货币对 |
data.ccyPairList[].side | string | Yes | 买卖方向，站在客户的视角,对于交易币种的买卖方向 BUY / SELL |
data.ccyPairList[].targetCurrency | string | Yes | 外汇目标币种 |
data.ccyPairList[].transactionCurrency | string | Yes | 外汇交易币种 |
data.product | string | Yes | 业务产品类型，PAY_IN收单 / PAY_OUT付款 |
data.validTime | string | No | 指定查询汇率的日期，格式: yyyyMMdd 此字段仅适用于收单锁汇场景 - 未开通锁汇情况下该字段无效(默认返回当前汇率) - 收单锁汇场景 - 如该字段为空则默认返回当期锁汇汇率 - 可提前 15min 查询下一期锁汇汇率(此时传送次日日期) - 不支持查询历史过期汇率 |
Responses
200
| Field | Type | Required | Description |
|---|---|---|---|
code | string | Yes | 查询结果状态 |
data | object | Yes | 返回数据体 |
data.currencyList | array[object] | Yes | 币种对列表 |
data.currencyList[].ccyPair | string | Yes | 币种对，外汇交易币种/外汇目标币种 |
data.currencyList[].rate | number | Yes | 汇率，代表一个单位的交易币种等于多少目标币种 |
data.currencyList[].rateType | string | Yes | 汇率类型，仅供参考还是可交易 1、非锁汇产品,只支持reference(汇率仅参考) 2、PAYIN锁汇产品,可支持Tradable和Reference;如果有交易需求,可联系PM商务经理沟通 |
data.currencyList[].side | string | Yes | 买卖方向，站在客户视角，对于交易币种的买卖方向 |
data.currencyList[].targetCurrency | string | Yes | 外汇目标币种 |
data.currencyList[].transactionCurrency | string | Yes | 外汇交易币种 |
data.currencyList[].rateReferenceId | string | Yes | 汇率唯一id |
data.currencyList[].validTime | string | No | 汇率最后可使用时间(隐含延长期) 超过这个时间系统会进行拦截，该汇率不再可交易 只有汇率Tradable场景,才会返回该字段 格式：yyyy-MM-dd'T'HH:mm:ss.SSSXXX |
data.currencyList[].expiryTime | string | No | 汇率过期时间 代表汇率已过期，理论上不应该使用 只有汇率Tradable场景,才会返回该字段 格式：yyyy-MM-dd'T'HH:mm:ss.SSSXXX |
data.currencyList[].effectTime | string | No | 汇率生效时间 代表最早可以使用这个汇率的时间 只有汇率Tradable场景,才会返回该字段 格式：yyyy-MM-dd'T'HH:mm:ss.SSSXXX |
msg | string | No | 错误信息 |