汇率查询接口
商家可以使用这个接口来查询支付宝参考汇率。
Note:
- 货币间的汇率会在北京时间每日9：00到11:00间变动一次；
- 汇率每日获取上限为100次。
网关URL
| 环境 | HTTPS请求URL |
| 生产环境 | https://intlmapi.alipay.com/gateway.do |
| 测试环境 | https://mapi.alipaydev.com/gateway.do |
请求参数
| 字段名 | 变量名 | 类型 | 说明 | 可空 |
| 基本参数 | ||||
| 接口名称 | service | String | forex_rate_file | 不可空 |
| 境外商户 | partner | String(16) | 境外商户在支付宝的用户ID | 不可空 |
| 签名 | sign | String | 签名值 | 不可空 |
| 签名方式 | sign_type | String | 签名方式，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 result | Description |
| 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 result | Description |
| SYSTEM_ERROR | 支付宝系统错误 |
| SESSION_TIMEOUT | Session 超时 |
| ILLEGAL_TARGET_SERVICE | 错误的target_service |
| ILLEGAL_ACCESS_SWITCH_SYSTEM | partner不允许访问该类型的系统 |
| EXTERFACE_IS_CLOSED | 接口已关闭 |