口碑卡券核销接口

接口名称

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": "刘威测试"
    }
    

results matching ""

    No results matching ""