接口描述
接收接入方上送的用户报名信息，用于对参与任务式营销的用户进行限制。
请求方式
POST
生产调用地址
https://openapi.unionpay.com/upapi/mkt/tes/userSignUp/v1
测试调用地址
暂无
HTTP报文体参数
| 中文名称 | 英文名称 | 域类型 | 域长度 | 默认值 | 请求要求 | 备注 | |
|---|---|---|---|---|---|---|---|
| CMD | cmd | string | M-必填 | user_sign_up_nolevel
|
|||
| 用户维度值 | userId | string | M-必填 | 填写需报名的ID值根据活动的用户类型选择填写云闪付用户ID、云网用户ID或卡号token等
|
|||
| 活动id | activityId | string | M-必填 |
|
|||
| 活动渠道 | activityChannel | string | M-必填 | 00：云闪付APP01：手机闪付02：银行APP（云网）03：银行APP（非云网）
|
|||
| 用户归属地 | userLocation | string | O-选填 |
|
|||
| 报名状态 | signUpStatus | string | O-选填 | 0-用户报名1-取消报名默认取值为0-报名
|
|||
| 首次报名标记 | isFirstRegister | string | O-选填 | 0-非首次报名1-首次报名默认取值为0-非首次
|
|||
| 日志追踪id | logId | string | O-选填 | 调用方流水号，全局唯一
|
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.tes.userSignUp.v1
|
|||
| 签名 | sign | string | 344 | M-必填 | 对报文摘要的签名
|
|||
| 签名类型 | signMethod | string | 20 | M-必填 | 取值：RSA2，SM2
|
|||
| 发送方流水号 | reqId | string | 64 | M-必填 | 由发送方自动生成
|
|||
| 时间戳 | reqTs | string | 32 | M-必填 | 当前时间戳
|
同步应答参数
| 中文名称 | 英文名称 | 域类型 | 域长度 | 默认值 | 请求要求 | 备注 | |
|---|---|---|---|---|---|---|---|
| 应答码 | code | string | M-必填 | 0000000000-成功
|
|||
| 应答文案 | msg | string | M-必填 |
|
|||
| 二级应答码 | subCode | string | O-选填 |
|
|||
| 二级应答文案 | subMsg | string | O-选填 |
|
|||
| 业务应答 | params | list | C-按条件必填 | 应答码为0000000000时有值
|
示例代码
请求报文头参数
{
“version”:”1.0.0”,
“appType”:”01”,
“appId”:”up_5issuytt11s_adqov”,
“bizMethod”:”mkt.tes.userSignUp.v1”,
“sign”:”2MsthJAk1HKoop2xjCpLhNUDMeXOAiHyful4WonY+v8yoc8oQHiS1cKnqUHdoLlIZESb3kXXFJHHtHU6mknrI+JTWsAlmkEPCsSlJ6Uw3G”,
“signMethod”:”RSA2”,
“reqId”:”hfsjau2jirnwqn128h3j1nbsa213”,
“reqTs”:”1629365633609”
}
请求报文体参数
{
"cmd": "user_sign_up_nolevel",
"userId":"c00100100010",
"activityId":"HD2024051302674",
"activityChannel":"00",
"logId":"******"
}
成功应答报文结果
{
"code":"0000000000",
"msg":"成功",
"params":{
"userSignUp":"00",
"userSignUpDesc":"报名成功"
}
}
异常应答报文结果
{
"code":"UP40000000",
"msg":"参数不合法",
"subCode":"TES0000096",
"subMsg":"请求参数不合法"
}
中国银联版权所有© 沪ICP备07032180号-2 沪公网安备31011502002335号
