淘宝开放平台

登录
文档中心 > API类目 > 本地生活商户基础API

本地生活商户基础API

qimen.alibaba.alsc.merchant.spi.ext.ticket.expire (凭证作废)

外部券咨询作废，作废成功会退款给用户，失败则会挂起

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
ticket_request_id String 必须 20190729111040030200660600011777
  • 最大长度：64
    		•  业务请求id
    order_no String 必须 20190917001640000300330080685221
  • 最大长度：64
    		•  口碑子订单号, 即alsc_sub_order_no
    alipay_partner_id String 必须 2088001969797048
  • 最大长度：32
    		•  口碑商户id
    merchant_id String 可选 625644896785646464
  • 最大长度：64
    		•  码商合作商户Id
    ticket_code String 可选 2012313131123
  • 最大长度：32
    		•  外部券码值，建议使用ticket_codes。ticket_code仅在单个券作废时有值，批量券作废时此属性为空
    frequency String 可选 2
  • 最大长度：10
    		•  次卡份数，默认为1
    ticket_ids String [] 可选
  • 最大列表长度：999
    		•  本地凭证id列表，在凭证作废的场景，本地生活会调用三方，传ticket_ids列表给三方
    ticket_codes String [] 可选
  • 最大列表长度：999
    		•  外部券码值列表,在凭证作废的场景，本地生活会调用三方，把三方的code值列表返回给三方

    响应参数

    名称 类型 示例值 描述
    biz_success String success 接口调用成功，传固定值"success"
    biz_code String TICKET_ALREADY_USE 错误码,"success"为成功，其他为失败
    biz_msg String 券已使用 错误信息

    请求示例

    {"order_no":"20190917001640000300330080685221","ticket_request_id":"20190729111040030200660600011777","ticket_ids":[""],"ticket_code":"2012313131123","ticket_codes":[""],"merchant_id":"625644896785646464","alipay_partner_id":"2088001969797048","frequency":"2"}

    响应示例

    {
    "biz_success":"success",
    "biz_code":"TICKET_ALREADY_USE",
    "biz_msg":"券已使用"
}

    验签示例

    {"biz_code":"sign-check-failure","biz_msg":"Illegal request","biz_success":"INVOKE_FAIL"}

    错误码解释

    错误码 错误描述 解决方案
    response-body-parse-error
    isp.http-read-timeout

    API工具

    错误码查询工具 SDK下载

    FAQ

    有用( 0 ) 我要提问
    返回
    顶部