统一文件服务
运营
收单机构
发卡机构
统一文件服务向机构用户提供更加便捷的服务,使用该服务可以查询清算流水文件下发开始时间、收发状态等信息,重新下发本机构的文件。
服务对象

机构用户

产品详情

       统一文件服务是为了给成员机构提供更好的文件收发服务体验,在异常事件处理过程中提供更加便捷的沟通渠道而开发的产品接口。用户可以查询当日文件传输状态、查询历史文件任务,重新下发本机构的文件


应用场景

当日文件下发状态查询及重发:可以查询当日其所属机构为文件发起端、文件发送端、文件接收端、文件目的端的文件任务总数,每个文件发送的状态,是否所有的文件已经发送完成。对于有文件任务重发接口权限的用户,可以重新传输当日内其所属机构为文件接收端,并且文件传输方向为CUPS下发给机构的文件任务。

历史文件任务查询及重发:可以查询30日内其所属机构为文件发起端、文件发送端、文件接收端、文件目的端的文件任务总数,每个文件发送的状态,是否所有的文件已经发送完成。对于有文件任务重发接口权限的用户,可以重新传输10日之内其所属机构为文件接收端,并且文件传输方向为CUPS下发给机构的文件任务。



具体开发接入请查看“统一文件服务 ”文档资源进行下载
应答码参照
应答码 描述 解决方案
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报文体

{
        “respCd”:“0000”
        “respMsg”:“成功”
    “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.OpenAPI使用教程请参考在线文档:

OpenAPI使用指南接入指南》

 

2. OpenAPI安全调用过程请参考在线文档:

2.1OpenAPI使用指南获取产品token

2.2OpenAPI使用指南产品功能接口调用》

 

3. OpenAPI接口调用报文签名样例请参考在线文档:

OpenAPI使用指南报文签名样例代码》

 

4. OpenAPI测试工具使用说明请参考在线文档:

OpenAPI使用指南—OpenAPI测试工具》


联系我们

业务咨询: 021-38929999-6265

黄海宇

huanghaiyu@unionpay.com

技术咨询: 021-20633521

张昊

zhanghao1@unionpay.com

咨询与服务