Files
order_site/docs/行业电子凭证/2.快手通知商家关单或者销毁卡券接口.md
2026-06-30 15:57:58 +08:00

1.2 KiB

公共入参 参数名 类型 必须 详情描述 appkey String 是 平台分配的appId version String 是 请求的API版本号,目前版本为1 timestamp Long 是 发起请求的Unix时间戳,单位为毫秒

服务入参 参数名 类型 必须 详情描述 oid String 是 快手订单号,示例:2319100000001246 reason String 是 销毁原因,示例: ETICKET_EXPIRED("凭证已过期"), USER_APPLY_REFUND("用户申请退款"), SUPPLY_DESTROY("供应商作废"), SYS_ADMIN_DESTROY("admin后台作废") etickets List 否 需要销毁的电子凭证列表,非必填。当没有电子凭证时,表示关闭订单 id String 是 卡号 code String 否 实体卡号,大闸蟹业务专用 num Integer 是 销毁次数,默认1 goodsValue Long 是 销毁总货值

服务出参 参数名 类型 详情描述 result Integer 返回码,必传,1-销毁成功。如果订单不存在或卡券不存在,请返回销毁成功。其他错误,请参考「错误码规范」。 error_msg String 错误信息,非必传,当result != 1时必须返回明确且清晰的错误信息。禁止返回「null」、「无法排查的信息」、「error」等