口碑卡券核销接口
接口名称
openapi.koubei.ticket.use
请求方式
POST
请求头
application/json; charset=utf-8
请求业务参数
参数 | 类型 | 是否必填 | 最大长度 | 描述 |
---|---|---|---|---|
store_id | int | 是 | 10 | 付呗门店ID |
ticket_code | string | 是 | 64 | 口碑商品券码 |
- 请求示例:
{ "biz_content": "{\"store_id\":303523,\"ticket_code\":\"009417516955\"}", "method": "openapi.koubei.ticket.use", "format": "json", "sign_method": "md5", "sign": "564E50F4A229726DDBCE775C61CAD766", "app_id": "20171123014437123737", "nonce": "i59aovrqxbij", "version": "1.0" }
成功响应参数
参数 | 类型 | 是否必填 | 最大长度 | 描述 |
---|---|---|---|---|
request_id | string | 是 | 64 | 外部请求号,支持英文字母和数字,由开发者自行定义(不允许重复) |
ticket_code | string | 是 | 64 | 12位的券码,券码为纯数字 ,且唯一不重复 |
item_name | string | 是 | 500 | 用户购买时商品的名称 |
ticket_trans_id | string | 是 | 60 | 核销流水号 |
item_id | string | 是 | 64 | 口碑商品ID |
original_price | string | 是 | 20 | 用户购买时商品的原价,单位为元,精确到小数点后两位 |
current_price | string | 是 | 20 | 用户购买时商品的现价,单位为元,精确到小数点后两位 |
use_date | string | 是 | 50 | 券核销时间 |
use_shop_id | string | 是 | 64 | 券核销门店ID |
use_shop_name | string | 是 | 100 | 券核销门店名称 |
buyer_pay_amount | string | 是 | 20 | 用户购买券的时候实际支付的金额,单位为元,精确到小数点后两位 |
receipt_amount | string | 是 | 20 | 商家实收金额,单位为元,精确到小数点后两位 |
discount_amount | string | 是 | 20 | 优惠金额,含商家补贴金额和口碑补贴金额,单位为元,精确到小数点后两位 |
koubei_subsidy_amount | string | 是 | 20 | 口碑补贴金额,单位为元,精确到小数点后两位 |
invoice_amount | string | 是 | 20 | 交易中可给用户开具发票的金额,单位为元,精确到小数点后两位 |
order_no | string | 是 | 64 | 券码所属的订单id |
voucher_id | string | 是 | 64 | 券码对应的凭证资产id |
- 响应示例:
{ "order_no": "20180404111040030100550100545619", "original_price": "1.00", "use_shop_id": "2016083000077000000018269663", "item_id": "2018033120076004000023809605", "discount_amount": "0.00", "ticket_code": "009417516955", "item_name": "测试专用sz", "ticket_trans_id": "20180404001640050200550003068690", "invoice_amount": "0.01", "voucher_id": "20180404001640050100550002314858", "receipt_amount": "0.01", "current_price": "0.01", "buyer_pay_amount": "0.01", "koubei_subsidy_amount": "0.00", "request_id": "201804040146141522777574", "use_date": "2018-04-04 01:46:15", "use_shop_name": "刘威测试" }