中国银联开放平台

支持中心

接口列表

优客

优客

查看产品

更新时间：2026-01-19

优客标签服务接口

接口描述

该接口为标签服务接口，通过服务请求报文，反馈标签应答报文

请求方式

POST

生产调用地址

https://openapi.unionpay.com/upapi/youke/MarketingService

测试调用地址

暂无

URL请求参数

中文名称	英文名称	域类型	请求要求	备注
产品token	token	string	M-必填	详情请参考“获取token”接口中应答参数“token”的具体数据。
签名信息	sign	string	M-必填	详细签名算法可参考附录“签名样例代码”部分。
时间戳	ts	long	M-必填	单位毫秒，对于Java一般使用System.currentTimeMillis();获取

HTTP报文体参数

中文名称	英文名称	域类型	域长度	请求要求	备注
流水号	requestNo	string	64	M-必填	必填，需保证唯一性，用于唯一定位一笔请求
手机号	phone	string	64	O-选填	标准SM3加密(手机号和身份证号至少有一项不为空)
标签类型	labelTp	string	4	M-必填	用于区分标签组类型
身份证号	artifCertifId	string	64	O-选填	标准SM3加密(手机号和身份证号至少有一项不为空)
营业执照号	licNo	string	32	O-选填	用于计算商户侧标签
日期	applyDate	string	8	O-选填	若日期为空，则使用默认日期（即发起查询请求当天的日期）
调用类型	requestTp	string	2	O-选填	选填，业务请求类型（01：实时调用；02：集中调用；03：集中调用发起请求；04：集中调用获取结果）
机构号	insIdCd	string	8	M-必填	必填，接入时分配
授权码	authorizeCd	string	16	M-必填	必填，表示该用户已获得查询授权。

同步应答参数

示例代码

{

"phone" : "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",

"artifCertifId" : "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",

"applydate" : "20210721",

"insIdCd" : "00000000",

"authorizeCd" : "1"

}

复制