获取用户填写的抬头

更新时间：2024.11.28

商户调用本接口，检查用户是否已完成抬头填写，并获取用户填写的抬头信息。在微信支付场景下，若该笔订单在下单时指定在支付凭证上展示开票入口，则也可以调用本接口查询用户填写的抬头。

接口说明

支持商户：【普通服务商】

请求方式：【GET】/v3/new-tax-control-fapiao/user-title

请求域名：【主域名】https://api.mch.weixin.qq.com 使用该域名将访问就近的接入点

　　　　　【备域名】https://api2.mch.weixin.qq.com 使用该域名将访问异地的接入点，指引点击查看

请求参数

Header HTTP头参数

Authorization 　必填　string

请参考签名认证生成认证信息

Accept 　必填　string

请设置为application/json

query 查询参数

sub_mchid 　选填 string(32)

【子商户号】微信支付分配的子商户号，服务商模式下必传

fapiao_apply_id 　必填 string(32)

【发票申请单号】发票申请单号，唯一标识一次开票行为。当开票场景为WITHOUT_WECHATPAY时，为调用【获取抬头填写链接】接口时指定的发票申请单号；当开票场景为WITH_WECHATPAY时，为与本次开票关联的微信支付订单号，且必须是属于相应商户的订单

scene 　必填 string

【开票场景】开票场景

可选取值：

WITH_WECHATPAY: 微信支付场景

WITHOUT_WECHATPAY: 非微信支付场景

请求示例

GET

1curl -X GET \
2  https://api.mch.weixin.qq.com/v3/new-tax-control-fapiao/user-title?sub_mchid=1900000109&fapiao_apply_id=4200000444201910177461284488&scene=WITH_WECHATPAY \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" 
5

应答参数

200 OK

type 　必填 string

【购买方类型】购买方类型

可选取值：

INDIVIDUAL: 个人

ORGANIZATION: 单位

name 　必填 string(256)

【名称】购买方名称

taxpayer_id 　选填 string(32)

【纳税人识别号】购买方纳税人识别号，购买方类型为ORGANIZATION时必须存在

address 　选填 string(128)

【地址】购买方地址

telephone 　选填 string(32)

【电话】购买方电话

bank_name 　选填 string(128)

【开户银行】购买方开户银行

bank_account 　选填 string(32)

【银行账号】购买方银行账号

phone 　选填 string

【手机号】用户手机号。注意：该字段为密文字段，解密算法请参见《如何使用API证书解密敏感字段》

email 　选填 string

【邮箱地址】用户邮箱地址。注意：该字段为密文字段，解密算法请参见《如何使用API证书解密敏感字段》

应答示例

200 OK

1{
2  "type" : "INDIVIDUAL",
3  "name" : "深圳市南山区测试企业",
4  "taxpayer_id" : "202003261233701778",
5  "address" : "深圳市南山区深南大道10000号",
6  "telephone" : "075512345678",
7  "bank_name" : "测试银行",
8  "bank_account" : "62001234567890",
9  "phone" : "18507550000",
10  "email" : "123110@qq.com",
11  "amount" : 1,
12  "out_trade_no" : "example_out_trade_no"
13}
14

错误码

公共错误码

状态码	错误码	描述	解决方案
400	PARAM_ERROR	参数错误	请根据错误提示正确传入参数
400	INVALID_REQUEST	HTTP 请求不符合微信支付 APIv3 接口规则	请参阅接口规则
401	SIGN_ERROR	验证不通过	请参阅签名常见问题
500	SYSTEM_ERROR	系统异常，请稍后重试	请稍后重试

业务错误码

状态码	错误码	描述	解决方案
400	INVALID_REQUEST	请求参数符合参数格式，但不符合业务规则	请使用正确的参数重新调用
401	SIGN_ERROR	签名错误或签名信息不完整	请检查签名参数和方法是否都符合签名算法要求
403	NO_AUTH	商户无权限	请检查是否已经开通电子发票产品相关功能权限，若是服务商模式，还需确认子商户是否接受了服务商的邀请
404	RESOURCE_NOT_EXISTS	用户尚未完成发票抬头的填写	请在接收到微信支付侧的【用户已申请开票】通知后重新调用，或者等待一段时间后重新调用
429	FREQUENCY_LIMITED	频率超限	请降低请求接口频率

文档是否有帮助

更多支持

开发文档(商户)开发文档(V2版)开发者社区微信开放平台微信公众平台腾讯客服