仿原生乘车码
业务方可通过接入仿原生乘车码行业模板,在业务方小程序中快速实现公共交通的线上扫码乘车功能,以及开通线路、乘车记录、帮助中心等相关页面。仿原生乘车码行业模板包括以下接口(在调用前需先完成小程序账号注册、微信支付商户号申请流程,并向 city_api@tencent.com 发送接入仿原生乘车码行业模板能力的申请邮件):
API名称 | API描述 |
---|---|
仿原生跳转 | 根据需求不同跳转不同的微信仿原生页面实现不同的功能需求。 |
生码 | 微信后台向业务方请求二维码源数据,微信前端可以根据源数据生成乘车码。 |
支付回调 | 微信后台向业务方请求二维码源数据,微信前端可以根据源数据生成乘车码。 |
微信扣费 | 用于接收业务方依据扫码接口获取到的信息对用户进行免密扣费。 |
用户注册/签约 | 微信后台向业主方发起用户注册。 |
用户解约 | 微信后台向业主方通知用户注销/解约。 |
用户签约状态查询 | 业主方查询用户签约状态接口。 |
欠费支付 | 微信后台向业主方通知用户支付成功(支付失败时无通知)。 |
查询线路 | 查询设置的公交/地铁线路 |
设置线路 | 设置公交/地铁线路 |
查询欠费用户列表 | 微信后台会定时(每天6点开始)获取所有欠费用户列表,并提供接口查询列表接口,此后如果有用户完成欠费缴纳会在收到成功支付通知时删除记录。 |
仿原生跳转
根据需求不同跳转不同的微信仿原生页面实现不同的功能需求。
1、 请求参数
参数名称 | 类型 | 必选 | 备注 |
---|---|---|---|
path_type | int | Y | 需要跳转的页面 0 - 新用户首页/欢迎页(开通乘车码,包含“成功开通乘车码” 1 - 乘车码页 2 - 已开通路线 3 - 个人中心 4 - 我的乘车记录 5 - 帮助 6 - 欠费记录 |
注意:请求参数为json格式。
2、 返回参数
参数名称 | 类型 | 必选 | 备注 |
---|---|---|---|
errcode | int | Y | 返回码 |
errmsg | string | Y | 返回信息 |
business_type | string | Y | 业务类型 |
query_string | string | Y | 调用仿原生小程序时使用的参数 |
expire_at | int | Y | 返回query_string的到期时间(uinx时间戳) |
3、 示例代码
请求:
https://api.weixin.qq.com/intp/transportcode/getbusinessview?access\_token=ACCESSTOKEN
请求参数:
{"path_type":1}
返回:
{
"errcode":0,
"errmsg":"ok",
"business_type":"wxCity",
"query_string":"addr=pages%2Froute%2Fmain&business_view_token=a52f6d30814a8d7d5717d004a0c38894",
"expire_at":1576838728
}