2.5 KiB
公共入参 参数名 类型 必须 详情描述 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 供应商的订单号