2.10. 发卡
接口介绍:
API endpoint:{api_domain}/api/giftcard/v1/issuer/card/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 | 0-1 | String | 商户系统用户 ID | 商户系统的用户id,如CRM 的用户ID 或者商户小程序OpenID |
total_count | 0-1 | Int | 总数量 | 默认是 1,上限是 20 |
card_spec_id | 1 | String | 卡类 id | 卡规则 id,规则配置在礼品卡后台 |
card_surface_id | 1 | String | 卡面 id | 卡面 id,卡面在礼品卡后台管理 |
denomination_price | 0-1 | Price | 面额 | 面额,单位为分 |
sale_price | 0-1 | Price | 售价 | 售价,单位为分 |
issue_store_id | 0-1 | String | 发行门店 | 发行门店 id |
issue_store_name | 0-1 | String | 发行门店名 | 发行门店名 |
extend_info | 0-1 | String | 附加信息 | - |
返回参数
参数 | 必填 | 类型 | 参数名称 | 描述 |
---|---|---|---|---|
cards | 1 | Array | 卡列表 | 卡列表,数组 |
cards
参数 | 必填 | 类型 | 参数名称 | 描述 |
---|---|---|---|---|
card_info | 1 | Object | 卡信息 | 卡信息 |
redeem_info | 1 | Object | 兑换信息 | 兑换信息 |
card_info:
参数 | 必填 | 类型 | 参数名称 | 描述 |
---|---|---|---|---|
card_spec_id | 1 | String | 卡类 id | 卡规则 id,规则配置在礼品卡后台 |
card_surface_id | 1 | String | 卡面 id | 卡面 id,卡面在礼品卡后台管理 |
denomination_price | 1 | Price | 面额 | 面额,单位为分 |
sale_price | 1 | Price | 售价 | 售价,单位为分 |
card_number | 1 | String | 卡号 | 卡号 |
disabled_date | 0-1 | String | 失效时间 | 没有则代表永久有效 |
card_balance | 1 | String | 卡余额 | 卡余额,单位为分 |
card_net_balance | 1 | String | 卡净余额 | 卡净余额,单位为分 |
issue_store_id | 0-1 | String | 发行门店 | 发行门店 id |
issue_store_name | 0-1 | String | 发行门店名 | 发行门店名 |
redeem:
参数 | 必填 | 类型 | 参数名称 | 描述 |
---|---|---|---|---|
redeem_qrcode | 1 | String | 兑换二维码 | 兑换二维码; |
redeem_no | 1 | String | 兑换码 | 兑换码 |
redeem_password | 0-1 | String | 兑换口令 | 兑换口令 |