2.11. 发券
接口介绍:
API endpoint:{api_domain}/api/giftcard/v1/issuer/coupon/issue
Verb: POST
Signature :需要签名,参考统一签名说明
请求参数
参数 | 必填 | 类型 | 参数名称 | 描述 |
---|---|---|---|---|
brand_code | 1 | String | 品牌编号 | 品牌编号,系统对接前由“收钱吧”提供 |
request_no | 1 | String | 请求号 | 不可重复,可用于后续查询 |
user_channel | 1 | String | 用户渠道 | 1, wechat; 2,alipay |
user_id | 1 | String | 用户 ID | 微信用户为 UnionID,支付宝为用户 ID |
client_member_id | n | String | 商户系统用户 ID | 商户系统的用户id,如 CRM 的用户ID 或者商户小程序 OpenID |
total_count | n | Int | 总数量 | 默认是 1,上限是 20 |
coupon_spec_id | 1 | String | 卡类 id | 卡规则 id,规则配置在礼品卡后台 |
coupon_surface_id | 1 | String | 卡面 id | 券面 id,卡面在礼品卡后台管理 |
coupon_sku_spec_id | n | String | skuid | 券对应商品的sku 的规则 id,对应商家端可能是一个 sku 的 id,也可能是 一组sku 的 id 的规则 id。不指定则使用 spec 配置的。 |
coupon_sku_spec_names | n | String | sku 名称列表 | 券对应商品的sku 的名称列表,以逗号分割,会显示在发卡助手核券的确认页面,供店员核对 |
denomination_price | n | Price | 面额 | 面额,单位为分 |
sale_price | n | Price | 售价 | 售价,单位为分 |
issue_store_id | n | String | 发行门店 | 发行门店 id |
issue_store_name | n | String | 发行门店名 | 发行门店名 |
extend_info | n | String | 附加信息 | - |
返回参数
参数 | 必填 | 类型 | 参数名称 | 描述 |
---|---|---|---|---|
coupons | 1 | Array | 卡列表 | 卡列表,数组 |
coupons
参数 | 必填 | 类型 | 参数名称 | 描述 |
---|---|---|---|---|
coupon_info | 1 | Object | 卡信息 | 卡信息 |
redeem_info | 1 | Object | 兑换信息 | 兑换信息 |
coupon_info:
参数 | 必填 | 类型 | 参数名称 | 描述 |
---|---|---|---|---|
coupon_sku_spec_id | n | String | skuid | 券对应商品的sku 的规则 id,对应商家端可能是一个 sku 的 id,也可能是 一组 sku 的 id 的规则 id。不指定则使用 spec 配置的。 |
coupon_spec_id | 1 | String | 卡类 id | 卡规则 id,规则配置在礼品卡后台 |
coupon_surface_id | 1 | String | 卡面 id | 卡面 id,卡面在礼品卡后台管理 |
denomination_price | 1 | Price | 面额 | 面额,单位为分 |
sale_price | 1 | Price | 售价 | 售价,单位为分 |
coupon_no | 1 | String | 券号 | 券号 |
expired_date | n | String | 失效时间 | 没有则代表永久有效 |
coupon_value | 1 | String | 券金额 | 卡余额,单位为分 |
coupon_net_value | 1 | String | 券剩余金额 | 卡净余额,单位为分 |
issue_store_id | n | String | 发行门店 | 发行门店 id |
issue_store_name | n | String | 发行门店名 | 发行门店名 |
redeem_info:
参数 | 必填 | 类型 | 参数名称 | 描述 |
---|---|---|---|---|
redeem_qrcode | 1 | String | 兑换二维码 | 兑换二维码; |
redeem_no | 1 | String | 兑换码 | 兑换码 |
redeem_password | n | String | 兑换口令 | 兑换口令 |