integration.callback.virtual.eticket.consume
需用户授权
POST
电子凭证核销回调接口
更新时间: 2022-05-11 16:24:16
电子凭证核销回调接口
系统环境
环境	域名
线上环境（推荐）	https://openapi.kwaixiaodian.com
线上环境（备用）	https://open.kwaixiaodian.com
系统参数
参数名	类型	必须	详情描述
appkey	String	是	平台分配的appId
timestamp	Number	是	发起请求的Unix时间戳，单位为毫秒
access_token	String	是	访问token，所有需用户授权API使用code模式获取，不需要用户授权API使用client_credentials获取，详情参考《授权说明》文档
version	Number	是	请求的API版本号，目前版本为1
param	JSON	是	业务参数，详见下方的请求入参
method	String	是	请求的API英文名，详见各API定义
sign	String	是	API入参的签名结果参数
signMethod	String	是	签名算法，支持HMAC_SHA256和MD5，推荐使用HMAC_SHA256
请求参数
参数名	类型	必须	示例值	详情描述
oid	String	是	231412412	快手订单号
etickets	List<ETicket>	是	[{}]	电子凭证
id	String	是	12313	电子凭证ID
code	String	否	2131412	电子凭证Code（实体卡的Code）
num	Integer	是	1	核销数量(订单数量)
goodsValue	Long	否	10	销毁的总货值
status	String	否	"SUCCESS","FAILED"	"SUCCESS","FAILED"
销毁成功/失败
consumeTime	Long	否	1543843735000	核销时间(消费者核销的时间)
status	String	是	核销状态: 核销成功-CONSUMED 预约成功-APPOINTED	核销状态:
核销成功-CONSUMED
预约成功-APPOINTED
consumeType	String	是	门店消费-consume， 门店自提-pickup， 物流发货-delivery， 预约发货-appointment_delivery	核销方式：
默认请使用
consume，其他场景请与产研沟通
storeName	String	否	XXX线下店	核销门店名称(门店消费、门店自提时必传)
storeAddress	String	否	XXX路CCC号	核销门店地址(门店消费、门店自提时必传)
expressNo	String	否	EMS	仅在consumeType为预约发货场景下生效。
物流方式：圆通/韵达/顺丰/EMS(物流发货、预约发货方式必传)
expressCode	String	否	12412412	仅在consumeType为预约发货场景下生效。
快递单号(预发发货方式必传)物流发货、预约发货方式必传)
appointmentTime	String	否	123124124234523	仅在consumeType为门店自提场景下生效。
预约时间(预约发货方式必传)
eticketType	String	否	DINING_OPEN_TICKET/DEFAULT_MEDICAL_TICKET	电子凭证类型，跟商家想要入驻的类目相关联，非必传，默认
DINING_OPEN_TICKET
ext	String	否	{"key":"value"}	扩展信息(JSON格式)
token	String	是	sdjafljasdlflnlxjlfjasldjfljkaw	鉴权Token，订单操作维度，在发码通知接口中下发
seriallNum	String	否	D4F2D111FGG2341GH	核销序列号，对应某一次核销行为，必填！冲正时必须带上该值！
consumePoiId	Long	否	657765522	消费门店的poi信息，必须是快手的POI，如果是百度、腾讯等图商的POI，请先用POI转换接口，将图商POI转换成快手POI
返回参数
参数名	类型	示例值	详情描述
code	String	1	主返回码
msg	String	success	主返回信息
sub_code	String	1	子返回码
sub_msg	String	success	子返回信息
result	Integer	1	1-成功；其他-失败
error_msg	String	success	错误信息