查询汇率
# 查询汇率
注意
API计划在未来的版本移除。
# 请求地址
POST https://sandbox-acquirer-payment.pingpongx.com/v2/exchangeRate/query
1
POST https://acquirer-payment.pingpongx.com/v2/exchangeRate/query
1
// Make sure to add code blocks to your code group
# 请求参数
参数必填属性说明:必填(M),可选(O),条件必填(C)。 POST JSON deprecated
参数字段 | 参数类型 | 参数属性 | 参数说明 |
---|---|---|---|
accId | String | M | PingPong店铺号 |
nonce | String(64) | M | 随机字符串,(0-9a-zA-Z) 64位,nonce不能重复 |
timestamp | String | M | 时间戳 |
sellCurrency | String | M | 原币种 |
buyCurrency | String | M | 目标币种 |
signType | String | M | 签名类型 MD5/SHA256 |
sign | String | M | 签名 |
# 签名
# 参与签名参数
参数字段 | 参数类型 | 参数属性 | 参数说明 |
---|---|---|---|
accId | String | M | PingPong店铺号 |
timestamp | String | M | 时间戳 |
nonce | String(64) | M | 随机字符串,(0-9a-zA-Z) 64位 |
sellCurrency | String | M | 原币种 |
buyCurrency | String | M | 目标币种 |
signType | String | M | 签名类型 MD5/SHA256 |
# 获取签名串
字典序:按首字母进行排序;
queryString:用'=' 进行参数名和参数值(trim 后的值)的拼接,用'&'进行多 个参数之间的拼接,即 key1=val1&key2=val2&key3=val3
- 对签名参数按key进行字典序排序
- 参数按照queryString方式组装
- 签名秘钥(salt)放入签名串的位置为: 签名串的开头 , 即{salt}key1=val2&key2=val2&key3=val3
# 签名串示例
07C9EBC62F1316C5CF70F327accId=2021070818000710171494&buyCurrency=CNH&nonce=CB5B634C617453B10FEC44125CC5D2C55D2C5D5S45D3C6D6DD4CCDSSSSSSZZZA&sellCurrency=USD&signType=MD5×tamp=1662555618000
1
# 请求报文示例
{
"accId":"2021070818000710171494",
"nonce":"CB5B634C617453B10FEC44125CC5D2C55D2C5D5S45D3C6D6DD4CCDSSSSSSZZZB",
"timestamp":"1662555618000",
"sellCurrency":"USD",
"buyCurrency":"CNH",
"signType":"SHA256",
"sign":"3CB9573DD4B2AC6E01D12FE3C856A16C97DB7FE31A14FD0BA7BA108D1516F949"
}
1
2
3
4
5
6
7
8
9
2
3
4
5
6
7
8
9
# 响应参数
参数字段 | 参数类型 | 参数属性 | 参数说明 |
---|---|---|---|
accId | String(64) | M | PingPong 商户店铺编号 |
nonce | String(64) | M | 64 位随机数,字符范围:(0-9a-zA-Z) |
timestamp | number(13) | M | 时间戳,精确到毫秒 |
sellCurrency | String(3) | M | 原币种 |
buyCurrency | String(3) | M | 目标币种 |
result | String(2) | M | 是否成功(Y/N) |
reason | String(255) | M | 失败时,显示错误原因 |
rateId | number(12) | O | 汇率 id |
rate | Decimal(18, 6) | O | 汇率,精确到小数点后 6 位 |
signType | String(32) | M | 签名规约,支持 MD5、SHA256 |
sign | String(256) | M | 签名内容,具体⻅本文“签名规约”一栏 |
# 响应报文示例
{
"accId": "2021070818000710171494",
"buyCurrency": "CNH",
"nonce": "CB5B634C617453B10FEC44125CC5D2C55D2C5D5S45D3C6D6DD4CCDSSSSSSZZZB",
"rate": 6.6589000000,
"rateId": "480",
"reason": "",
"result": "Y",
"sellCurrency": "USD",
"sign": "02F24DAFF9A2B3177896F0F06793F9CDF2C427A5CEC8D4C77514D8D05C5A2995",
"signType": "SHA256",
"timestamp": 1662555618000
}
1
2
3
4
5
6
7
8
9
10
11
12
13
2
3
4
5
6
7
8
9
10
11
12
13
# 支持币种对
sellCurrency | buyCurrency |
---|---|
CAD | USD |
CNY | GBP |
DKK | USD |
AED | USD |
USD | GBP |
AUD | CNH |
EUR | USD |
EUR | SGD |
SEK | USD |
JPY | CAD |
MYR | CNH |
EUR | AED |
EUR | HKD |
DKK | HKD |
DKK | EUR |
CAD | HKD |
CAD | EUR |
EUR | VND |
JPY | EUR |
JPY | HKD |
HKD | USD |
MXN | CNH |
EUR | AUD |
USD | CAD |
NZD | USD |
GBP | EUR |
GBP | HKD |
AED | CNH |
EUR | DKK |
CNY | CAD |
INR | CNH |
DKK | CNH |
EUR | CAD |
SEK | EUR |
SEK | HKD |
CNY | HKD |
SEK | CAD |
SGD | USD |
CNY | EUR |
JPY | CNH |
GBP | CAD |
EUR | GBP |
EUR | JPY |
JPY | USD |
CAD | GBP |
SGD | CNH |
NZD | CNH |
SEK | GBP |
AUD | USD |
HKD | CAD |
EUR | INR |
INR | USD |
HKD | EUR |
EUR | KRW |
NZD | CAD |
NZD | EUR |
EUR | NZD |
NZD | HKD |
EUR | BRL |
HKD | GBP |
CNY | USD |
MXN | GBP |
SGD | EUR |
SGD | HKD |
SGD | CAD |
GBP | USD |
MYR | GBP |
MXN | CAD |
GBP | CNH |
AUD | HKD |
USD | CNH |
AUD | EUR |
AUD | CAD |
MYR | CAD |
EUR | MXN |
INR | EUR |
INR | HKD |
INR | CAD |
USD | EUR |
EUR | SEK |
USD | HKD |
EUR | CNH |
MYR | HKD |
MYR | EUR |
DKK | CAD |
SGD | GBP |
AED | CAD |
AED | EUR |
AED | HKD |
MXN | EUR |
CAD | CNH |
MXN | HKD |
HKD | CNH |
AED | GBP |
MXN | USD |
EUR | PHP |
CNY | CNH |
INR | GBP |
MYR | USD |
NZD | GBP |
JPY | GBP |
SEK | CNH |
DKK | GBP |
AUD | GBP |
EUR | CNY |
EUR | THB |
CAD | USD |
CNY | GBP |
DKK | USD |
AED | USD |
USD | GBP |
AUD | CNH |
EUR | USD |
EUR | SGD |
SEK | USD |
JPY | CAD |
MYR | CNH |
EUR | AED |
EUR | HKD |
DKK | HKD |
DKK | EUR |
CAD | HKD |
CAD | EUR |
EUR | VND |
JPY | EUR |
JPY | HKD |
HKD | USD |
MXN | CNH |
EUR | AUD |
USD | CAD |
NZD | USD |
GBP | EUR |
GBP | HKD |
AED | CNH |
EUR | DKK |
CNY | CAD |
INR | CNH |
DKK | CNH |
EUR | CAD |
SEK | EUR |
SEK | HKD |
CNY | HKD |
SEK | CAD |
SGD | USD |
CNY | EUR |
JPY | CNH |
GBP | CAD |
EUR | GBP |
EUR | JPY |
JPY | USD |
CAD | GBP |
SGD | CNH |
NZD | CNH |
SEK | GBP |
AUD | USD |
HKD | CAD |
EUR | INR |
INR | USD |
HKD | EUR |
EUR | KRW |
NZD | CAD |
NZD | EUR |
EUR | NZD |
NZD | HKD |
EUR | BRL |
HKD | GBP |
CNY | USD |
MXN | GBP |
SGD | EUR |
SGD | HKD |
SGD | CAD |
GBP | USD |
MYR | GBP |
MXN | CAD |
GBP | CNH |
AUD | HKD |
USD | CNH |
AUD | EUR |
AUD | CAD |
MYR | CAD |
EUR | MXN |
INR | EUR |
INR | HKD |
INR | CAD |
USD | EUR |
EUR | SEK |
USD | HKD |
EUR | CNH |
MYR | HKD |
MYR | EUR |
DKK | CAD |
SGD | GBP |
AED | CAD |
AED | EUR |
AED | HKD |
MXN | EUR |
CAD | CNH |
MXN | HKD |
HKD | CNH |
AED | GBP |
MXN | USD |
EUR | PHP |
CNY | CNH |
INR | GBP |
MYR | USD |
NZD | GBP |
JPY | GBP |
SEK | CNH |
DKK | GBP |
AUD | GBP |
EUR | CNY |
EUR | THB |
CAD | USD |
CNY | GBP |
DKK | USD |
AED | USD |
USD | GBP |
AUD | CNH |
EUR | USD |
EUR | SGD |
SEK | USD |
JPY | CAD |
MYR | CNH |
EUR | AED |
EUR | HKD |
DKK | HKD |
DKK | EUR |
CAD | HKD |
CAD | EUR |
EUR | VND |
JPY | EUR |
JPY | HKD |
HKD | USD |
MXN | CNH |
EUR | AUD |
USD | CAD |
NZD | USD |
GBP | EUR |
GBP | HKD |
AED | CNH |
EUR | DKK |
CNY | CAD |
INR | CNH |
DKK | CNH |
EUR | CAD |
SEK | EUR |
SEK | HKD |
CNY | HKD |
SEK | CAD |
SGD | USD |
CNY | EUR |
JPY | CNH |
GBP | CAD |
EUR | GBP |
EUR | JPY |
JPY | USD |
CAD | GBP |
SGD | CNH |
NZD | CNH |
SEK | GBP |
AUD | USD |
HKD | CAD |
EUR | INR |
INR | USD |
HKD | EUR |
EUR | KRW |
NZD | CAD |
NZD | EUR |
EUR | NZD |
NZD | HKD |
EUR | BRL |
HKD | GBP |
CNY | USD |
MXN | GBP |
SGD | EUR |
SGD | HKD |
SGD | CAD |
GBP | USD |
MYR | GBP |
MXN | CAD |
GBP | CNH |
AUD | HKD |
USD | CNH |
AUD | EUR |
AUD | CAD |
MYR | CAD |
EUR | MXN |
INR | EUR |
INR | HKD |
INR | CAD |
USD | EUR |
EUR | SEK |
USD | HKD |
EUR | CNH |
MYR | HKD |
MYR | EUR |
DKK | CAD |
SGD | GBP |
AED | CAD |
AED | EUR |
AED | HKD |
MXN | EUR |
CAD | CNH |
MXN | HKD |
HKD | CNH |
AED | GBP |
MXN | USD |
EUR | PHP |
CNY | CNH |
INR | GBP |
MYR | USD |
NZD | GBP |
JPY | GBP |
SEK | CNH |
DKK | GBP |
AUD | GBP |
EUR | CNY |
EUR | THB |
CAD | USD |
CNY | GBP |
DKK | USD |
AED | USD |
USD | GBP |
AUD | CNH |
EUR | USD |
EUR | SGD |
SEK | USD |
JPY | CAD |
MYR | CNH |
EUR | AED |
EUR | HKD |
DKK | HKD |
DKK | EUR |
CAD | HKD |
CAD | EUR |
EUR | VND |
JPY | EUR |
JPY | HKD |
HKD | USD |
MXN | CNH |
EUR | AUD |
USD | CAD |
NZD | USD |
GBP | EUR |
GBP | HKD |
AED | CNH |
EUR | DKK |
CNY | CAD |
INR | CNH |
DKK | CNH |
EUR | CAD |
SEK | EUR |
SEK | HKD |
CNY | HKD |
SEK | CAD |
SGD | USD |
CNY | EUR |
JPY | CNH |
GBP | CAD |
EUR | GBP |
EUR | JPY |
JPY | USD |
CAD | GBP |
SGD | CNH |
NZD | CNH |
SEK | GBP |
AUD | USD |
HKD | CAD |
EUR | INR |
INR | USD |
HKD | EUR |
EUR | KRW |
NZD | CAD |
NZD | EUR |
EUR | NZD |
NZD | HKD |
EUR | BRL |
HKD | GBP |
CNY | USD |
MXN | GBP |
SGD | EUR |
SGD | HKD |
SGD | CAD |
GBP | USD |
MYR | GBP |
MXN | CAD |
GBP | CNH |
AUD | HKD |
USD | CNH |
AUD | EUR |
AUD | CAD |
MYR | CAD |
EUR | MXN |
INR | EUR |
INR | HKD |
INR | CAD |
USD | EUR |
EUR | SEK |
USD | HKD |
EUR | CNH |
MYR | HKD |
MYR | EUR |
DKK | CAD |
SGD | GBP |
AED | CAD |
AED | EUR |
AED | HKD |
MXN | EUR |
CAD | CNH |
MXN | HKD |
HKD | CNH |
AED | GBP |
MXN | USD |
EUR | PHP |
CNY | CNH |
INR | GBP |
MYR | USD |
NZD | GBP |
JPY | GBP |
SEK | CNH |
DKK | GBP |
AUD | GBP |
EUR | CNY |
EUR | THB |
CAD | USD |
CNY | GBP |
DKK | USD |
AED | USD |
USD | GBP |
AUD | CNH |
EUR | USD |
EUR | SGD |
SEK | USD |
JPY | CAD |
MYR | CNH |
EUR | AED |
EUR | HKD |
DKK | HKD |
DKK | EUR |
CAD | HKD |
CAD | EUR |
EUR | VND |
JPY | EUR |
JPY | HKD |
HKD | USD |
MXN | CNH |
EUR | AUD |
USD | CAD |
NZD | USD |
GBP | EUR |
GBP | HKD |
AED | CNH |
EUR | DKK |
CNY | CAD |
INR | CNH |
DKK | CNH |
EUR | CAD |
SEK | EUR |
SEK | HKD |
CNY | HKD |
SEK | CAD |
SGD | USD |
CNY | EUR |
JPY | CNH |
GBP | CAD |
EUR | GBP |
EUR | JPY |
JPY | USD |
CAD | GBP |
SGD | CNH |
NZD | CNH |
SEK | GBP |
AUD | USD |
HKD | CAD |
EUR | INR |
INR | USD |
HKD | EUR |
EUR | KRW |
NZD | CAD |
NZD | EUR |
EUR | NZD |
NZD | HKD |
EUR | BRL |
HKD | GBP |
CNY | USD |
MXN | GBP |
SGD | EUR |
SGD | HKD |
SGD | CAD |
GBP | USD |
MYR | GBP |
MXN | CAD |
GBP | CNH |
AUD | HKD |
USD | CNH |
AUD | EUR |
AUD | CAD |
MYR | CAD |
EUR | MXN |
INR | EUR |
上次更新: 2023/08/01, 21:11:53