收单/付款汇率查询

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

Description

本接口支持根据收单或付款业务查询相应的汇率信息，为您的外汇交易决策提供参考。请注意，查询到的汇率仅供参考，不构成交易承诺。 注：调用此接口前，请确保您已开通相关的业务产品服务。

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

Required

Content-Type: application/json

Field	Type	Required	Constraints	Description	Enum
version	string	Yes		接口版本
keyVersion	string	Yes		密钥版本
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		货币对列表，最大支持40个货币对
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 查询下一期锁汇汇率(此时传送次日日期) - 不支持查询历史过期汇率

Example

{
  "version": "1.5",
  "keyVersion": "1",
  "requestTime": "2022-06-10T20:30:53.732+08:00",
  "appId": "46153e2b787241ae8b01857bb087d1bd",
  "merchantNo": "010229810189301",
  "data": {
    "ccyPairList": [
      {
        "side": "BUY",
        "targetCurrency": "AED",
        "transactionCurrency": "USD"
      },
      {
        "side": "SELL",
        "targetCurrency": "IDR",
        "transactionCurrency": "USD"
      }
    ],
    "product": "PAY_IN"
  }
}

Responses

200

Field	Type	Required	Constraints	Description	Enum
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		错误信息

Response Example

{
  "code": "APPLY_SUCCESS",
  "data": {
    "currencyList": [
      {
        "ccyPair": "USDAED",
        "rate": 3.6844202,
        "rateType": "Reference",
        "side": "BUY",
        "targetCurrency": "AED",
        "transactionCurrency": "USD",
        "rateReferenceId": "payerMax123456",
        "effectTime": "2025-09-11T12:04:13.629Z",
        "expiryTime": "2025-09-11T12:04:13.629Z",
        "validTime": "2025-09-11T12:04:13.629Z"
      },
      {
        "ccyPair": "USDIDR",
        "rate": 15422.562,
        "rateType": "Reference",
        "side": "SELL",
        "targetCurrency": "IDR",
        "transactionCurrency": "USD"
      }
    ]
  },
  "msg": ""
}