服务商可以凭“凭证”查询对应的“乘客行程单”。

接口说明

支持商户：

【普通服务商】

请求方式：

【GET】/v3/taxi-invoice/user-taxi-order/find-by-token

请求域名：

【主域名】

https://api.mch.weixin.qq.com

使用该域名将访问就近的接入点

【备域名】

https://api2.mch.weixin.qq.com

使用该域名将访问异地的接入点 ，指引点击查看

请求参数

Header HTTP头参数
Authorization 必填 string
请参考 签名认证 生成认证信息
Accept 必填 string
请设置为 application/json

Query 查询参数
token 必填 string(1024)
【获取乘客行程单详情的凭证】 获取乘客行程单详情的凭证
openid 必填 string(128)
【公众号或小程序的用户的微信OpenID】 公众号或小程序的用户的微信OpenID
appid 必填 string(128)
【公众号或小程序的AppID】 公众号或小程序的AppID
region_id 选填 integer
【行政区划代码】 行政区划代码
auth_mode 必填 string
【授权模式】 授权模式
可选取值：

• ORDER_AUTH: 协议授权的基础上，还需对每笔订单进行授权
• PROTOCOL_AUTH: 用户同意协议，授权查询

请求示例

GET

应答参数

200OK
plate_number 必填 string(16)
【车牌号】 车牌号
driver_license 必填 string(128)
【营运资格证号】 出租车司机运营资格证号
up_time 必填 string
【上车时间】 关联了营运单时为实际的乘客上车时间，否则：
* source为SOURCE_PAY时，该时间为面对面付款的时间，与pay_time一致。
* source为SOURCE_DEVICE时，该时间为车载终端的起表时间。
region_id 必填 integer
【行政区划代码】 行政区划代码
source 必填 string
【乘客行程单来源】 乘客行程单来源
可选取值：

• SOURCE_PAY: 微信支付面对面付款
• SOURCE_DEVICE: 出租车车载终端
pay_time 选填 string(32)
【面对面付款时间】 使用微信支付面对面付款的时间。仅在source为SOURCE_PAY时存在。
pay_amount 选填 integer
【面对面付款金额】 使用微信支付面对面付款的金额，单位为分。仅在source为SOURCE_PAY时存在。

应答示例

200 OK

错误码

公共错误码

状态码	错误码	描述	解决方案
400	PARAM_ERROR	参数错误	请根据错误提示正确传入参数
400	INVALID_REQUEST	HTTP 请求不符合微信支付 APIv3 接口规则	请参阅 接口规则
401	SIGN_ERROR	验证不通过	请参阅 签名常见问题
500	SYSTEM_ERROR	系统异常，请稍后重试	请稍后重试

业务错误码

状态码	错误码	描述	解决方案
500	SYSTEM_ERROR	系统错误	系统异常，请使用相同参数稍后重新调用
403	NO_AUTH	商户无权限	请开通商户号权限。请联系产品或商务申请
403	NO_AUTH	用户未授权	拉起授权插件，用户勾选并同意用户授权协议
403	NO_AUTH	订单未授权	拉起授权插件，用户同意单笔订单授权
400	INVALID_REQUEST	请求参数符合参数格式，但不符合业务规则	请使用正确的参数重新调用
429	RATE_LIMITED	频率限制	请降低频率后重试