接口描述
通过用户账户ID查询当前用户的积分余额
请求方式
POST
生产调用地址
https://openapi.unionpay.com/upapi/mkt/kol/userPoint/v1
测试调用地址
https://openapi.unionpay.com/upapi/mkt/kol/userPoint/v1
HTTP报文体参数
| 中文名称 | 英文名称 | 域类型 | 域长度 | 默认值 | 请求要求 | 备注 | |
|---|---|---|---|---|---|---|---|
| 流水号 | transSeq | string | an..64 | M-必填 | 流水号
|
||
| 渠道方代码 | chnlId | string | an4 | M-必填 | 区分业务权限，进行数据权限控制
|
||
| 账户主体类型 | acctEntityTp | string | an4 | M-必填 | 可选：用户、卡号、手机号（三选一）
UP01-手机号
UP02-卡号
UP03-云闪付注册用户ID
|
||
| 接入方ID | accessId | string | a2 | M-必填 | 积分来源：UP-银联；SC-其他
|
||
| 账户状态 | acctSt | string | a2 | M-必填 | 固定值-01
|
||
| 账户主体标识-卡号 | cardNo | string | an..128 | C-按条件必填 | 如果账户主体类型选了卡号，则此字段必填，为对应的卡号
采用对称加密
该参数已配置加密规则：SM4 查看详情 |
||
| 账户主体标识-手机号 | mobile | string | an..128 | C-按条件必填 | 如果账户主体类型选了手机号，则此字段必填，为对应的手机号
采用对称加密
该参数已配置加密规则：SM4 查看详情 |
||
| 账户主体标识-userOpenId | userOpenId | string | C-按条件必填 | 如果账户主体类型选了用户，则此字段必填，为对应的用户
该参数已配置加密规则：SM4 查看详情 |
|||
| 积分ID | pointId | string | an..64 | M-必填 | 接入方id只能查询关联的积分类别代码
|
HTTP消息头参数
| 中文名称 | 英文名称 | 域类型 | 域长度 | 默认值 | 样例值 | 请求要求 | 备注 | |
|---|---|---|---|---|---|---|---|---|
| 版本号 | version | string | 8 | 1.0.0 | 1.0.0 | M-必填 |
|
|
| 发送方索引类型 | appType | string | 2 | M-必填 | 00 银联索引 ；01 机构索引；02 商户索引
|
|||
| 发送方索引标识码 | appId | string | 32 | M-必填 | appId由开放平台网关分配，取值开放平台网关API认证账号
|
|||
| 接口类型 | bizMethod | string | 64 | mkt.kol.userPoint.v1 | mkt.kol.userPoint.v1 | M-必填 |
|
|
| 签名 | sign | string | 344 | M-必填 | 对报文摘要的签名
|
|||
| 签名方法 | signMethod | string | 20 | M-必填 | 取值：RSA2：先使用SHA-256计算摘要，再使用RSA完成签名，样例代码参考3.3。SM2：先使用SM3计算摘要，再使用SM2完成签名，样例代码参考3.4
|
|||
| 发送方流水号 | reqId | string | 64 | M-必填 | 由发送方自动生成
|
|||
| 时间戳 | reqTs | string | 32 | M-必填 | 当前时间戳
|
同步应答参数
| 中文名称 | 英文名称 | 域类型 | 域长度 | 默认值 | 请求要求 | 备注 | |
|---|---|---|---|---|---|---|---|
| 应答码 | code | string | M-必填 | 应答码，默认成功为0000000000
|
|||
| 应答文案 | msg | string | O-选填 | 应答信息
|
|||
| 应答码 | subCode | string | C-按条件必填 | 二级应答，当code非成功应答时才出现
|
|||
| 应答文案 | subMsg | string | C-按条件必填 | 二级应答文案，失败原因
|
|||
| 业务应答 | params | map | O-选填 |
|
示例代码
请求报文头参数
{
“version”:”1.0.0”,
“appType”:”01”,
“appId”:”up_5issuytt11s_adqov”,
“bizMethod”:”mkt.kol.userPoint.v1”,
“sign”:”2MsthJAk1HKoop2xjCpLhNUDMeXOAiHyful4WonY+v8yoc8oQHiS1cKnqUHdoLlIZESb3kXXFJHHtHU6mknrI+JTWsAlmkEPCsSlJ6Uw3G”,
“signMethod”:”RSA2”,
“reqId”:”hfsjau2jirnwqn128h3j1nbsa213”,
“reqTs”:”1629365633609”
}
请求报文参数
{
"chnlId":"2006",
"accessId":"UP",
"transSeq":"20210526164720695053008152703826",
"pointId":"4119121161164806",
"acctEntityTp":"UP01",
"cardNo":"",
"mobile":"13678923454",
"userOpenId":"",
"acctSt":"01"
}
中国银联版权所有© 沪ICP备07032180号-2 沪公网安备31011502002335号
