支付标记化服务

风控 Token支付 收单机构 发卡机构
支付标记化服务是中国银联推出的数字支付基础安全服务,能为银行、支付机构、行业机构的支付创新提供安全保障。开通该服务后,可以用特定的支付标记(即Token)替代传统的银行卡号,有效降低了商户、受理机构侧发生的银行卡信息泄露风险,减少交易欺诈。

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

API ID:131

接口状态:正常

请咨询联系人
暂不支持测试

接口名称

Token申请

接口描述

Token申请

接口地址

测试地址: 敬请期待


生产地址: 敬请期待

请求方式

HTTP GET

请求报文体参数

名称 标识 字段类型 长度 请求要求 默认值 备注
版本号 version string M-必填 5.1.0
编码方式 encoding string M-必填 UTF-8
证书ID certId string M-必填
签名 signature string M-必填
签名方法 signMethod string M-必填
交易类型 txnType string M-必填
交易子类 txnSubType string M-必填 01-Token申请
产品类型 bizType string M-必填
接入类型 accessType string M-必填
渠道类型 channelType string M-必填
收单机构代码 acqInsCode string C-依条件必填 接入类型取值为1时需上送
商户代码 merId string M-必填
是否子Token subToken string M-必填
交易流水号 orderId string M-必填 当日内唯一
交易传输时间 txnTime string M-必填
TRID trId string M-必填
主账号 accNo string M-必填 应答码为00时,应答报文中返回后4位卡尾号
Token域控信息标识 tokenType string C-依条件必填 境内TR必须上送
Token预期使用时长 tokenExpireDt string M-必填
Token最大交易次数 availCount string M-必填
渠道类型权限位图 chnlPerm string M-必填
交易商户范围 mchtRange string M-必填
Token单笔交易限额 maxTransAt string M-必填
Token单笔交易限额币种 maxTransCurrCd string C-依条件必填 仅跨境Token申请时使用
持卡人身份认证信息 customerInfo string M-必填
加密证书ID encryptCertId string C-依条件必填
环境认证信息 tkEnvInfo string O-选填
Token存放位置 tokenStore string M-必填
设备ID tkDeviceId string C-依条件必填 基于SE的移动支付产品(如三星Pay、苹果Pay、华为Pay、小米Pay)必须上送SEID基于HCE的移动支付产品必须上送MAC+IMEI
Token应用场景标识 tokenSubType string M-必填 an2
Token产品标识 tokenProduct string C-依条件必填 Token应用于银联移动支付产品时,TR根据《中国银联移动支付技术规范》中的产品细类定义上送对应的产品标识取值
附加数据类型标识 addnDataType string C-依条件必填 当需要获取特定附加数据时,TR必须上送该标识,指明所需附加数据类型
商户类别 merCatCode string C-依条件必填 接入类型为收单机构接入时需上送
商户名称 merName string C-依条件必填 接入类型为收单机构接入时需上送
商户简称 merAbbr string C-依条件必填 接入类型为收单机构接入时需上送
二级商户代码 subMerId string C-依条件必填 商户类型为平台类商户接入时必须上送
二级商户名称 subMerName string C-依条件必填 商户类型为平台类商户接入时必须上送
二级商户简称 subMerAbbr string C-依条件必填 商户类型为平台类商户接入时必须上送

应答参数

名称 标识 字段类型 长度 请求要求 默认值 备注
版本号 version string R-原值返回 5.1.0
编码方式 encoding string R-原值返回 UTF-8
签名 signature string M-必填
签名方法 signMethod string M-必填
交易类型 txnType string R-原值返回
交易子类 txnSubType string R-原值返回 01-Token申请
产品类型 bizType string R-原值返回
接入类型 accessType string R-原值返回
收单机构代码 acqInsCode string R-原值返回 接入类型取值为1时需上送
商户代码 merId string R-原值返回
是否子Token subToken string R-原值返回
交易流水号 orderId string R-原值返回 当日内唯一
交易传输时间 txnTime string R-原值返回
TRID trId string R-原值返回
主账号 accNo string C-依条件必填 应答码为00时,应答报文中返回后4位卡尾号
Token域控信息标识 tokenType string R-原值返回 境内TR必须上送
Token预期使用时长 tokenExpireDt string R-原值返回
Token最大交易次数 availCount string R-原值返回
渠道类型权限位图 chnlPerm string R-原值返回
交易商户范围 mchtRange string R-原值返回
Token单笔交易限额 maxTransAt string R-原值返回
Token单笔交易限额币种 maxTransCurrCd string C-依条件必填 仅跨境Token申请时使用
Token token string C-依条件必填 应答码为00时返回
Token担保级别 tokenLevel string C-依条件必填 应答码为00时返回,取值待定
Token生效时间 tokenBegin string C-依条件必填 应答码为00时返回
Token失效时间 tokenEnd string C-依条件必填 应答码为00时返回,取值待定
个人化数据 persoData string C-依条件必填 应答码为00,且“附加数据类型标识”指明存在个人化数据时返回。对于HCE和AM类产品,应答码为00时返回
应答码 respCode string M-必填
应答信息 respMsg string M-必填
附加数据类型标识 addnDataType string R-原值返回 当需要获取特定附加数据时,TR必须上送该标识,指明所需附加数据类型
MST数据 mstData string C-依条件必填 应答码为00且附加数据类型标识取值为1时返回
卡数据算法标识 cardDataAlgID string C-依条件必填 当有个人化数据或MST数据时必须返回,表明数据加密使用的算法
支付账户参考号 par string C-依条件必填 应答为成功时必须返回
签名公钥证书 signPubKeyCert string C-依条件必填 使用RSA算法时必须返回
商户类别 merCatCode string R-原值返回 接入类型为收单机构接入时需上送
商户名称 merName string R-原值返回 接入类型为收单机构接入时需上送
商户简称 merAbbr string R-原值返回 接入类型为收单机构接入时需上送
二级商户代码 subMerId string R-原值返回 商户类型为平台类商户接入时必须上送
二级商户名称 subMerName string R-原值返回 商户类型为平台类商户接入时必须上送
二级商户简称 subMerAbbr string R-原值返回 商户类型为平台类商户接入时必须上送

接口名称

Token状态更新

接口描述

Token状态更新

接口地址

测试地址: 敬请期待


生产地址: 敬请期待

请求方式

HTTP GET

请求报文体参数

名称 标识 字段类型 长度 请求要求 默认值 备注
版本号 version string M-必填
编码方式 encoding string M-必填 UTF-8
证书ID certId string M-必填
签名 signature string M-必填
签名方法 signMethod string M-必填
交易类型 txnType string M-必填
交易子类 txnSubType string M-必填 07-Token状态更新
产品类型 bizType string M-必填
接入类型 accessType string M-必填
渠道类型 channelType string M-必填
收单机构代码 acqInsCode string C-依条件必填 接入类型取值为1时需上送
商户代码 merId string M-必填
交易流水号 orderId string M-必填
交易传输时间 txnTime string M-必填
TRID trId string M-必填
Token token string M-必填
Token状态 tokenStatus string M-必填 发起方期望的Token状态
商户类别 merCatCode string C-依条件必填 接入类型为收单机构接入时需上送
商户名称 merName string C-依条件必填 接入类型为收单机构接入时需上送
商户简称 merAbbr string C-依条件必填 接入类型为收单机构接入时需上送
二级商户代码 subMerId string C-依条件必填 商户类型为平台类商户接入时必须上送
二级商户名称 subMerName string C-依条件必填 商户类型为平台类商户接入时必须上送
二级商户简称 subMerAbbr string C-依条件必填 商户类型为平台类商户接入时必须上送

应答参数

名称 标识 字段类型 长度 请求要求 默认值 备注
版本号 version string R-原值返回
编码方式 encoding string R-原值返回 UTF-8
签名 signature string M-必填
签名方法 signMethod string M-必填
交易类型 txnType string R-原值返回
交易子类 txnSubType string R-原值返回 07-Token状态更新
产品类型 bizType string R-原值返回
接入类型 accessType string R-原值返回
收单机构代码 acqInsCode string R-原值返回 接入类型取值为1时需上送
商户代码 merId string R-原值返回
交易流水号 orderId string R-原值返回
交易传输时间 txnTime string R-原值返回
TRID trId string R-原值返回
Token token string R-原值返回
Token状态 tokenStatus string R-原值返回 发起方期望的Token状态
应答码 tokenResultCd string M-必填
应答信息 tokenResultMsg string M-必填
签名公钥证书 signPubKeyCert string C-依条件必填 使用RSA算法时必须上送
商户类别 merCatCode string R-原值返回 接入类型为收单机构接入时需上送
商户名称 merName string R-原值返回 接入类型为收单机构接入时需上送
商户简称 merAbbr string R-原值返回 接入类型为收单机构接入时需上送
二级商户代码 subMerId string R-原值返回 商户类型为平台类商户接入时必须上送
二级商户名称 subMerName string R-原值返回 商户类型为平台类商户接入时必须上送
二级商户简称 subMerAbbr string R-原值返回 商户类型为平台类商户接入时必须上送

接口名称

Token信息更新

接口描述

Token信息更新

接口地址

测试地址: 敬请期待


生产地址: 敬请期待

请求方式

HTTP GET

请求报文体参数

名称 标识 字段类型 长度 请求要求 默认值 备注
版本号 version string M-必填
编码方式 encoding string M-必填 默认取值:UTF-8
证书ID certId string M-必填
签名 signature string M-必填
签名方法 signMethod string M-必填
交易类型 txnType string M-必填
交易子类 txnSubType string M-必填 02-Token信息更新
产品类型 bizType string M-必填
接入类型 accessType string M-必填
渠道类型 channelType string M-必填
收单机构代码 acqInsCode string C-依条件必填 接入类型取值为1时需上送
商户代码 merId string M-必填
交易流水号 orderId string M-必填
交易传输时间 txnTime string M-必填
TRID trId string M-必填
Token token string M-必填 取值为申请Token
主账号 accNo string O-选填 在更新卡号时请求报文中需要上送新的银行卡号;如更新卡号成功,则在应答报文中返回4位卡尾号
Token预期使用时长 tokenExpireDt string M-必填 TSP使用新提交的时间更新原时间
持卡人身份认证信息 costomerInfo string M-必填 TSP使用新提交的身份认证信息更新原信息
Token请求担保级别 reqTokenLevel string O-选填
DPanId dpanId string C-依条件必填
FPanId fpanId string C-依条件必填
商户类别 merCatCode string C-依条件必填 接入类型为收单机构接入时需上送
商户名称 merName string C-依条件必填 接入类型为收单机构接入时需上送
商户简称 merAbbr string C-依条件必填 接入类型为收单机构接入时需上送
二级商户代码 subMerId string C-依条件必填 商户类型为平台类商户接入时必须上送
二级商户名称 subMerName string C-依条件必填 商户类型为平台类商户接入时必须上送
二级商户简称 subMerAbbr string C-依条件必填 商户类型为平台类商户接入时必须上送

应答参数

名称 标识 字段类型 长度 请求要求 默认值 备注
版本号 version string R-原值返回
编码方式 encoding string R-原值返回 默认取值:UTF-8
签名 signature string M-必填
签名方法 signMethod string M-必填
交易类型 txnType string R-原值返回
交易子类 txnSubType string R-原值返回 02-Token信息更新
产品类型 bizType string R-原值返回
接入类型 accessType string R-原值返回
收单机构代码 acqInsCode string R-原值返回 接入类型取值为1时需上送
商户代码 merId string R-原值返回
交易流水号 orderId string R-原值返回
交易传输时间 txnTime string M-必填
TRID trId string R-原值返回
Token token string R-原值返回 取值为申请Token
主账号 accNo string C-依条件必填 在更新卡号时请求报文中需要上送新的银行卡号;如更新卡号成功,则在应答报文中返回4位卡尾号
Token预期使用时长 tokenExpireDt string R-原值返回 TSP使用新提交的时间更新原时间
Token担保级别 tokenLevel string C-依条件必填 应答码为00时返回
Token生效时间 tokenBegin string C-依条件必填 应答码为00时返回
Token失效时间 tokenEnd string C-依条件必填 应答码为00时返回
应答码 respCode string M-必填
应答信息 respMsg string M-必填
支付账户参考号 par string C-依条件必填 应答为成功时必须返回
签名公钥证书 signPubKeyCert string C-依条件必填 使用RSA算法时必须上送
商户类别 merCatCode string R-原值返回 接入类型为收单机构接入时需上送
商户名称 merName string R-原值返回 接入类型为收单机构接入时需上送
商户简称 merAbbr string R-原值返回 接入类型为收单机构接入时需上送
二级商户代码 subMerId string R-原值返回 商户类型为平台类商户接入时必须上送
二级商户名称 subMerName string R-原值返回 商户类型为平台类商户接入时必须上送
二级商户简称 subMerAbbr string R-原值返回 商户类型为平台类商户接入时必须上送

接口名称

Token-卡号映射关系同步

接口描述

Token-卡号映射关系同步

接口地址

测试地址: 敬请期待


生产地址: 敬请期待

请求方式

HTTP GET

请求报文体参数

名称 标识 字段类型 长度 请求要求 默认值 备注
版本号 version string M-必填 2.0
编码方式 encoding string M-必填 默认取值:UTF-8
证书ID certId string M-必填
签名 msgSign string M-必填
签名方法 signMethod string M-必填
交易类型 txnType string M-必填
交易子类 txnSubType string M-必填 08-Token-卡号映射关系同步
产品类型 bizType string M-必填
接入类型 accessType string M-必填
渠道类型 channelType string M-必填
收单机构代码 acqInsCode string C-依条件必填 接入类型取值为1时需上送
商户代码 merId string M-必填
交易流水号 orderId string M-必填
交易传输时间 txnTime string M-必填
请求报文机构 fwdIns string C-依条件必填 报文请求方有机构代码时需要上送
TRID trId string M-必填 填写TSP分配给外部TSP的代码
Token token string M-必填 取值为Token号
主账号 accNo string M-必填 取值为与Token号关联的银行卡号
Token生效时间 tokenBegin string C-依条件必填 交易发起方为Token生成方时需要上送
Token失效时间 tokenEnd string C-依条件必填 交易发起方为Token生成方时需要上送
Token状态 tokenStatus string M-必填
卡等级 cardLevel string M-必填
DPanId dpanId string C-依条件必填
FPanId fpanId string C-依条件必填
设备ID tkDeviceId string M-必填 ans1~64,移动支付产品(如三星支付、苹果支付、云闪付)HCE产品上送MAC+IMEI
Token信息更新时间 tkUpdTm string M-必填 该笔Token映射关系信息发生变化的时间
商户类别 merCatCode string C-依条件必填 接入类型为收单机构接入时需上送
商户名称 merName string C-依条件必填 接入类型为收单机构接入时需上送
商户简称 merAbbr string C-依条件必填 接入类型为收单机构接入时需上送

应答参数

名称 标识 字段类型 长度 请求要求 默认值 备注
版本号 version string R-原值返回 2.0
编码方式 encoding string R-原值返回 默认取值:UTF-8
签名 msgSign string M-必填
签名方法 signMethod string M-必填
交易类型 txnType string R-原值返回
交易子类 txnSubType string R-原值返回 08-Token-卡号映射关系同步
产品类型 bizType string R-原值返回
接入类型 accessType string R-原值返回
收单机构代码 acqInsCode string R-原值返回 接入类型取值为1时需上送
商户代码 merId string R-原值返回
交易流水号 orderId string R-原值返回
交易传输时间 txnTime string R-原值返回
请求报文机构 fwdIns string R-原值返回 报文请求方有机构代码时需要上送
TRID trId string R-原值返回 填写TSP分配给外部TSP的代码
Token token string R-原值返回 取值为Token号
主账号 accNo string R-原值返回 取值为与Token号关联的银行卡号
应答码 respCode string M-必填
应答信息 respMsg string M-必填
签名公钥证书 signPubKeyCert string C-依条件必填 使用RSA算法时必须上送
商户类别 merCatCode string R-原值返回 接入类型为收单机构接入时需上送
商户名称 merName string R-原值返回 接入类型为收单机构接入时需上送
商户简称 merAbbr string R-原值返回 接入类型为收单机构接入时需上送

接口名称

Token通用查询

接口描述

Token通用查询

接口地址

测试地址: 敬请期待


生产地址: 敬请期待

请求方式

HTTP GET

请求报文体参数

名称 标识 字段类型 长度 请求要求 默认值 备注
版本号 version string M-必填 2.0
编码方式 encoding string M-必填 UTF-8
证书ID certId string M-必填
签名 signature string M-必填
签名方法 signMethod string M-必填
交易类型 txnType string M-必填
交易子类 txnSubType string M-必填 根据查询类型取值;11-par查询
产品类型 bizType string M-必填
接入类型 accessType string M-必填
收单机构代码 acqInsCode string C-依条件必填 接入类型取值为1时需上送
请求报文机构 fwdIns string C-依条件必填 查询方不是TR时,必须出现,填写所属机构代码
查询发起方角色类型 incType string M-必填
TRID trId string C-依条件必填 查询发起方角色类型为1,即TR作为查询方时需上送
商户代码 merId string M-必填 接入类型为商户时,上送商户代码;接入类型为收单机构时,上送本机构的合法商户代码
交易流水号 orderId string M-必填
交易传输时间 txnTime string M-必填
Token token string C-依条件必填 根据Token查询信息时,必须上送
主账号 accNo string C-依条件必填 根据卡号查询PAR时必须上送
商户类别 merCatCode string C-依条件必填 接入类型为收单机构接入时需上送
商户名称 merName string C-依条件必填 接入类型为收单机构接入时需上送
商户简称 merAbbr string C-依条件必填 接入类型为收单机构接入时需上送
二级商户代码 subMerId string C-依条件必填 商户类型为平台类商户接入时必须上送
二级商户名称 subMerName string C-依条件必填 商户类型为平台类商户接入时必须上送
二级商户简称 subMerAbbr string C-依条件必填 商户类型为平台类商户接入时必须上送

应答参数

名称 标识 字段类型 长度 请求要求 默认值 备注
版本号 version string R-原值返回 2.0
编码方式 encoding string R-原值返回 UTF-8
签名 signature string M-必填
签名方法 signMethod string M-必填
交易类型 txnType string R-原值返回
交易子类 txnSubType string R-原值返回 根据查询类型取值;11-par查询
产品类型 bizType string R-原值返回
接入类型 accessType string R-原值返回
收单机构代码 acqInsCode string R-原值返回 接入类型取值为1时需上送
请求报文机构 fwdIns string R-原值返回 查询方不是TR时,必须出现,填写所属机构代码
TRID trId string R-原值返回 查询发起方角色类型为1,即TR作为查询方时需上送
商户代码 merId string R-原值返回 接入类型为商户时,上送商户代码;接入类型为收单机构时,上送本机构的合法商户代码
交易流水号 orderId string R-原值返回
交易传输时间 txnTime string R-原值返回
查询par数据 par string C-依条件必填 应答码为00时需返回
应答码 respCode string M-必填
应答信息 respMsg string M-必填
签名公钥证书 signPubKeyCert string C-依条件必填 使用RSA算法时必须上送
商户类别 merCatCode string R-原值返回 接入类型为收单机构接入时需上送
商户名称 merName string R-原值返回 接入类型为收单机构接入时需上送
商户简称 merAbbr string R-原值返回 接入类型为收单机构接入时需上送
二级商户代码 subMerId string R-原值返回 商户类型为平台类商户接入时必须上送
二级商户名称 subMerName string R-原值返回 商户类型为平台类商户接入时必须上送
二级商户简称 subMerAbbr string R-原值返回 商户类型为平台类商户接入时必须上送

接口名称

支付类去标记化

接口描述

支付类去标记化

接口地址

测试地址: 敬请期待


生产地址: 敬请期待

请求方式

HTTP GET

请求报文体参数

名称 标识 字段类型 长度 请求要求 默认值 备注
版本号 version string M-必填
编码方式 encoding string M-必填 UTF-8
证书ID certId string M-必填
签名 signature string M-必填
签名方法 signMethod string M-必填
交易类型 txnType string M-必填
交易子类 txnSubType string M-必填 填写04或05
产品类型 bizType string M-必填
接入类型 accessType string M-必填
渠道类型 channelType string M-必填
请求报文机构 fwdIns string M-必填 填写机构代码
交易流水号 orderId string M-必填
交易传输时间 txnTime string M-必填
TRID trId string O-选填 请求方为CUPS,该字段必回
Token号 token string M-必填
交易金额 txnAmt string M-必填 无交易金额时,上送0
交易币种 currencyCode string C-依条件必填 仅跨境Token使用,交易金额的币种
Token有效期失效期 tokenEndExpr string O-选填 TSP返回Token失效时间的年月;请求方为CUPS,该字段必回
收单机构代码 acqInsCode string C-依条件必填 接入类型取值为1时需上送
商户代码 merId string M-必填
交易发起方式 tokenScene string M-必填
交易介质 transMedia string M-必填
卡序列号 cardSeq string O-选填 当发卡需要该域时,TSP才返回该域
附加信息 attachData string O-选填 需要传递附加信息时,TSP返回该域
请求方保留 reqReserved string O-选填 如果请求中出现,则应答必须原样返回;否则应答不出现
商户类别 merCatCode string C-依条件必填 接入类型为收单机构接入时需上送
商户名称 merName string C-依条件必填 接入类型为收单机构接入时需上送
商户简称 merAbbr string C-依条件必填 接入类型为收单机构接入时需上送
二级商户代码 subMerId string C-依条件必填 商户类型为平台类商户接入时必须上送
二级商户名称 subMerName string C-依条件必填 商户类型为平台类商户接入时必须上送
二级商户简称 subMerAbbr string C-依条件必填 商户类型为平台类商户接入时必须上送

应答参数

名称 标识 字段类型 长度 请求要求 默认值 备注
版本号 version string R-原值返回
编码方式 encoding string R-原值返回 UTF-8
签名 signature string M-必填
签名方法 signMethod string M-必填
交易类型 txnType string R-原值返回
交易子类 txnSubType string R-原值返回 填写04或05
产品类型 bizType string R-原值返回
接入类型 accessType string R-原值返回
请求报文机构 fwdIns string R-原值返回 填写机构代码
交易流水号 orderId string R-原值返回
交易传输时间 txnTime string R-原值返回
TRID trId string C-依条件必填 请求方为CUPS,该字段必回
交易金额 txnAmt string R-原值返回 无交易金额时,上送0
交易币种 currencyCode string R-原值返回 仅跨境Token使用,交易金额的币种
Token有效期失效期 tokenEndExpr string C-依条件必填 TSP返回Token失效时间的年月;请求方为CUPS,该字段必回
收单机构代码 acqInsCode string R-原值返回 接入类型取值为1时需上送
商户代码 merId string R-原值返回
卡序列号 cardSeq string C-依条件必填 当发卡需要该域时,TSP才返回该域
附加信息 attachData string C-依条件必填 需要传递附加信息时,TSP返回该域
主账号 accNo string C-依条件必填 Token关联卡号,应答码为00时返回
卡有效期 customerInfo string C-依条件必填 当Token申请时提交了卡有效期数据时,去标记化应答中返回TSP存储的卡有效期;使用子域expire返回
Token应用场景标识 tokenSubType string C-依条件必填 应答码为00时返回;请求方为CUPS,该字段必回
Token担保级别 tokenLevel string C-依条件必填 应答码为00时返回;请求方为CUPS,该字段必回
应答码 respCode string M-必填
应答信息 respMsg string M-必填
请求方保留 reqReserved string R-原值返回 如果请求中出现,则应答必须原样返回;否则应答不出现
支付账户参考号 par string C-依条件必填 应答为成功时必须返回
签名公钥证书 signPubKeyCert string C-依条件必填 使用RSA算法时必须上送
商户类别 merCatCode string R-原值返回 接入类型为收单机构接入时需上送
商户名称 merName string R-原值返回 接入类型为收单机构接入时需上送
商户简称 merAbbr string R-原值返回 接入类型为收单机构接入时需上送
二级商户代码 subMerId string R-原值返回 商户类型为平台类商户接入时必须上送
二级商户名称 subMerName string R-原值返回 商户类型为平台类商户接入时必须上送
二级商户简称 subMerAbbr string R-原值返回 商户类型为平台类商户接入时必须上送

接口名称

查询类去标记化

接口描述

查询类去标记化

接口地址

测试地址: 敬请期待


生产地址: 敬请期待

请求方式

HTTP GET

请求报文体参数

名称 标识 字段类型 长度 请求要求 默认值 备注
版本号 version string M-必填 填写2.0
编码方式 enCdMd string O-选填 默认取值:UTF-8
证书ID certId string M-必填
签名 signature string M-必填
签名方法 signMethod string M-必填
交易类型 txnType string M-必填
交易子类 txnSubType string M-必填 06-查询类去标记化
产品类型 bizType string M-必填
接入类型 accessType string M-必填
渠道类型 channelType string M-必填
收单机构代码 acqInsCode string C-依条件必填 接入类型取值为1时需上送
请求报文机构 fwdIns string M-必填
商户代码 merId string M-必填
交易流水号 orderId string M-必填
交易传输时间 txnTime string M-必填
原交易传输时间 origTxnTime string O-选填 YYYYMMDDhhmmss
Token token string M-必填
商户类别 merCatCode string C-依条件必填 接入类型为收单机构接入时需上送
商户名称 merName string C-依条件必填 接入类型为收单机构接入时需上送
商户简称 merAbbr string C-依条件必填 接入类型为收单机构接入时需上送
二级商户代码 subMerId string C-依条件必填 商户类型为平台类商户接入时必须上送
二级商户名称 subMerName string C-依条件必填 商户类型为平台类商户接入时必须上送
二级商户简称 subMerAbbr string C-依条件必填 商户类型为平台类商户接入时必须上送

应答参数

名称 标识 字段类型 长度 请求要求 默认值 备注
版本号 version string R-原值返回 填写2.0
编码方式 enCdMd string R-原值返回 默认取值:UTF-8
签名 signature string M-必填
签名方法 signMethod string M-必填
交易类型 txnType string R-原值返回
交易子类 txnSubType string R-原值返回 06-查询类去标记化
产品类型 bizType string R-原值返回
接入类型 accessType string R-原值返回
收单机构代码 acqInsCode string R-原值返回 接入类型取值为1时需上送
请求报文机构 fwdIns string R-原值返回
商户代码 merId string R-原值返回
交易流水号 orderId string R-原值返回
交易传输时间 txnTime string R-原值返回
原交易传输时间 origTxnTime string R-原值返回 YYYYMMDDhhmmss
主账号 accNo string C-依条件必填 Token关联卡号,应答码为00时返回
应答码 respCode string M-必填
应答信息 respMsg string M-必填
设备ID tkDeviceId string C-依条件必填 ans1~64,移动支付产品(如三星支付、苹果支付、HCE等)返回
签名公钥证书 signPubKeyCert string C-依条件必填 使用RSA算法时必须上送
商户类别 merCatCode string R-原值返回 接入类型为收单机构接入时需上送
商户名称 merName string R-原值返回 接入类型为收单机构接入时需上送
商户简称 merAbbr string R-原值返回 接入类型为收单机构接入时需上送
二级商户代码 subMerId string R-原值返回 商户类型为平台类商户接入时必须上送
二级商户名称 subMerName string R-原值返回 商户类型为平台类商户接入时必须上送
二级商户简称 subMerAbbr string R-原值返回 商户类型为平台类商户接入时必须上送
产品亮点

 图片1.png

(1)快速同步国际标准。银联直接参与支付标记化国际标准制定,能够跟进国际标准更新,快速优化服务,及时做好技术导入,为国内合作单位提供最前沿的服务。

(2)拥有丰富的应用案例。银联云闪付、在线支付产品已全面应用支付标记化技术,可为外部合作单位提供成熟的业务合作模式及支持服务流程。

(3)持续完善系统功能。3年多的系统建设和完善,银联支付标记化服务系统已具备支付标记化处理所需的4大核心业务功能,具备丰富的交易场景控制措施和手段。同时符合信息安全等级保护三级要求,具备安全、高效、持续的服务能力。

(4)集成标准化风控服务。银联支付标记化服务系统具备与银联统一风控系统的数据交互通道,可以在绑卡申请及实际支付环节借助银联风控系统功能,有效防止伪冒申请及交易欺诈的发生。

(5)帮助机构更好地满足监管要求。银联已具备对外部输出支付标记化服务能力,可帮助商业银行、支付机构满足监管机构提出的银行卡信息保护要求。


应用场景

支付标记化服务适用于移动支付、互联网支付等各类数字化支付场景。

(1)移动支付场景: 

使用Token号作为存储在手机等移动设备中的设备卡号,用户可以在线下POS、ATM等终端机具上用移动设备做非接触式近场支付,也可以在手机客户端中直接发起远程支付。

(2)互联网支付场景:

以Token号替代银行卡号留存在商户、支付机构网站上,持卡人登录商户、支付机构网站在支付环节以Token号发起支付交易的场景。


应用对象

机构

外部接入方经全渠道平台接入,接收的交易应答码定义如下表。

应答码

应答码含义

应答信息附加码(共7位)

00

交易成功


01

交易失败。详情请咨询95516

39100XY

XYTSP系统返回给全渠道平台的内部应答码,具体定义详见A.2

06

报文格式错、加密失败或调用失败

3900001  请求报文格式错误

3900002  加密敏感信息失败

3900003  TSP调用:HTTP请求或应答失败

3900004  TSP调用:HTTP应答码非200

3900005  TSP调用:应答报文格式错误

3900006  TSPSNDSVR调用:获取连接失败

3900007  TSPSNDSVR调用:rpc_call失败

3900008  TSPSNDSVR调用:应答报文格式错误

32

不支持该商户

3910005  不支持该商户

33

金额超限

3910006  单笔金额超限

3910052  日累计金额超限

80

Token已过期

3910013  Token已过期

87

次数超限

3910003  Token使用次超限

89

无此TokenTR状态无效或者Token状态无效

3910001  TR状态无效

3910002  Token状态无效

3910014  无此Token

3910018  TokenTr关联检查失败