BOS服务单

运营 收单机构 商户 发卡机构 快速接入
为了与第三方系统灵活集成,中国银联业务运营服务平台(BOS系统)的服务单系统对外开放API接口,以实现多方面业务场景,服务于商户、机构、总分子公司。

接入服务商:银联技术开放平台

API ID:53

接口状态:正常

业务申请
暂不支持测试

接口名称

获取token

接口描述

产品token是开放平台每个产品的全局唯一接口调用凭据,用户调用各接口时都需使用产品token。

接口地址

测试地址: 无


生产地址: https://openapi.unionpay.com/upapi/bos/token

请求方式

HTTP GET

请求url参数

名称 标识 字段类型 长度 请求要求 默认值 备注
用户唯一凭证 app_id string M-必填 详情可在登录技术开放平台后“个人中心-我的信息-API认证信息-API认证账号”中查看。
用户唯一凭证密钥 app_secret string M-必填 详情可在登录技术开放平台后“个人中心-我的信息-API认证信息-API认证密钥”中查看。

应答参数

名称 标识 字段类型 长度 请求要求 默认值 备注
过期时间 expire_in string M-必填 凭证有效时间,单位:秒。
产品token token string M-必填 获取到的凭证; 凭证是字符串。

接口名称

C类别查询

接口描述

C类别查询

接口地址

测试地址: 暂无


生产地址: https://openapi.unionpay.com/upapi/bos/srvOrderQueryAction_oneLevelNameSelect

请求方式

HTTP POST

请求url参数

名称 标识 字段类型 长度 请求要求 默认值 备注
产品token token string M-必填 详情请参考“获取token”接口中应答参数“token”的具体数据。
签名信息 sign string M-必填 详细签名算法可参考附加板块“签名样例代码”部分。
时间戳 ts int M-必填 单位:毫秒。

请求报文体参数

名称 标识 字段类型 长度 请求要求 默认值 备注
请求人工号 empNo string M-必填 操作人员工号信息
请求人IP ipAddr string M-必填 操作人ip地址
请求服务名字 serverName string M-必填 可为空串;记录服务名称
请求地址 uri string M-必填 可为空串;记录操作网页链接
人员类型 empType string M-必填
机构代码 insCode string 8 M-必填 非银联商户,此属性为对应的机构号信息
商户代码 mchntcd string 15 M-必填 银联商户代码
请求人userId userId string M-必填 记录操作用户信息、便于后续查询
请求数据 data map M-必填 JSON格式数据,具体接口的参数信息作为该节点的属性值进行设置。
是否精简服务单 isSimpleMenu string O-选填 如果是创建精简服务单填写固定值“simple”;如果是创建普通服务单或其他服务单,可不必上送此字段(或者值为空)。

应答参数

名称 标识 字段类型 长度 请求要求 默认值 备注
响应编号 respCd string 2 M-必填 详见应答码列表
相应信息 respMsg string 128 O-选填
响应数据 data map M-必填 JSON格式数据,具体接口的参数信息作为该节点的属性值进行设置。
C类别列表 OneLevelNameList array M-必填
C类别名称 oneLevelName string M-必填

接口名称

T类别查询

接口描述

T类别查询

接口地址

测试地址: 暂无


生产地址: https://openapi.unionpay.com/upapi/bos/srvOrderQueryAction_twoLevelNameSelect

请求方式

HTTP POST

请求url参数

名称 标识 字段类型 长度 请求要求 默认值 备注
产品token token string M-必填 详情请参考“获取token”接口中应答参数“token”的具体数据。
签名信息 sign string M-必填 详细签名算法可参考附加板块“签名样例代码”部分。
时间戳 ts int M-必填 单位:毫秒。

请求报文体参数

名称 标识 字段类型 长度 请求要求 默认值 备注
请求人工号 empNo string M-必填 操作人员工号信息
请求人IP ipAddr string M-必填 操作人ip地址
请求服务名字 serverName string M-必填 可为空串;记录服务名称
请求地址 uri string M-必填 可为空串;记录操作网页链接
人员类型 empType string M-必填
机构代码 insCode string 8 M-必填 非银联商户,此属性为对应的机构号信息
商户代码 mchntcd string 15 M-必填 银联商户代码
请求人userId userId string M-必填 记录操作用户信息、便于后续查询
请求数据 data map M-必填 JSON格式数据,具体接口的参数信息作为该节点的属性值进行设置。
C类别名称 oneLevelName string 50 M-必填 一级目录名称
是否精简服务单 isSimpleMenu string O-选填 如果是创建精简服务单填写固定值“simple”;如果是创建普通服务单或其他服务单,可不必上送此字段(或者值为空)。

应答参数

名称 标识 字段类型 长度 请求要求 默认值 备注
响应编号 respCd string 2 M-必填 详见应答码列表
相应信息 respMsg string 128 O-选填
响应数据 data map M-必填 JSON格式数据,具体接口的参数信息作为该节点的属性值进行设置。
T子类列表 TwoLevelNameList array M-必填
T子类名称 twoLevelName string 50 M-必填

接口名称

I类别查询

接口描述

I类别查询

接口地址

测试地址: 暂无


生产地址: https://openapi.unionpay.com/upapi/bos/srvOrderQueryAction_threeLevelNameSelect

请求方式

HTTP POST

请求url参数

名称 标识 字段类型 长度 请求要求 默认值 备注
产品token token string M-必填 详情请参考“获取token”接口中应答参数“token”的具体数据。
签名信息 sign string M-必填 详细签名算法可参考附加板块“签名样例代码”部分。
时间戳 ts int M-必填 单位:毫秒。

请求报文体参数

名称 标识 字段类型 长度 请求要求 默认值 备注
请求人工号 empNo string M-必填 操作人员工号信息
请求人IP ipAddr string M-必填 操作人ip地址
请求服务名字 serverName string M-必填 可为空串;记录服务名称
请求地址 uri string M-必填 可为空串;记录操作网页链接
人员类型 empType string M-必填
机构代码 insCode string 8 M-必填 非银联商户,此属性为对应的机构号信息
商户代码 mchntcd string 15 M-必填 银联商户代码
请求人userId userId string M-必填 记录操作用户信息、便于后续查询
请求数据 data map M-必填 JSON格式数据,具体接口的参数信息作为该节点的属性值进行设置。
C类别名称 oneLevelName string 50 M-必填 一级目录名称
T子类名称 twoLevelName string 50 M-必填 二级目录名称
是否精简服务单 isSimpleMenu string 5 O-选填 如果是创建精简服务单填写固定值“simple”;如果是创建普通服务单或其他服务单,可不必上送此字段(或者值为空)。

应答参数

名称 标识 字段类型 长度 请求要求 默认值 备注
响应编号 respCd string 2 M-必填 详见应答码列表
相应信息 respMsg string 128 O-选填
响应数据 data map M-必填 JSON格式数据,具体接口的参数信息作为该节点的属性值进行设置。
I项目列表 ThreeLevelNameList array M-必填
I项目名称 threeLevelName string 50 M-必填

接口名称

S类别查询

接口描述

S类别查询

接口地址

测试地址: 暂无


生产地址: https://openapi.unionpay.com/upapi/bos/srvOrderQueryAction_fourLevelNameSelect

请求方式

HTTP POST

请求url参数

名称 标识 字段类型 长度 请求要求 默认值 备注
产品token token string M-必填 详情请参考“获取token”接口中应答参数“token”的具体数据。
签名信息 sign string M-必填 详细签名算法可参考附加板块“签名样例代码”部分。
时间戳 ts int M-必填 单位:毫秒。

请求报文体参数

名称 标识 字段类型 长度 请求要求 默认值 备注
请求人工号 empNo string M-必填 操作人员工号信息
请求人IP ipAddr string M-必填 操作人ip地址
请求服务名字 serverName string M-必填 可为空串;记录服务名称
请求地址 uri string M-必填 可为空串;记录操作网页链接
人员类型 empType string M-必填
机构代码 insCode string 8 M-必填 非银联商户,此属性为对应的机构号信息
商户代码 mchntcd string 15 M-必填 银联商户代码
请求人userId userId string M-必填 记录操作用户信息、便于后续查询
请求数据 data map M-必填 JSON格式数据,具体接口的参数信息作为该节点的属性值进行设置。
C类别名称 oneLevelName string 50 M-必填 一级目录名称
T子类名称 twoLevelName string 50 M-必填 二级目录名称
I项目名称 threeLevelName string 50 M-必填 三级目录名称
是否精简服务单 isSimpleMenu string 5 O-选填 如果是创建精简服务单填写固定值“simple”,如果是创建普通服务单或其他服务单,可不必上送此字段(或者值为空)。

应答参数

名称 标识 字段类型 长度 请求要求 默认值 备注
响应编号 respCd string 2 M-必填 详见应答码列表
相应信息 respMsg string 128 O-选填
响应数据 data map M-必填 JSON格式数据,具体接口的参数信息作为该节点的属性值进行设置。
S子项列表 FourLevelNameList array M-必填
S子项名称 fourLevelName string 50 M-必填

接口名称

服务目录列表

接口描述

BOS服务目录列表

接口地址

测试地址: 暂无


生产地址: https://openapi.unionpay.com/upapi/bos/tblSrvCategoryAction_queryCategoryPage

请求方式

HTTP POST

请求url参数

名称 标识 字段类型 长度 请求要求 默认值 备注
产品token token string M-必填 详情请参考“获取token”接口中应答参数“token”的具体数据。
签名信息 sign string M-必填 详细签名算法可参考附加板块“签名样例代码”部分。
时间戳 ts int M-必填 单位:毫秒。

请求报文体参数

名称 标识 字段类型 长度 请求要求 默认值 备注
请求人工号 empNo string M-必填 操作人员工号信息
请求人IP ipAddr string M-必填 操作人ip地址
请求服务名字 serverName string M-必填 可为空串;记录服务名称
请求地址 uri string M-必填 可为空串;记录操作网页链接
人员类型 empType string M-必填
机构代码 insCode string 8 M-必填 非银联商户,此属性为对应的机构号信息
商户代码 mchntcd string 15 M-必填 银联商户代码
请求人userId userId string M-必填 记录操作用户信息、便于后续查询
请求数据 data map M-必填 JSON格式数据,具体接口的参数信息作为该节点的属性值进行设置。
分页页面大小 pageSize int O-选填 10
分页页数 pageNumber int O-选填 1
筛选条件信息 data map M-必填
C类别名称 oneLevelName string 50 O-选填
T子类名称 twoLevelName string 50 O-选填
I项目名称 threeLevelName string 50 O-选填
S项目名称 fourLevelName string 50 O-选填
服务目录名称 serviceCategoryName string 50 O-选填
服务经理 serviceManagerName string 50 O-选填

应答参数

名称 标识 字段类型 长度 请求要求 默认值 备注
响应编号 respCd string 2 M-必填 详见应答码列表
相应信息 respMsg string 128 O-选填
响应数据 data map M-必填 JSON格式数据,具体接口的参数信息作为该节点的属性值进行设置。
服务目录数据 page map M-必填
分页页面大小 pageSize int M-必填
分页页数 pageNumber int M-必填
列表总数目 totalRecords int M-必填
服务目录列表 dataList array M-必填
C类别 oneLevelName string 50 M-必填
T子类 twoLevelName string 50 M-必填
I项目 threeLevelName string 50 M-必填
S子项 fourLevelName string 50 M-必填
服务目录全名 levelNameStr string 100 M-必填
服务时限 serviceTimeLimit int M-必填 单位:天。
服务经理 serviceManagerName string 50 M-必填
服务经理工号 serviceManagerId string 50 M-必填
联系方式 contactinfo string 50 M-必填
服务目录描述 serviceExplain string 500 M-必填
服务目录编号 serviceCategoryId string 50 M-必填
服务目录流程编号 serviceFlowConfigId string 50 M-必填
服务目录业务类型编号 typeID string 50 M-必填

接口名称

服务目录详情

接口描述

服务目录详情

接口地址

测试地址: 暂无


生产地址: https://openapi.unionpay.com/upapi/bos/tblSrvCategoryAction_findByCategoryId

请求方式

HTTP POST

请求url参数

名称 标识 字段类型 长度 请求要求 默认值 备注
产品token token string M-必填 详情请参考“获取token”接口中应答参数“token”的具体数据。
签名信息 sign string M-必填 详细签名算法可参考附加板块“签名样例代码”部分。
时间戳 ts int M-必填 单位:毫秒。

请求报文体参数

名称 标识 字段类型 长度 请求要求 默认值 备注
请求人工号 empNo string M-必填 操作人员工号信息
请求人IP ipAddr string M-必填 操作人ip地址
请求服务名字 serverName string M-必填 可为空串;记录服务名称
请求地址 uri string M-必填 可为空串;记录操作网页链接
人员类型 empType string M-必填
机构代码 insCode string 8 M-必填 非银联商户,此属性为对应的机构号信息
商户代码 mchntcd string 15 M-必填 银联商户代码
请求人userId userId string M-必填 记录操作用户信息、便于后续查询
请求数据 data map M-必填 JSON格式数据,具体接口的参数信息作为该节点的属性值进行设置。
服务目录号 vID string 50 M-必填 服务目录编号,形如“SCN1000005725”

应答参数

名称 标识 字段类型 长度 请求要求 默认值 备注
响应编号 respCd string 2 M-必填 详见应答码列表
相应信息 respMsg string 128 O-选填
响应数据 data map M-必填 JSON格式数据,具体接口的参数信息作为该节点的属性值进行设置。
服务目录详情信息 cate map M-必填
C类别名称 oneLevelName string 50 M-必填
T子类 twoLevelName string 50 M-必填
I项目 threeLevelName string 50 M-必填
S子项 fourLevelName string 50 M-必填
服务目录全名 levelNameStr string 100 M-必填
服务时限 serviceTimeLimit int M-必填 单位:天。
服务经理 serviceManagerName string 50 M-必填
服务经理工号 serviceManagerId string 50 M-必填
联系方式 contactinfo string 50 M-必填
服务目录描述 serviceExplain string 500 M-必填
服务目录编号 serviceCategoryId string 50 M-必填
服务目录流程编号 serviceFlowConfigId string 50 M-必填
服务目录业务类型详情 tblSrvTypeitemList array M-必填
业务类型是否有效 isactive string 1 M-必填
服务目录业务类型组号 typeid string M-必填
业务类型名称 typeitemname string 50 M-必填
业务类型编号 typeitemid string 50 M-必填

接口名称

服务目录说明

接口描述

服务目录模板下载说明

接口地址

测试地址: 暂无


生产地址: https://openapi.unionpay.com/upapi/bos/tblSrvCategoryAction_findFilesAndContentByCategoryId

请求方式

HTTP POST

请求url参数

名称 标识 字段类型 长度 请求要求 默认值 备注
产品token token string M-必填 详情请参考“获取token”接口中应答参数“token”的具体数据。
签名信息 sign string M-必填 详细签名算法可参考附加板块“签名样例代码”部分。
时间戳 ts int M-必填 单位:毫秒。

请求报文体参数

名称 标识 字段类型 长度 请求要求 默认值 备注
请求人工号 empNo string M-必填 操作人员工号信息
请求人IP ipAddr string M-必填 操作人ip地址
请求服务名字 serverName string M-必填 可为空串;记录服务名称
请求地址 uri string M-必填 可为空串;记录操作网页链接
人员类型 empType string M-必填
机构代码 insCode string 8 M-必填 非银联商户,此属性为对应的机构号信息
商户代码 mchntcd string 15 M-必填 银联商户代码
请求人userId userId string M-必填 记录操作用户信息、便于后续查询
请求数据 data map M-必填 JSON格式数据,具体接口的参数信息作为该节点的属性值进行设置。
服务目录号 vID string 50 M-必填

应答参数

名称 标识 字段类型 长度 请求要求 默认值 备注
响应编号 respCd string 2 M-必填 详见应答码列表
相应信息 respMsg string 128 O-选填
响应数据 data map M-必填 JSON格式数据,具体接口的参数信息作为该节点的属性值进行设置。
服务目录模板下载信息 fileList map M-必填
附件id attachmentid string M-必填
附件名称 attachmentname string M-必填
附件类型 attachmenttype string M-必填
文件大小 filesize double M-必填
文件后缀 filesuffix string M-必填
服务目录编号 formid string 50 M-必填
服务目录说明 serviceExplain string M-必填

接口名称

创建运营服务单

接口描述

创建服务单提交数据

接口地址

测试地址: 暂无


生产地址: https://openapi.unionpay.com/upapi/bos/srvOrderAction_submitSrv

请求方式

HTTP POST

请求url参数

名称 标识 字段类型 长度 请求要求 默认值 备注
产品token token string M-必填 详情请参考“获取token”接口中应答参数“token”的具体数据。
签名信息 sign string M-必填 详细签名算法可参考附加板块“签名样例代码”部分。
时间戳 ts int M-必填 单位:毫秒。

请求报文体参数

名称 标识 字段类型 长度 请求要求 默认值 备注
请求人工号 empNo string M-必填 操作人员工号信息
请求人IP ipAddr string M-必填 操作人ip地址
请求服务名字 serverName string M-必填 可为空串;记录服务名称
请求地址 uri string M-必填 可为空串;记录操作网页链接
人员类型 empType string M-必填
机构代码 insCode string 8 M-必填 非银联商户,此属性为对应的机构号信息
商户代码 mchntcd string 15 M-必填 银联商户代码
请求人userId userId string M-必填 记录操作用户信息、便于后续查询
请求数据 data map M-必填 JSON格式数据,具体接口的参数信息作为该节点的属性值进行设置。
服务单号 serviceOrderId string 50 M-必填 系统生成的唯一服务单号。
服务目录 serviceCategoryId string 50 M-必填
服务单名称 serviceDesc string 255 M-必填
需求描述 reqDesc string 2000 M-必填
业务类型ID typeItemId string 32 M-必填 依据服务目录详情中的“服务目录业务类型详情”信息。
业务类型名称 typeitemname string 100 M-必填 依据服务目录详情中的“服务目录业务类型详情”信息。
服务模式 bosDealType string 20 M-必填 iBOS00501-正常模式;iBOS00502-紧急模式
需求方类型 bosDemandSideType string 20 M-必填 iBOS00201-机构;iBOS00202-商户
需求人姓名 aname string 50 M-必填
需求人账号 auserName string 50 M-必填
需求方机构代码 bosInscode string 50 M-必填
需求方机构名称 bosInscodeName string 100 M-必填
邮箱 email string 500 M-必填
手机号 mobile string 50 M-必填
电话座机 phone string 50 M-必填
是否具有数据用途 isDataPurpose string 1 M-必填 固定是0

应答参数

名称 标识 字段类型 长度 请求要求 默认值 备注
响应编号 respCd string 4 M-必填 详见应答码列表
信息描述 respMsg string M-必填 返回的信息
响应数据 data map M-必填 JSON格式数据,具体接口的参数信息作为该节点的属性值进行设置;与原提交数据一致。
服务单号 serviceOrderId string 50 M-必填 "serviceOrderId":"FWD100095535"
服务经理 serviceManagerName string 50 M-必填 "serviceManagerName":"顾小微"
服务单名称 serviceDesc string 255 M-必填 "serviceDesc":"123"
发起时间 createTime string 18 M-必填 "createTime":"2017-10-20 17:35:11"
正常服务时限 orignservicetimelimit double M-必填 "orignservicetimelimit":4 单位:天
状态 bosStatusStr string 50 M-必填 "bosStatusStr":"待审核"
SLA达成时间 requestFinishTimeSla string 18 M-必填 "requestFinishTimeSla":"2017-10-26 17:00:00"
服务模式 bosDealType string 20 M-必填 "bosDealType":"iBOS00501"
服务目录 levelNameStr string 255 M-必填 "levelNameStr":"业务分析>业务专题分析>业务运营数据分析"
业务类型 typeitemname string 100 M-必填 "typeitemname":"代收付"
用户名 auserName string 50 M-必填 "auserName":"01073032"
用户姓名 aname string 50 M-必填 "aname":"许广繁"
机构代码 bosInscode string 50 M-必填 "bosInscode":"00010000"
机构名称 bosInscodeName string 100 M-必填 "bosInscodeName":"中国银联"
邮箱 email string 500 M-必填 "email":"xuguangfan@unionpay.com"
手机 mobile string 50 M-必填 "mobile":"13795347881"
座机 phone string 50 M-必填 "phone":"021-50362410"
提交人姓名 createUserName string 50 M-必填 "createUserName":"许广繁"
提交人邮箱 createUserEmail string 50 M-必填 "createUserPhone":"021-50362410"
提交人手机 createUserMobile string 20 M-必填 "createUserMobile":"13795347881"
提交人座机 createUserPhone string 20 M-必填 "createUserPhone":"021-50362410"
需求描述 reqDesc string 2000 M-必填 "reqDesc":"123$^^${\"changeObject\":\"代付平台\",\"changeObjectOther\":\"\",\"isValidPass\":\"是\",\"isSubmit\":\"是\",\"isInvolve\":\"是\",\"changeToPayAffect\":\"是\"}"
期望完成时间 finishTimeHope string M-必填 "finishTimeHope":null 年月日时分秒
其他联系人 otherPerson string 20 M-必填 "otherPerson":null
联系方式 otherPersonContact string 50 M-必填 "otherPersonContact":null

接口名称

我提交的服务单

接口描述

我发起的服务单查询

接口地址

测试地址: 暂无


生产地址: https://openapi.unionpay.com/upapi/bos/srvOrderQueryAction_queryMyOriPage

请求方式

HTTP POST

请求url参数

名称 标识 字段类型 长度 请求要求 默认值 备注
产品token token string M-必填 详情请参考“获取token”接口中应答参数“token”的具体数据。
签名信息 sign string M-必填 详细签名算法可参考附加板块“签名样例代码”部分。
时间戳 ts int M-必填 单位:毫秒。

请求报文体参数

名称 标识 字段类型 长度 请求要求 默认值 备注
请求人工号 empNo string M-必填 操作人员工号信息
请求人IP ipAddr string M-必填 操作人ip地址
请求服务名字 serverName string M-必填 可为空串;记录服务名称
请求地址 uri string M-必填 可为空串;记录操作网页链接
人员类型 empType string M-必填
机构代码 insCode string 8 M-必填 非银联商户,此属性为对应的机构号信息
商户代码 mchntcd string 15 M-必填 银联商户代码
请求人userId userId string M-必填 记录操作用户信息、便于后续查询
请求数据 data map M-必填 JSON格式数据,具体接口的参数信息作为该节点的属性值进行设置。
分页页数 pageNumber int M-必填
分页页面大小 pageSize int M-必填
筛选条件信息 data map M-必填
服务单号 serviceOrderId string 50 O-选填
服务单名称 serviceDesc string 255 O-选填
C类别 oneLevelName string 50 O-选填
T子类 twoLevelName string 50 O-选填
I项目 threeLevelName string 50 O-选填
S子项 fourLevelName string 50 O-选填
服务单状态 bosStatus string 20 O-选填
开始时间 createTimeStr1 string 10 O-选填 年月日,如“2017-10-23”
结束时间 createTimeStr2 string 10 O-选填 年月日,如“2017-10-23”

应答参数

名称 标识 字段类型 长度 请求要求 默认值 备注
响应编号 respCd string 2 M-必填 详见应答码列表
相应信息 respMsg string 128 O-选填
响应数据 data map M-必填 JSON格式数据,具体接口的参数信息作为该节点的属性值进行设置。
列表数据 page map M-必填
分页页面大小 pageSize int M-必填
分页页数 pageNumber int M-必填
列表总数目 totalRecords int M-必填
服务目录列表 dataList array M-必填
服务单号 serviceOrderId string 50 M-必填
服务单超期状态 overDueStatus string 20 M-必填
服务单名称 serviceDesc string 255 M-必填
状态编号 bosStatus string 50 M-必填
状态名 bosStatusStr string 50 M-必填
服务单提交时间 submitTime string 18 M-必填 年月日时分秒,如2017-10-24 16:45:01
服务单到期时间 requestFinishtimeSla string 18 M-必填 年月日时分秒,如2017-10-24 16:45:01
服务单性质 serviceType string 20 M-必填
服务单流程号 processInstID string 50 M-必填
C类别 oneLevelName string 50 M-必填
T子类 twoLevelName string 50 M-必填
I项目 threeLevelName string 50 M-必填
S子项 fourLevelName string 50 M-必填
需求方 bosInscode string 100 M-必填
需求方名称 bosInscodeName string 50 M-必填
提交人 createUserName string 50 M-必填
起始时间 submitTimeStr1 string 18 O-选填 年月日时分秒
结束时间 submitTimeStr2 string 18 O-选填 年月日时分秒

接口名称

银联服务单详情

接口描述

BOS服务单详情

接口地址

测试地址: 暂无


生产地址: https://openapi.unionpay.com/upapi/bos/srvOrderAction_findBySrvId

请求方式

HTTP POST

请求url参数

名称 标识 字段类型 长度 请求要求 默认值 备注
产品token token string M-必填 详情请参考“获取token”接口中应答参数“token”的具体数据。
签名信息 sign string M-必填 详细签名算法可参考附加板块“签名样例代码”部分。
时间戳 ts int M-必填 单位:毫秒。

请求报文体参数

名称 标识 字段类型 长度 请求要求 默认值 备注
请求人工号 empNo string M-必填 操作人员工号信息
请求人IP ipAddr string M-必填 操作人ip地址
请求服务名字 serverName string M-必填 可为空串;记录服务名称
请求地址 uri string M-必填 可为空串;记录操作网页链接
人员类型 empType string M-必填
机构代码 insCode string 8 M-必填 非银联商户,此属性为对应的机构号信息
商户代码 mchntcd string 15 M-必填 银联商户代码
请求人userId userId string M-必填 记录操作用户信息、便于后续查询
请求数据 data map M-必填 JSON格式数据,具体接口的参数信息作为该节点的属性值进行设置。
服务单号 vID string 50 M-必填 形如:FWD100103395

应答参数

名称 标识 字段类型 长度 请求要求 默认值 备注
响应编号 respCd string 2 M-必填 详见应答码列表
相应信息 respMsg string 128 O-选填
响应数据 data map M-必填 JSON格式数据,具体接口的参数信息作为该节点的属性值进行设置。
服务单详情 srv map M-必填
服务单号 serviceOrderId string 50 M-必填
服务经理 serviceManagerName string 50 M-必填
服务单名称 serviceDesc string 255 M-必填
发起时间 createTime string 18 M-必填 年月日时分秒,如2017-10-26 17:00:00
正常服务时限 orignservicetimelimit string 10 M-必填 单位:天。
状态 bosStatusStr string 50 M-必填
SLA达成时间 requestFinishTimeSla string 18 M-必填 年月日时分秒,如2017-10-26 17:00:00
服务模式 bosDealType string 20 M-必填
服务目录 levelNameStr string 255 M-必填
业务类型 typeitemname string 100 M-必填
用户名 auserName string 50 M-必填
用户姓名 aname string 50 M-必填
机构代码 bosInscode string 50 M-必填
机构名称 bosInscodeName string 100 M-必填
邮箱 email string 500 M-必填
手机 mobile string 50 M-必填
座机 phone string 50 M-必填
提交人姓名 createUserName string 50 M-必填
提交人邮箱 createUserEmail string 50 M-必填
提交人手机 createUserMobile string 20 M-必填
提交人座机 createUserPhone string 20 M-必填
需求描述 reqDesc string 2000 M-必填
期望完成时间 finishTimeHope string 18 M-必填 年月日时分秒
其他联系人 otherPerson string 20 M-必填
联系方式 otherPersonContact string 50 M-必填
产品详情

资费详情:

针对资费详情,法律合规部 给的意见如下:   

    本产品推广期为2017年10月1日至2018年12月31日,推广期内本产品可免费使用。推广期过后的收费标准将提前30个工作日在本平台另行公示。


应用对象

银联商户、合作机构

接入流程
  1. 如需申请该API,请点击右上角“业务申请”,并认真填写相关内容;

  2. 待业务接口人审核通过后即可调用该API,审核周期约为2-3个工作日;

  3. 技术联调,可参照《“快速接入”产品API技术文档—接入指南》


应答码参照:
应答码 描述
0000 处理成功
0001 处理失败。
2001 没有权限查看。
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公钥是否正确。
9917 您的账号不具备当前产品API请求权限,请联系相关业务接口人。
9991 银联技术开放平台系统内部错误:产品服务调用失败。
9992 银联技术开放平台系统内部错误:产品服务系统未知错误。
9993 银联技术开放平台系统内部错误:产品服务未注册至服务中心。
9994 银联技术开放平台系统内部错误:产品服务参数错误。

请求URL:

https://openapi.unionpay.com/upapi/bos/srvOrderQueryAction_oneLevelNameSelect?token=value&sign=value&ts=value

 

请求JSON报文体:

{

“empNo”: “test222”,

“empType”: “iBOS010030”,

“ipAddr”: “172.0.0.1”,

“serverName”:””,

“uri”:””

“insCode”:””,

“mchntcd”:”123456789012345”

“userId”:”test222”,

“data”:{}

}

 

应答JSON报文体:

{

“respCd”: “0000”,

“respMsg”: “”,

“data”: {

       “OneLevelNameList”: [

{

      “oneLevelName”: “业务管理”

}

]

 }

 

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

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


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

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

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


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

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


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

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

常见问题
1. 调用接口返回提示 {"respMsg":"body or sign is null.","respCd":"9905"}
解答详情:

API接口需使用body部分传送JSON数据,故而HTTP请求的content-type需使用application/json,而不是application/x-www-form-urlencoded。