接口描述
外部机构向指定用户赠送积分，需指定积分入账的用户维度与入账参数。
请求方式
POST
生产调用地址
https://openapi.unionpay.com/upapi/mkt/pnt/pntAcquire/v1
测试调用地址
https://openapi.unionpay.com/upapi/mkt/pnt/pntAcquire/v1
HTTP报文体参数
| 中文名称 | 英文名称 | 域类型 | 域长度 | 默认值 | 请求要求 | 备注 | |
|---|---|---|---|---|---|---|---|
| 渠道方代码 | chnlId | string | n2..4 | M-必填 |
|
||
| 接入方ID | accessId | string | a2 | M-必填 | 固定填写“UP”
|
||
| 流水号 | transSeq | string | an..64 | M-必填 | 调用方流水号，全局唯一，用于幂等校验
|
||
| 交易日期时间 | transDtTm | string | n14 | M-必填 | YYYYMMddHHmmss
|
||
| 机构账户类型 | insAcctTp | string | an4 | M-必填 | 固定填写“UP23”
|
||
| 机构账户代码 | insAcctId | string | an..32 | M-必填 | P打头的接入方账户代码
|
||
| 账户主体类型 | acctEntityTp | string | an4 | M-必填 | UP01-手机号 UP02-卡号 UP03-云闪付注册用户ID
|
||
| 账户主体标识_卡号 | cardNo | string | C-按条件必填 | 如果账户主体类型取值：UP02-卡号，则此字段必填，为对应的卡号
该参数已配置加密规则：SM4 查看详情 |
|||
| 账户主体标识_手机号 | mobile | string | C-按条件必填 | 如果账户主体类型取值：UP01-手机号，则此字段必填，为对应的手机号
该参数已配置加密规则：SM4 查看详情 |
|||
| 账户主体标识_统一用户ID | userId | string | an12..256 | C-按条件必填 | 如果账户主体类型取值：UP03-云闪付注册用户ID云闪付注册用户ID，则此字段必填，为对应的云闪付用户为c开头的用户ID
|
||
| 积分类型 | pointTp | string | an2..4 | M-必填 | 默认41-专享红包
|
||
| 积分ID | pointId | string | an..64 | M-必填 | 积分类别代码，41开头的16位数字
|
||
| 积分额 | pointAt | string | n..12 | M-必填 | 单位为分
|
||
| 有效起始时间 | validBeginDtTm | string | n14 | C-按条件必填 | 格式:yyyymmddhhmmss，当是否延迟生效为"0-非延迟生效"时，时间必须早于等于当前请求时间
|
||
| 有效截止时间 | validEndDtTm | string | n14 | C-按条件必填 | 格式:yyyymmddhhmmss
|
||
| 是否延迟生效 | delayIn | string | n1 | C-按条件必填 | 不填则默认0-非延迟生效。0-非延迟生效，1-延迟生效
|
||
| 暂存标志 | tempIn | string | n1 | M-必填 | 一般默认填写0-非暂存。非暂存代表发给用户后，立即可以使用。0-非暂存 ；1-暂存
|
||
| 境内外交易标识 | inOutTransFlag | string | n1 | M-必填 | 0-境内交易；1-境外交易
|
||
| 业务信息 | busiInfo | string | ans..1024 | C-按条件必填 | 业务信息，最大1024 位，包含自定义活动 ID,活动名称两个小字段，格式为 {" campaignId ":"活动 ID "," campaignName ":"活动名称"}，自定义活动 ID由调用方生成，不能填写流水号
|
||
| 交易摘要 | transDigest | string | ans..200 | M-必填 | 交易摘要，最大200位,赠送积分说明，用于在云闪付APP内向用户展示获取说明
|
HTTP消息头参数
| 中文名称 | 英文名称 | 域类型 | 域长度 | 默认值 | 样例值 | 请求要求 | 备注 | |
|---|---|---|---|---|---|---|---|---|
| 版本号 | version | string | 8 | M-必填 | 取值：1.0.0
|
|||
| 发送方索引类型 | appType | string | 2 | M-必填 | 取值： 00：银联索引 01 机构索引 02 商户索引
|
|||
| 发送方索引标识码 | appId | string | 32 | M-必填 | appId由开放平台网关分配，取值开放平台网关API认证账号
|
|||
| 接口类型 | bizMethod | string | 64 | M-必填 | 取值：mkt.pnt.pntAcquire.v1
|
|||
| 签名 | sign | string | 344 | M-必填 | 对报文摘要的签名
|
|||
| 签名方式 | signMethod | string | 20 | M-必填 | 取值：RSA2、SM2，根据实际签名算法填写
|
|||
| 发送方流水号 | reqId | string | 64 | M-必填 | 由发送方自动生成
|
|||
| 时间戳 | reqTs | string | 32 | M-必填 | 当前时间戳
|
同步应答参数
| 中文名称 | 英文名称 | 域类型 | 域长度 | 默认值 | 请求要求 | 备注 | |
|---|---|---|---|---|---|---|---|
| 应答码 | code | string | an10 | M-必填 | 成功应答码为’0000000000’失败应答码格式：第1-2位表示应答码生成方；第3-10位表示错误原因；
|
||
| 应答码描述 | msg | string | ans..128 | M-必填 | 同一个应答码可对应多个不同的描述，对处理结果进行详细提示
|
||
| 详细应答码 | subCode | string | ans..10 | C-按条件必填 | 当应答码非成功时出现，并且描述了详细的业务处理失败的原因。
|
||
| 详细应答码描述 | subMsg | string | ans..128 | C-按条件必填 | 同一个详细错误码可对应多个不同的描述，对处理结果进行详细提示。包含多个错误信息，供进一步分析错误原因使用。
|
||
| 流水号 | transSeq | string | an..64 | M-必填 |
|
示例代码
//请求报文头参数
{
“version”:”1.0.0”,
“appType”:”01”,
“appId”:”up_5issuytt11s_adqov”,
“bizMethod”:“mkt.pnt.pntAcquire.v1 ”,
“sign”:“2MsthJAk1HKoop2xjCpLhNUDMeXOAiHyful4WonY+v8yoc8oQHiS1cKnqUHdoLlIZESb3kXXFJHHtHU6mknrI+JTWsAlmkEPCsSlJ6Uw3G”,
“signMethod”:”RSA2”,
“reqId”:‘hfsjau2jirnwqn128h3j1nbsa213”,
“reqTs”:“1629365633609”
}
//请求报文参数
{
"chnlId”: "ABC1234”,
"accessId”: "UP”,
"transSeq":"7002f6fb-f69d-4982-8799-4be496de478a",
"transDtTm":"20191224090000”,
"insAcctTp":"UP23",
"insAcctId ":"P1245762414",
"acctEntityTp":"UP03",
"cardNo": "",
"mobile": "",
"userId": "c0000000001",
"pointTp":"41",
"pointId": "4119121233689813",
"pointAt": "100L”,
"validBeginDtTm”: "20191008000000”,
"validEndDtTm”: "20201008000000”,
"delayIn”: "0”,
"tempIn”: "0”,
"inOutTransFlag”:"0”,
"busiInfo”: "123”,
"transDigest”:"123”
}
中国银联版权所有© 沪ICP备07032180号-2 沪公网安备31011502002335号
