马蜂窝开放平台

票务核销状态获取接口

此接口用于商家拉取订单SKU的凭证码信息；

调用频次

此接口调用频次上限默认为30次/分钟，如不能满足业务需要请添加马蜂窝开放平台交流群：201650204 申请调整。

请求URL

正式环境：https://openapi.mafengwo.cn/deals/rest

请求Action

action：sales.ticket.consume.get

请求参数

参数名称	参数类型	必填	示例	描述
order_id	string	是	2253329201801103938959	旅行商城业务订单号

响应参数

参数名称	参数类型	示例	描述
order_id	string	2253329201801103938959	旅行商城业务订单号
ticket_vouchers	array	[]	订单对应的票务信息
{}	object	0
└ sku_id	int	248862	马蜂窝sku_id
└ ota_sku_id	string	S121455	商家设置的SKU外部编码
└ type	int	1	1－一码一验，一个库存对应一个凭证码； 2－一码多验，多个库存对应一个凭证码；
vouchers	array	[]
{}	object	0
└ voucher	string		请商家传递真实有效的凭证码信息，此凭证码将在前台页向客人进行展示，若商家没有真实有效的凭证码，马蜂窝将根据voucher_type的取值向商家返回马蜂窝生成的凭证码，供商家核销使用；
└ voucher_pic	string		图片码凭证，传图片链接地址, 有多个时，顺序必须与vouchers的顺序一致，马蜂窝将以此顺序与voucher顺序进行一一对应；
└ status	int	1	凭证状态：1-未使用，2-已使用，3-已退款，4-已废弃（对应的门票还未消费，但是此凭证码作废了）；
quantity_status_info	object	{}	一码多验门票数量状态信息
└ not_used_quantity	int	1	未使用数量
└ used_quantity	int	1	已使用数量
└ refunded_quantity	int	1	已退款数量

响应示例

{
    "order_id":"2253329201801103938959",
    "ticket_vouchers":[
        {
            "sku_id":"248862",
            "ota_sku_id":"S121455",
            "type":"1",
            "vouchers":[
                {
                    "voucher":"",
                    "voucher_pic":"",
                    "status":"1"
                }
            ],
            "quantity_status_info":{
                "not_used_quantity":"1",
                "used_quantity":"1",
                "refunded_quantity":"1"
            }
        }
    ]
}

异常错误码

异常码	异常信息
10060019	订单账号异常
10060018	没有操作权限