文档中心/API 接口

API REFERENCE

汇率查询

POSThttps://mapi.yabandpay.com/Payments
实际接口
API PLAYGROUND · 实际接口

汇率查询

POSThttps://mapi.yabandpay.com/Payments
填写凭据后自动签名

请求参数2

先填写必填项

汇率查询

settlement_currency必填stringdata.settlement_currency币种,详细参数说明
sub_method必填stringdata.sub_methodWeChat Pay,Alipay

凭据仅在当前页面使用。secret_key 不保存,也不发送给文档服务器。

通过该接口可以实时查询到实时的转换汇率,目前支持微信和支付宝的汇率查询。(上午09:00-11:00为汇率波动期)以CNY为结算货币。

参数类型描述是否必填
userString收银员账号的UID必填
signString签名必填
methodStringv3.QueryExchangeRate必填
timeLong时间戳必填
  • 参数
参数类型描述是否必填
settlement_currencyString币种,详细参数说明必填
sub_methodStringWeChat Pay,Alipay必填
  • 币种
国家货币国家货币代码说明
新加坡SGD
挪威克郎NOK
阿联酋迪拉姆AEDWeChat Pay不支持查询
菲律宾比索PHPWeChat Pay不支持查询
瑞典克郎SEK
新西兰元NZD
捷克克郎CZKWeChat Pay不支持查询
马来西亚MYRWeChat Pay不支持查询
英镑GBP
丹麦克郎DKK
欧元EUR
印尼卢比IDRWeChat Pay不支持查询
斯里兰卡卢比LKRWeChat Pay不支持查询
泰铢THB
南非ZARWeChat Pay不支持查询
美元USD
中国澳门MOPWeChat Pay不支持查询
加拿大元CAD
日圆JPY
俄罗斯卢布RUB
韩国KRW
沙特阿拉伯AUD
中国台湾TWDWeChat Pay不支持查询
瑞士法郎CHF
港币HKD

签名示例:

拼接为URL方式并排序后的字符串

"method=v3.QueryExchangeRate&settlement_currency=EUR&sub_method=Alipay&time=1546588959&user=YOUR_CASHIER_UID"

得到的 stringA 使用 secret_key做签名

得到的签名如下:

"YOUR_SIGNATURE"

提交示例:

{
    "user": "YOUR_CASHIER_UID",
    "sign": "YOUR_SIGNATURE",
    "method": "v3.QueryExchangeRate",
    "time": 1546588959,
    "data": {
        "settlement_currency": "EUR",
        "sub_method": "Alipay"
    }
}

返回示例:

{
    "status": true,
    "code": "200",
    "data": {
        "exchange_rate": "7.850000"
    },
    "message": ""
}