# 获取授权页链接

调试工具

接口应在服务器端调用,不可在前端(小程序、网页、APP等)直接调用,具体可参考接口调用指南

接口英文名:invoicebizgetauthurl

本接口供商户调用。商户通过本接口传入订单号、开票平台标识等参数,获取授权页的链接。在微信中向用户展示授权页,当用户点击了授权页上的“领取发票”/“申请开票”按钮后,即完成了订单号与该用户的授权关系绑定,后续开票平台可凭此订单号发起将发票卡券插入用户卡包的请求,微信也将据此授权关系校验是否放行插卡请求。

授权页包括三种样式,商户可以通过传入不同type的值进行调用。各样式授权页如下图所示:

不同样式授权页作用如下:

type=0(申请开票类型):用于商户已从其它渠道获得用户抬头,拉起授权页发起开票,开票成功后保存到用户卡包;

type=1(填写抬头申请开票类型):调用该类型时,页面会显示微信存储的用户常用抬头。用于商户未收集用户抬头,希望为用户减少填写步骤。需要留意的是,当使用支付后开票业务时,只能调用type=1类型。

type=2(领取发票类型):用于商户发票已开具成功,拉起授权页后让用户将发票归集保存到卡包。

# 1. 调用方式

# HTTPS 调用

POST https://api.weixin.qq.com/card/invoice/getauthurl?access_token=ACCESS_TOKEN

# 云调用

  • 本接口不支持云调用

# 第三方调用

  • 本接口支持第三方平台代商家调用。

  • 该接口所属的权限集 id 为:26

  • 服务商获得其中之一权限集授权后,可通过使用 authorizer_access_token 代商家进行调用,具体可查看 第三方调用 说明文档。

# 2. 请求参数

# 查询参数 Query String parameters

参数名类型必填示例说明
access_tokenstringACCESS_TOKEN接口调用凭证,可使用 access_tokenauthorizer_access_token

# 请求体 Request Payload

参数名类型必填示例说明
s_pappidstringwxabcd开票平台在微信的标识号,商户需要找开票平台提供
order_idstring1234订单id,在商户内单笔开票请求的唯一识别号,
moneynumber11订单金额,以分为单位
timestampnumber1474875876时间戳
sourcestringweb开票来源,app:app开票,web:微信h5开票,wxa:小程序开发票,wap:普通网页开票
redirect_urlstringhttps://mp.weixin.qq.com授权成功后跳转页面。本字段只有在source为H5的时候需要填写,引导用户在微信中进行下一步流程。app开票因为从外部app拉起微信授权页,授权完成后自动回到原来的app,故无需填写。
ticketstringtttt授权页ticket
typenumber1授权类型,0:开票授权,1:填写字段开票授权,2:领票授权

# 3. 返回参数

# 返回体 Response Payload

参数名类型说明
errcodenumber错误码
errmsgstring错误信息
auth_urlstring授权链接
appidstringsource为wxa时才有

# 4. 注意事项

授权页包含三种样式,通过type参数控制

# 5. 代码示例

请求示例

{
  "s_pappid": "wxabcd",
  "order_id": "1234",
  "money": 11,
  "timestamp": 1474875876,
  "source": "web",
  "redirect_url": "https://mp.weixin.qq.com",
  "ticket": "tttt",
  "type": 1
}

返回示例

{
  "errcode": 0,
  "errmsg": "ok",
  "auth_url": "http://auth_url"
}

# 6. 错误码

以下是本接口的错误码列表,其他错误码可参考 通用错误码

错误码错误描述解决方案
40001invalid credential  access_token isinvalid or not latestaccess_token 无效或不为最新获取的 access_token,请开发者确认access_token的有效性

# 7. 适用范围

本接口在不同账号类型下的可调用情况:
公众号服务号
  • ✔:该账号可调用此接口
  • 其他未明确声明的账号类型,如无特殊说明,均不可调用此接口;