支付牌价查询接口

功能概述

商户通过向首信易支付指定的 URL 发送牌价查询请求，并接收首信易支付返回的结果数据。

接口地址

https://apis.5upay.com/listprice/obtain

参数名称 参数中文名称 类型& 长度 参数说明 是否必填
merchantId 商户编号 varchar(20) 商户在首信易系统的唯一身份标识，商户完成首信易系统注册后可登录商户后台商户服务查看。 M
requestId 订单号 varchar(50) 订单号为商户自行拟定，提交的订单号必须在自身平台交易中唯一。 M
sourceCurrency 源币种 varchar(3) 美元USD、欧元EUR、英镑GBP、加拿大元CAD、澳大利亚元AUD、港币HKD、新加坡元SGD、瑞士法郎CHF、瑞典克朗SEK、丹麦克朗DKK、挪威克朗NOK、澳门元MOP、日元JPY M
targetCurrency 目标币种 varchar(3) 目前仅支持 人民币CNY M
channel 通道 固定值 默认传空 O
dealtSide 处理方 固定值 BUY（银行现汇买入价） M
SELL（银行现汇卖出价）
hmac 参数签名 varchar(500) 商户生成的参数签名结果，获取hmac的方法请参考请求加密流程 M

参数示例

{ "merchantId":"896667346", "requestId":"1622441006184", "sourceCurrency":"USD", "targetCurrency":"CNY", "channel":"", "dealtSide":"SELL", "hmac":"G8Qv/r+KOhPWwHQJhJwEjNgIl5VFRYfBO5+Lg82Wr8fIA3//QfZMCdvtGJDmUXKC8lneekR3VFrb+2w5t2UNLa HGldVo9muxYe3kbUrCFtCgsVB1BsypO9tuqbVAKOtdyBjZJCJXbCouQ2tdYAES19vqZ2ZGRG2Os3tpsJUfnZUUdGYX1mQC LqQy2a02IrDmGxfgHbG/h1137og94pdGowBe8oiyDvqOSddy8KQ+4z4CailfrxjBfz3uSGOZdiUDkiSMIhYnb9fm7uqJKw 8+fmvPQY9v9/GbFbccKE8efXaFJQzhfyKo5GCin0csvohH7IHIC5JR0rbhlwPtNdyh+g==" }

返回参数列表

参数名称 参数中文名称 参数说明
merchantId 商户编号 同请求参数
sourceCurrency 源币种 美元USD、欧元EUR、英镑GBP、加拿大元CAD、澳大利亚元AUD、港币HKD、新加坡元SGD、瑞士法郎CHF、瑞典克朗SEK、丹麦克朗DKK、挪威克朗NOK、澳门元MOP、日元JPY
targetCurrency 目标币种 人民币CNY
listprice 牌价 例： listprice":622.190000,"意味622.19CNY可以换100USD
listpriceDateTime 牌价时间 例：2020-08-05 00:00:00
tradeUnit 货币交易单位 货币交易单位
status 请求状态 请求状态
FAILED 失败
ERROR 错误
resMessage 请求状态信息 请求状态信息
hmac 参数签名 商户生成的参数签名结果，获取hmac的方法请参考请求加密流程

示例

{ "merchantId":"896667346", "sourceCurrency":"USD", "targetCurrency":"CNY", "listprice":695.380000, "listpriceDateTime":"2018-11-22 18:08:15", "tradeUnit":100, "status":"SUCCESS", "resMessage":"SUCCESS", "hmac":"Y5bsFhAMdfmzZf4qzU2oonINLjkBTxKSzJWdaN4QjyRtz0WMGhlpWh7mtpU/9djqmgQQrn6tkP5vO Nx/6XsGbPl6Ifrs4ggUMJD2s68o724fJevqWK+OGPnZl6kFziI84cn3Qt5tnzBz1SKkFUxoDLKcyg6TUckAbt iJcYsrFRLfPe1Ngph7Va7dQ0Ugs9KLq0u3mLQTLgJuQWAGGU2oIiHrDGcF1/crZ+TKidRlmpL9UXBLTD1eapl fgIKJ82ai3Uo1FN/STVDNcBTMSr8JnWHFMGR1+HsCbI6LZ5cxQuyh0RtWBbypEFk3ftZC4TWxh4fKiPzwGCarv mxcn5n07w==" }