当前位置: 产品API > 运营 > 统一文件服务
产品介绍
  • 服务对象
    机构用户
应答码参照
应答码状态列表
  • 应答码 描述 解决方案
    0000 处理成功。 暂无
    0011 taskInfo接口todayHisIIdCd字段为空或不合法 暂无
    0012 taskInfo接口beginFileDate字段为空或不合法 暂无
    0013 taskInfo接口endFileDate字段为空或不合法 暂无
    0014 taskInfo接口解析beginFileDate或endFileDate字段为日期失败 暂无
    0015 taskInfo接口beginFileDate字段大于endFileDate字段,或日期差超过30天。 暂无
    0016 taskInfo接口launchPointIdCd, sendPointIdCd, rcvPointIdCd, filePointIdCd字段都为空。 暂无
    0021 taskRedo接口fileName字段为空 暂无
    0022 taskRedo接口fileDate字段为空或不合法 暂无
    0023 taskRedo接口taskDate字段为空或不合法 暂无
    0024 taskRedo接口launchPointIdCd, sendPointIdCd, rcvPointIdCd, filePointIdCd字段都为空。 暂无
    0025 taskRedo接口,请求重发的文件任务正在进行中 暂无
    0026 taskRedo接口,请求重发任务失败 暂无
    0027 taskRedo接口,没有符合查询条件的重发任务 暂无
    0031 接口不存在 暂无
    1001 处理失败。 暂无
    9901 您的IP(XXX.XXX.XXX.XXX)没有登记,请登录银联开放平台(open.unionpay.com)进行白名单登记。 暂无
    9902 您的IP(XXX.XXX.XXX.XXX)已被限制访问,请登录银联开放平台(open.unionpay.com)提交申诉请求。 暂无
    9903 您的IP(XXX.XXX.XXX.XXX)请求过于频繁,已被临时限制,请5分钟后再尝试。 暂无
    9904 您的 IP(XXX.XXX.XXX.XXX)不属于你设置的开发IP列表,请登录银联开放平台(open.unionpay.com)确认相关配置 暂无
    9905 请求参数值有误,请确认请求参数信息 暂无
    9906 您的账号不具备当前产品请求权限,如有权限,可重新获取该产品Token后再尝试。 暂无
    9907 app_id与app_secret验证失败 暂无
    9908 您的Token已过期,请重新获取Token。 暂无
    9909 您的Token信息非最新Token,请确保您的系统中使用的是最新的Token值。 暂无
    9910 您的签名密钥未设置,请登录银联开放平台(open.unionpay.com)确认相关配置 暂无
    9911 您的签名信息验证不通过,请检查您的签名实现是否符合银联开放平台(open.unionpay.com)提供的签名规则。 暂无
    9912 您的报文格式有误,要求报文符合JSON数据格式。 暂无
    9913 你的报文数据有误,未通过数据信息校验,具体原因视业务需求。 暂无
    9914 您的报文无法解密,请检查您在银联开放平台(open.unionpay.com)上提供的RSA公钥是否正确。 暂无
    9915 您的API调用额度已耗尽,需充值付费后补充调用额度。 暂无
    9916 您的API并发调用额度已耗尽,需联系管理员调整您的并发限额。 暂无
    9917 您的账号不具备当前产品API请求权限,请联系相关业务接口人。 暂无
    9991 银联开放平台系统内部错误:产品服务调用失败。 暂无
    9992 银联开放平台系统内部错误:产品服务系统未知错误。 暂无
    9993 银联开放平台系统内部错误:产品服务未注册至服务中心。 暂无
    9994 银联开放平台系统内部错误:产品服务参数错误。 暂无
报文举例

1.报文举例-获取产品调用token信息:


请求URL:


https://openapi.unionpay.com/upapi/upfile/token?app_id=[value]&app_secret=[value]


应答JSON报文体

{
    “token”: “”,
    “expire_in”:7200
}



2.报文举例-文件任务查询


请求URL:


https://openapi.unionpay.com/upapi/upfile/taskInfo?token=[value]&sign=[value]&ts=[value]


请求报文参数:


{
    “fileName”: “name”,
    “beginFileDate”: “20180101”,
    “endFileDate”: “20180102”,
    ......
}


应答JSON报文体:


{
   “respCd”: “0000”,
   “respMsg”: “msg”, 
   “data”: {
       “totalCount”: “11”,
        “totalPage”: “2”,
        “currentPage”: “1”,
        “list”: [{“fileName”: “name1”,
        “fileDate”: “20180101”,
        “taskDate”: “20180101”,
        ......
        },{“fileName”: “name2”,
        “fileDate”: “20180101”,
        “taskDate”: “20180101”,
        ......
        }
      ]
   }
}


3.报文举例-文件任务重做


请求URL:


https://openapi.unionpay.com/upapi/upfile/taskRedo?token=[value]&sign=[value]&ts=[value]


请求报文参数:


{
    “fileName”: “name”,
    “beginFileDate”: “20180101”,
    “endFileDate”: “20180102”,
    ......
}


应答JSON报文体:


{
    “respCd”“0000”,
    “respMsg”:“msg”
}


报文签名规则([sign]生产方法):

 1.  报文前拼接签名密钥,后面拼接时间戳(毫秒)字符串:secret + body + ts

    secret: 签名密钥

    body: 请求JSON报文

    ts: 时间戳,毫秒

2.  使用SHA-256算法计算HASH值

3.  具体签名样例代码参照附录部分。


技术指南

1. “快速接入”产品API使用教程请参考在线文档:

《“快速接入”产品API指南—接入指南》


2. “快速接入”产品API安全调用过程请参考在线文档:

2.1《“快速接入”产品API指南—获取产品token》

2.2《“快速接入”产品API指南—产品功能接口调用》


3. “快速接入”产品API接口调用报文签名样例请参考在线文档:

《“快速接入”产品API指南—报文签名样例代码》


4. “快速接入”产品API测试工具使用说明请参考在线文档:

《“快速接入”产品API指南—“快速接入”测试工具》


API接口
获取token
接口描述
产品token是开放平台每个产品的全局唯一接口调用凭据,用户调用各接口时都需使用产品token。
请求方式
GET
生产地址
https://openapi.unionpay.com/upapi/upfile/token
测试地址
敬请期待
请求URL参数
名称 标识 字段类型 长度 请求要求 默认值 备注
用户唯一凭证 app_id string M-必填 详情可在登录技术开放平台后“个人中心-我的信息-API认证信息-API认证账号”中查看
用户唯一凭证密钥 app_secret string M-必填 详情可在登录技术开放平台后“个人中心-我的信息-API认证信息-API认证密钥”中查看
同步应答参数
名称 标识 字段类型 长度 请求要求 默认值 备注
产品token token string M-必填 获取到的凭证; 凭证是字符串
过期时间 expire_in long M-必填 凭证有效时间,单位:秒
文件任务查询
接口描述
查询当前登录机构下的当日或历史30日以内的文件任务
请求方式
POST
生产地址
https://openapi.unionpay.com/upapi/upfile/taskInfo
测试地址
敬请期待
请求报文体参数
名称 标识 字段类型 长度 请求要求 默认值 备注
文件名称 fileName string 99 O-选填 文件名称本身不含空格
起始文件日期 beginFileDate string 8 M-必填
截止文件日期 endFileDate string 8 M-必填 起始日期或之后日期
文件发送状态 fileSendSt string 1 O-选填 0-等待处理 1-等待传输 2-正在传输 3-传输成功 9-传输失败 W-等待索取
文件传输方向 fileTfrDir string 1 O-选填 I-接收O-发送
发起方标识代码 launchPointIdCd string 20 C-依条件必填 四个标识代码有一个为登录机构号
发送方标识代码 sendPointIdCd string 20 C-依条件必填 四个标识代码有一个为登录机构号
接收方标识代码 rcvPointIdCd string 20 C-依条件必填 四个标识代码有一个为登录机构号
文件方标识代码 filePointIdCd string 20 C-依条件必填 四个标识代码有一个为登录机构号
当日历史标识 todayHisIIdCd string 1 M-必填 0:当日、1:历史(30天以内)
当前页码 currentPage int M-必填 分页当前页码,第一页为页面为1
分页大小 pageSize int M-必填 分页大小,默认为20
同步应答参数
名称 标识 字段类型 长度 请求要求 默认值 备注
响应编号 respCd string 4 M-必填
响应信息 respMsg string 128 M-必填
响应数据 data map M-必填
总记录条数 totalCount int M-必填
总页数 totalPage int M-必填
当前页码 currentPage int M-必填
分页数据 list array M-必填
文件名称 fileName string 160 M-必填 翻译:文件名称-文件描述IND******01ICOM-一般交易发卡方交易明细
文件清算日期 fileDate string 8 M-必填
任务清算日期 taskDate string 8 M-必填
文件类型 fileType string 1 M-必填
发起方标识代码 launchPointIdCd string 60 M-必填 机构代码
发送方标识代码 sendPointIdCd string 60 M-必填 机构代码
接收方标识代码 rcvPointIdCd string 60 M-必填 机构代码
文件方标识代码 filePointIdCd string 60 M-必填 机构代码
文件发送状态 fileSendSt string 1 M-必填 0-等待处理1-等待传输 2-正在传输 3-传输成功 9-传输失败 W-等待索取
文件传输方式 fileTfrMd string 1 M-必填 l:流传输 f-FTP s-FTPs h-SFTP n-互联网SFTP t-联机报文通知线路
文件传输方向 fileTfrDir string 1 M-必填 I-接收O-发送
文件发送开始时间 fileSendBeginTime string 8 M-必填 YYYYMMDD
文件发送结束时间 fileSendEndTime string 8 M-必填 YYYYMMDD
文件下次发送时间 fileSendNextTime string 8 M-必填 YYYYMMDD
文件剩余发送次数 fileLeftSendNum int 1 M-必填
文件任务重做
接口描述
机构作为接收方可以选择发送失败的文件任务进行任务重发(只有状态为3-传输成功和4-传输失败状态的任务可以被重发)。
请求方式
POST
生产地址
https://openapi.unionpay.com/upapi/upfile/taskRedo
测试地址
敬请期待
请求URL参数
名称 标识 字段类型 长度 请求要求 默认值 备注
文件名称 fileName string 99 M-必填 文件名称本身不含空格
文件清算日期 fileDate string 8 M-必填 必填 < YYYYMMDD >
任务清算日期 taskDate string 8 M-必填 必填 < YYYYMMDD >
发起方标识代码 launchPointIdCd string 20 O-选填
发送方标识代码 sendPointIdCd string 20 O-选填
接收方标识代码 rcvPointIdCd string 20 O-选填 必须为登录机构号
文件方标识代码 filePointIdCd string 20 O-选填
同步应答参数
名称 标识 字段类型 长度 请求要求 默认值 备注
响应编号 respCd string 4 M-必填
响应信息 respMsg string 128 M-必填
联系我们

业务咨询: 黄海宇

021-38929999-6265

huanghaiyu@unionpay.com

技术咨询: 张昊

021-20633521

zhanghao1@unionpay.com

中国银联版权所有©2002-2019沪 ICP备07032180号