H5 / PC 页面嵌入
对于没有开发精力对接开票接口的团队,EasyAPI 提供现成的开票页面,通过 iframe 或链接即可集成到自有系统:
- H5 页面:面向终端用户(购买方)的移动端开票页,用户自助填写抬头、选择订单或商品申请开票,适合公众号、小程序 WebView、App 内嵌。
- PC 页面:面向企业管理后台的发票管理页,在自有 Web 管理系统左侧菜单增加「发票管理」,用 iframe 嵌入即可获得开票、查询、红冲等完整功能。
前置条件
- 在控制台创建密钥,见 鉴权方式。
- 业务系统后端调用 获取访问令牌 接口,用密钥 + 用户标识换取
accessToken,再下发给前端页面。username为客户系统中用户的唯一编号(手机号或加密字符串),EasyAPI 会按该标识区分不同用户的抬头、订单与发票。
H5 页面
https://fapiao-h5.easyapi.com/?username=用户标识&accessToken=访问令牌
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| username | string | 必填 | 用户标识 |
| accessToken | string | 必填 | 访问令牌(与 username 对应) |
<iframe
src="https://fapiao-h5.easyapi.com/?username=user001&accessToken=k3d8s9a1b2c3d4e5f6g7h8i9j0k1l2m3"
width="100%"
height="800"
frameborder="0"
></iframe>
也可以直接把该地址作为链接打开(例如公众号菜单、短信链接)。
PC 页面
https://fapiao-pc.easyapi.com/?username=用户标识&accessToken=访问令牌
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| username | string | 必填 | 用户标识,通常为企业管理后台的操作员账号 |
| accessToken | string | 必填 | 访问令牌(与 username 对应) |
<iframe
src="https://fapiao-pc.easyapi.com/?username=admin&accessToken=k3d8s9a1b2c3d4e5f6g7h8i9j0k1l2m3"
width="100%"
height="650"
frameborder="0"
></iframe>