汇率查询接口


商家可以使用这个接口来查询支付宝参考汇率。

 Note:

  • 货币间的汇率会在北京时间每日9:00到11:00间变动一次;
  • 汇率每日获取上限为100次。


#网关URL

环境HTTPS请求URL
生产环境https://intlmapi.alipay.com/gateway.do
测试环境https://mapi.alipaydev.com/gateway.do

#请求参数

字段名变量名类型说明可空
基本参数
接口名称serviceStringforex_rate_file不可空
境外商户partnerString(16)境外商户在支付宝的用户ID不可空
签名signString签名值不可空
签名方式sign_typeString签名方式,MD5, RSA, DSA不可空

 Note:

  • 接口下载的是一个txt文件
  • 文件内容没有列标题并且数据字段之间用”|”分割
  • 只能下载当天的参考汇率,并不是交易发生时的真实汇率。真实汇率以交易时的页面展示为准。

#同步返回

#返回格式

返回内容可能是以下几种格式:

  • 如果网关报错,返回是xml格式的消息
  • 如果业务逻辑有错误,返回的是带错误消息的txt文件
  • 如果调用成功,返回带交易记录的txt文件

#返回的文件格式

参数名类型备注
日期String(8)汇率发布的日期:YYYYMMDD
时间String(6)汇率发布的时间点:HHMMSS
币种符号String(3)货币的符号,请参考币种表
汇率String(10) 

#示例

#请求示例

https://intlmapi.alipay.com/gateway.do?sign_type=MD5&sendFormat=normal&sign=590a9fbbed8a5b9a86b426795445f9f0&service=forex_rate_file&partner=2088101122136241


#示例汇率文件:

copy
20160504|100030|CHF|6.829600|
20160504|100030|EUR|7.491500|
20160504|100030|THB|0.185877|
20160504|100030|DKK|1.007800|
20160504|100030|SGD|4.815600|
20160504|100030|GBP|9.476100|
20160504|100030|HKD|0.838800|
20160504|100030|NOK|0.803000|
20160504|100030|CAD|5.124900|
20160504|100030|KRW|0.005814|
20160504|100030|NZD|4.496100|
20160504|100030|JPY|0.060934|
20160504|100030|AUD|4.877600|
20160504|100030|SEK|0.809800|
20160504|090530|USD|6.534600|

 

#返回示例

#成功返回

成功的返回是一个带汇率信息的txt文件: 

汇率查询接口

#业务逻辑错误返回:
copy
File download failed: Over 10 days to Date period


#网关错误返回:
copy
<?xml version="1.0" encoding="UTF-8"?>
<alipay>
<is_success>F</is_success>
<error>ILLEGAL_SIGN</error>
</alipay>


#错误码

基本上API接口的调用的检查是在支付宝的2个级别进行的 


第一个级别是在支付宝网关。在这里会进行一些基础的校验,如签名,商家ID是否有效或者是否有权限使用某个接口等。如果校验失败,就会返回相应的错误码,归类在下面的网关错误中。 


一旦网关校验通过了,接口请求就会被转发到内部系统进行进一步的处理。 这里会进行业务逻辑的校验。如果校验失败,就会返回相应的错误码,归类在业务错误代码中。

#业务错误代码

Returned resultDescription
System exception系统异常
Merchant ID incorrect商家ID不对
File empty空文件

#网关错误

如果请求参数里面有错误,支付宝网关会报错。整个流程还是在支付宝这端而不会返回到商户端。

错误代码含义
ILLEGAL_ARGUMENT参数错误
ILLEGAL_SIGN签名错误
ILLEGAL_SERVICE接口参数不正确
ILLEGAL_PARTNER商户PID不对
ILLEGAL_SIGN_TYPE签名方法错误
ILLEGAL_PARTNER_EXTERFACE商家无权使用该接口
ILLEGAL_DYN_MD5_KEY动态密钥信息错误
ILLEGAL_ENCRYPT加密不正确
ILLEGAL_USER用户ID不正确
ILLEGAL_EXTERFACE接口配置错误
ILLEGAL_AGENT代理商不正确
HAS_NO_PRIVILEGE无权访问
INVALID_CHARACTER_SET字符集不正确

#系统错误

当出现系统错误提示时,请联系支付宝技术支持协助处理

Returned resultDescription
SYSTEM_ERROR支付宝系统错误
SESSION_TIMEOUTSession 超时
ILLEGAL_TARGET_SERVICE错误的target_service
ILLEGAL_ACCESS_SWITCH_SYSTEMpartner不允许访问该类型的系统
EXTERFACE_IS_CLOSED接口已关闭