接入文档
接入文档 /嵌入式集成/H5 / PC 页面嵌入

H5 / PC 页面嵌入

对于没有开发精力对接开票接口的团队,EasyAPI 提供现成的开票页面,通过 iframe 或链接即可集成到自有系统:

  • H5 页面:面向终端用户(购买方)的移动端开票页,用户自助填写抬头、选择订单或商品申请开票,适合公众号、小程序 WebView、App 内嵌。
  • PC 页面:面向企业管理后台的发票管理页,在自有 Web 管理系统左侧菜单增加「发票管理」,用 iframe 嵌入即可获得开票、查询、红冲等完整功能。

在线演示:H5 嵌入、PC 嵌入。

前置条件

  1. 在控制台创建密钥,见 鉴权方式。
  2. 业务系统后端调用 获取访问令牌 接口,用密钥 + 用户标识换取 accessToken,再下发给前端页面。username 为客户系统中用户的唯一编号(手机号或加密字符串),EasyAPI 会按该标识区分不同用户的抬头、订单与发票。

H5 页面

text
https://fapiao-h5.easyapi.com/?username=用户标识&accessToken=访问令牌
参数 类型 必填 说明
username string 必填 用户标识
accessToken string 必填 访问令牌(与 username 对应)
html
<iframe
  src="https://fapiao-h5.easyapi.com/?username=user001&accessToken=k3d8s9a1b2c3d4e5f6g7h8i9j0k1l2m3"
  width="100%"
  height="800"
  frameborder="0"
></iframe>

也可以直接把该地址作为链接打开(例如公众号菜单、短信链接)。

PC 页面

text
https://fapiao-pc.easyapi.com/?username=用户标识&accessToken=访问令牌
参数 类型 必填 说明
username string 必填 用户标识,通常为企业管理后台的操作员账号
accessToken string 必填 访问令牌(与 username 对应)
html
<iframe
  src="https://fapiao-pc.easyapi.com/?username=admin&accessToken=k3d8s9a1b2c3d4e5f6g7h8i9j0k1l2m3"
  width="100%"
  height="650"
  frameborder="0"
></iframe>

说明

  • accessToken 有效期 2 小时,页面加载前由后端重新获取即可,无需用户感知。
  • 嵌入页面内的开票同样会产生 回调通知(需在控制台配置默认回调地址)并可通过 查询发票 接口获取结果。
  • 如需定制页面展示的订单、商品或抬头来源(订单推送、可开票金额查询等),请联系技术支持。