请求地址: /v2/common/sendVoucherSingle
服务协议: HTTP/POST
请求参数列表
字段名 | 含义 | 类型 | 是否必填 |
---|---|---|---|
client_id | 申请的client_id | String | Y |
timestamp | 时间戳,请求超过当前时间两分钟会返回超时 | Long | Y |
sign | 签名 | String | Y |
externalApplyId | 外部请求发券ID,同商户号下唯一 | String | Y |
externalCustomerId | 外部用户标识 | String | Y |
customerName | 客户名称 | String | N |
customerPhone | 客户手机号 | String | N |
externalRemark | 外部订单备注 | String | N |
activityId | 活动ID | Long | Y |
companyId | 公司ID | Long | Y |
copies | 发券数量,默认1,最大10张 | Integer | Y |
customerId | 用户ID | Long | N |
返回参数列表
字段名 | 含义 | 类型 | 是否必填 |
---|---|---|---|
code | 返回码,0表示成功,其他表示失败 10002 系统异常 10009 参数缺失或错误 100001发券申请ID已存在 100003 活动信息不存在 100004 活动状态非法 100002 用户创建失败 200010 商户余额不足 | Integer | Y |
message | 返回结果消息描述 | String | Y |
data | 返回的结果 | object | Y |
voucherId | 生成的券ID | Long | Y |
customerId | 返回的用户ID(caocaoID) | Long | Y |
结果示例:
{"code":0,"data":{"voucherId":11xx61,"customerId":55xx859880},"success":true,"message":"处理成功 !"}