自由换汇汇率查询

• Endpoint: POST /aggregate-pay/api/gateway/quoteQuery
• Tags: 外汇(老)

Parameters

Field	In	Type	Required	Constraints	Description
Content-Type	header	string	Yes
sign	header	string	Yes		签名信息请参考技术文档

Parameter Examples

• Content-Type: "application/json"
• sign: "FPFVT3o227JrFRbqu19boZCpVVTF9KznxyRawUmxpfXilHV/0yK46haPhAjNu1hPUMy7Vw/ILXhfzffNm4Fj0apWknlTY9OJxnSoQxS9BTFtc61tn5yV1q69x/kkBl82/qwg+XTJ4fOzy7Mar3VaC1E2PlDA6RkkKBUyNE6RYgsdB+Su7an4+4HVTNAnoe74WyvBgxTLMNg28igBTdqxaO3w/UBY6ObVp7vkqkQGdL1Y+HgmMYaAVwrM3+ALWGId0sJ+YqTY4WJ+0xCRGhaSnybiIjZsQEYyID68WNUfuavDLDsEhaMm/HfQvf5p0R1Ltovp3wwJnEbQcjY458iX5A=="

Request Body

Content-Type: application/json

Field	Type	Required	Constraints	Description	Enum
data	object	Yes
data.ccyPairList	array[string]	Yes		币种对列表长度须大于0且小于25,列表中的币种对为基于美金标价法拼接，需要USD在前，最终效果例如:USDIDR
data.priceTypeList	array[string]	Yes		价格类型列表，买入价BID,卖出价OFFER,默认查询全部
version	string	Yes		接口版本 当前值为：1.2
keyVersion	string	Yes	maxLength: 8	密钥版本 当前值为：1
requestTime	string	Yes	maxLength: 32	请求时间，符合rfc3339规范，格式：yyyy-MM-dd'T'HH:mm:ss.SSSXXX 时间需要在当前时间两分钟内
appId	string	Yes	maxLength: 64	商户应用Id，PayerMax分配给商户应用的唯一标识
merchantNo	string	No	maxLength: 32	商户号，商户与PayerMax业务签约时生成的唯一标识

Example

{
  "version": "1.2",
  "keyVersion": "1",
  "requestTime": "2022-06-10T20:30:53.732+08:00",
  "appId": "46153e2b787241ae8b01857bb087d1bd",
  "merchantNo": "010229810189301",
  "data": {
    "ccyPairList": [
      "USDINR"
    ],
    "priceTypeList": [
      "BID",
      "OFFER"
    ]
  }
}

Responses

200

Field	Type	Required	Constraints	Description	Enum
data	object	Yes		具体响应数据
data.rateList	array[object]	Yes
data.rateList[].ccyPair	string	No
data.rateList[].bidRate	number	No		默认8位小数
data.rateList[].offerRate	number	No		默认8位小数
data.rateList[].rateTime	string	No		格式yyyy-MM-dd'T'HH:mm:ss.SSSXXX
data.rateList[].version	string	No
data.rateList[].expiryTime	string	No		格式yyyy-MM-dd'T'HH:mm:ss.SSSXXX
code	string	Yes		返回码，’APPLY_SUCCESS’代表成功
msg	string	Yes		返回描述，’Success.’

Response Example

{
  "code": "APPLY_SUCCESS",
  "msg": "",
  "data": {
    "rateList": [
      {
        "ccyPair": "USDINR",
        "bidRate": 82.368,
        "offerRate": 82.418,
        "rateTime": "2022-01-22T10:00:00.500+08:00",
        "version": "payerMax123456",
        "expiryTime": "2022-01-22T10:30:00.500+08:00"
      }
    ]
  }
}