接口描述
实时查询查询定义时间内的积分变动明细情况
请求方式
POST
生产调用地址
https://openapi.unionpay.com/upapi/mkt/pnt/queryPointDetail/v1
测试调用地址
https://openapi.unionpay.com/upapi/mkt/pnt/queryPointDetail/v1
HTTP报文体参数
| 中文名称 | 英文名称 | 域类型 | 域长度 | 默认值 | 请求要求 | 备注 | |
|---|---|---|---|---|---|---|---|
| 渠道ID | chnlId | string | n2..4 | M-必填 | 同系统ID-sysId
|
||
| 账户主体类型 | acctEntityTp | string | an4 | M-必填 | UP01-手机号
UP02-卡号
UP03-银联统一用户ID
|
||
| 账户主体标识 | acctEntityId | string | an..128 | M-必填 |
|
||
| 积分类型 | pointTp | string | an2..4 | M-必填 | 41-专用积分（目前支持41类型积分）
|
||
| 积分类别代码 | pointId | string | an..64 | M-必填 |
|
||
| 查询起始时间 | qryBeginTs | string | n8 | M-必填 | 格式：yyyyMMdd，起始时间为空则以第一条记录为起始
|
||
| 查询截止时间 | qryEndTs | string | n8 | M-必填 | 格式：yyyyMMdd，截止时间为空则以最后一条记录为截止
|
||
| 交易类型 | queryTp | string | n5 | M-必填 | 交易类型
01-积分赠送
02-积分赠送撤销
03-积分调账的增
04-积分调账的减
05-积分消费
06-积分消费撤销
07-积分消费退货
08-积分过期
|
||
| 页大小 | pageRecNum | string | n..12 | M-必填 | 指每页记录数量
|
||
| 当前页 | qryPageNo | string | n..12 | M-必填 | 指查询第几页
|
HTTP消息头参数
| 中文名称 | 英文名称 | 域类型 | 域长度 | 默认值 | 样例值 | 请求要求 | 备注 | |
|---|---|---|---|---|---|---|---|---|
| 版本号 | version | string | 8 | 取值:1.0.0 | M-必填 | 取值:1.0.0
|
||
| 发送方索引类型 | appType | string | 2 | M-必填 | 取值： 00：银联索引 ；01 机构索引；02 商户索引
|
|||
| 发送方索引标识码 | appId | string | 32 | M-必填 | appId由开放平台网关分配，取值开放平台网关API认证账号
|
|||
| 接口类型 | bizMethod | string | 64 | M-必填 | 取值:mkt.pnt.queryPointDetail.v1
|
|||
| 签名 | 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 | an10 | M-必填 | 成功应答码为’0000000000’
失败应答码格式：
第1-2位表示应答码生成方；
第3-10位表示错误原因；
取值详见附录1。
|
||
| 应答码描述 | msg | string | ans..128 | M-必填 | 同一个应答码可对应多个不同的描述，对处理结果进行详细提示
|
||
| 详细应答码 | subCode | string | ans..10 | C-按条件必填 | 当应答码非成功时出现，并且描述了详细的业务处理失败的原因。
当由银联系统直接产生应答码时，宜在详细应答码中体现系统简称（如前3位为SWT）。
|
||
| 详细应答码描述 | subMsg | string | ans..128 | C-按条件必填 | 同一个详细错误码可对应多个不同的描述，对处理结果进行详细提示。
包含多个错误信息，供进一步分析错误原因使用。
|
||
| 当前页 | qryPageNo | string | n..12 | M-必填 | 当前页
|
||
| 页大小 | pageRecNum | string | n..12 | M-必填 | 页大小
|
||
| 积分明细 | List |
string | an…2048 | M-必填 | 积分明细
|
示例代码
l 请求报文头参数
{
“version”:”1.0.0”,
“appType”:”01”,
“appId”:”up_5issuytt11s_adqov”,
“bizMethod”:”mkt.agg.aggQueryHotAccBal.v1”,
“sign”:”2MsthJAk1HKoop2xjCpLhNUDMeXOAiHyful4WonY+v8yoc8oQHiS1cKnqUHdoLlIZESb3kXXFJHHtHU6mknrI+JTWsAlmkEPCsSlJ6Uw3G”,
“signMethod”:”RSA2”,
“reqId”:”hfsjau2jirnwqn128h3j1nbsa213”,
“reqTs”:”1629365633609”
}
l 请求报文参数
{
"chnlId": "1234",
"acctEntityTp": "UP01",
"acctEntityId": "AA11152517640503",
"pointTp": "41",
"pointId": "411248647245",
"qryBeginTs": "20210222",
"qryEndTs": "20220222",
"queryTp": "01",
"qryPageNo": "10",
"pageRecNum": "10"
}
中国银联版权所有© 沪ICP备07032180号-2 沪公网安备31011502002335号
