产生卡/券
method: allinpay.shopoint.couponService.couponSend
version: 1.0
业务请求参数
|
字段名 |
参数类型 |
必填 |
最大长度 |
说明 |
取值 |
|
shopId |
String |
否 |
|
店铺ID |
|
|
shopCode |
String |
否 |
|
店铺号 |
与shopId功能相同，shopId和shopCode同时输入则只取shopId，shopId和shopCode必输一项 |
|
operUserId |
String |
是 |
|
收银员id |
收银员登录名称 |
|
couponType |
String |
是 |
|
券类型 |
1-电子券 2-纸质券 |
|
num |
String |
是 |
|
发券数量 |
正整数 |
|
couponTemplateId |
String |
是 |
|
券模板Id |
|
|
idType |
String |
否 |
|
接受券的会员账号类型 |
1- 手机号 2- 会员卡号 3- Openid 5-外部ID |
|
memberId |
String |
否 |
|
接受券的会员账号 |
idType存在时必填 Openid不能被查询到时，将新建对应的用户 |
|
orderId |
String |
是 |
|
外部发券订单号 |
|
|
sourceType |
String |
否 |
|
来源类型 |
1- 手机号 2- Openid 3- 导购ID 4- 用户ID |
|
sourceValue |
String |
否 |
|
来源值 来源类型（sourceType）存在时必填 |
|
|
remark |
String |
否 |
|
备注信息 |
|
|
extendInfo |
JSON |
否 |
|
自定义扩展信息 |
如： extendInfo: { "buyerType": "个人", "buyerIdNo": "51*****217", "buyerContact": "189***25", } |
|
buyerMobile |
String |
否 |
|
购卡人手机号 |
多用途金额券或者实体卡为记名卡或者批次金额超过10000元时必填 需先调用会员实名接口 |
业务响应参数
|
字段名 |
参数类型 |
必填 |
最大长度 |
说明 |
取值 |
||
|
code |
Integer |
是 |
|
返回码 |
0：表示成功； 3：表示失败，具体失败原因参见msg字段； 其他：参见4.1 公共返回码 |
||
|
msg |
String |
是 |
|
错误信息 |
|
||
|
data |
tranNo |
|
String |
是 |
|
流水号 |
|
|
shopName |
|
String |
是 |
|
店铺名称 |
|
|
|
tranDateTime |
|
String |
是 |
|
交易时间 |
|
|
|
instruction |
|
String |
否 |
|
券使用须知 |
|
|
|
list |
|
|
是 |
|
交易券明细 |
|
|
|
templateId |
Integer |
是 |
|
模板ID |
|
||
|
couponName |
String |
是 |
|
券名称 |
|
||
|
couponNo |
String |
否 |
|
券号 |
发券对象，或纸质券时有效 |
||
|
qrCodeContext |
String |
否 |
|
电子券二维码 |
无发券对象，且电子券时有效 |
||
请求示例
{"shopId":"1","operUserId":"1","couponType":"1","num":"10","couponTemplateId":"307"}
响应示例
{
"code": 0,
"data": {
"tranNo": "50806050005080208145",
"shopName": null,
"tranDateTime": [
2020,
4,
10,
16,
3,
49
],
"list": [
{
"templateId": 307,
"couponName": "专门测试ZHT",
"couponNo": null,
"qrCodeContext": "https://mp.weixin.qq.com/cgi-bin/showqrcode?ticket=gQF48DwAAAAAAAAAAS5odHRwOi8vd2VpeGluLnFxLmNvbS9xLzAyNDdIQUo1VEw5X1AxeFJTZ051Y0IAAgRlKJBeAwQQDgAA"
}
]
},
"sign": "VCpfqwnJGQvV5c3esmz5OpylgfIE6gGqtl3gS/Lrjz4dFt3icgeDA4yjZ9ZO+qJbGH85djwWp6EtTPPE/LRgI2TjWgiyuyR4FdJ7lM4ze/VwcAKxxWVj0OayjXLJblHxTtUNNjfzjH0ndnldQO7gigpvOfgMoampnbOq65SC+3o="
}