# 将电子发票卡券插入用户卡包

调试工具

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

接口英文名：insertinvoice

本接口由开票平台或自建平台商户调用。对用户已经授权过的开票请求，开票平台可以使用本接口将发票制成发票卡券放入用户的微信卡包中。

值得关注的是，如果授权页由商户拉起，而插卡递送发票的动作由开票平台来完成的话，商户需要将需要存入微信卡包的标识和order_id在开票请求中发送给开票平台。

注意：需要使用之前调用获取s_pappid接口时的开票平台公众号appid调用本接口，否则会造成报错，插卡失败。

# 1. 调用方式

# HTTPS 调用

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

# 云调用

• 本接口不支持云调用

# 第三方调用

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

• 该接口所属的权限集 id 为：8、26

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

# 2. 请求参数

# 查询参数 Query String parameters

# 请求体 Request Payload

# Body.card_ext Object Payload

发票具体内容

# Body.card_ext.user_card Object Payload

用户信息结构体

# Body.card_ext.user_card.invoice_user_data Object Payload

用户信息

# Body.card_ext.user_card.invoice_user_data.info(Array) Object Payload

商品详情结构

# 3. 返回参数

# 返回体 Response Payload

# 4. 注意事项

本接口无特殊注意事项

# 5. 代码示例

请求示例

{
	"order_id": "111163",
	"card_ext": {
		"nonce_str": "j!Re1WxaHv",
		"user_card": {
			"invoice_user_data": {
				"info": [
					{
						"price": 10000,
						"num": 3,
						"name": "牙膏",
						"unit": "个"
					}
				],
				"billing_no": "4545145712",
				"billing_code": "4541212454512",
				"billing_time": "1468306058",
				"tax": 123,
				"s_pdf_media_id": "s_pdf_media_id_abc123",
				"fee": 123,
				"title": "灌哥发票",
				"fee_without_tax": 2345
				"buyer_number":"123456789012345678"
			}
		}
	},
	"card_id": "pjZ8Yt9WoOePThU0NfUKz5-tBEWU",
	"appid": "wxc0b84a53ed8e8d29"
}

返回示例

{
	"errcode": 0,
	"errmsg": "ok",
	"code": "682xxxx661927",
	"openid": "ojZ8Ytz4lESxxxx_R1TvB2Kds"
}

# 6. 错误码

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

# 7. 适用范围