40 lines
2.5 KiB
Markdown
40 lines
2.5 KiB
Markdown
公共入参
|
|
参数名 类型 必须 详情描述
|
|
appkey String 是 平台分配的appId
|
|
version String 是 请求的API版本号，目前版本为1
|
|
timestamp Long 是 发起请求的Unix时间戳，单位为毫秒
|
|
|
|
|
|
服务入参
|
|
参数名 类型 必须 详情描述
|
|
oid String 是 快手订单号，示例：2319200000001216
|
|
sellerId String 是 卖家的用户id，示例：2174425348
|
|
num Integer 是 发码数量，对应订单的下单数量，示例：1。必须等于商家发码回调的卡券数量
|
|
itemId String 是 快手体系内的商品id，示例：20842040339391
|
|
skuId String 否 快手体系商品SKU ID，示例：87457167264391
|
|
itemTitle String 否 快手体系内的商品标题
|
|
sendType String 是 券码类型：虚拟卡-VIRTUAL，实体卡-DELIVERY。默认传VIRTUAL
|
|
eticketType String 否 电子凭证类型，跟商家想要入驻的类目相关联，示例：
|
|
DINING_OPEN_TICKET
|
|
token String 是 订单维度授权token，发码回调时需要带回来。示例：454e02cb-5ccf-4554-9217-e6b997477fd8
|
|
certExpireType Integer 是 商家发品时配置的时间类型，快照，商家用来计算卡券有效期的起止时间。示例：
|
|
FIXED_START_END("固定起止时间", 1),
|
|
FIXED_END("购买成功后固定结束时间", 2),
|
|
FIXED_PERIOD_DAY("购买成功后固定有效天数", 3);
|
|
certStartTime Long 否 商家发品时配置的有效期：起始时间，单位毫秒时间戳。示例：1689060872478
|
|
certEndTime Long 否 商家发品时配置的有效期：结束时间，单位毫秒时间戳。示例：1689031322739
|
|
certExpDays Integer 否 商家发品时配置的超时天数，单位天（不支持周、月等其他单位）。当certExpireType=3生效，示例：30（天）
|
|
certActualStartTime Long 是 快手依据商品配置计算好的实际有效期开始时间，可用于商家校验
|
|
certActualEndTime Long 是 快手依据商品配置计算好的实际有效期结束时间，可用于商家校验
|
|
expressCode String 否 仅实体卡场景有效，实体卡物流公司
|
|
expressNo String 否 仅实体卡场景有效，实体卡快递单号
|
|
ext String 否 扩展信息
|
|
|
|
|
|
服务出参
|
|
参数名 类型 详情描述
|
|
result Integer 返回码，必传，1-成功、4010003-系统异常，必须按照错误码规范返回。「错误码规范」请参考对接文档
|
|
error_msg String 错误信息，非必传，当result != 1时必须返回明确且清晰的错误信息。禁止返回「null」、「无法排查的信息」、「error」等
|
|
data Data 业务结果，非必传，当result=1时必须返回data
|
|
orderNo String 供应商的订单号
|