获取用户填写抬头信息

更新时间:2025.09.05

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

接口说明

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

请求方式:【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)

【子商户号】 微信支付分配的子商户号,具体请参考服务商模式开发必要参数说明


 scene  必填   string

【开票场景】 开票场景

可选取值

  • WITH_WECHATPAY:  微信支付场景

  • WITHOUT_WECHATPAY:  非微信支付场景


 fapiao_apply_id  必填   string(32)

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

请求示例

curl
Java
Go

GET

1curl -X GET \
2  https://api.mch.weixin.qq.com/v3/new-tax-control-fapiao/user-title?sub_mchid=1900000109&scene=WITH_WECHATPAY&fapiao_apply_id=4200000444201910177461284488 \
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

【手机号】 用户手机号。注意:该字段为密文字段,作为请求字段需加密,使用微信支付公钥加密(推荐),参考获取微信支付公钥ID说明以及微信支付公钥加密敏感信息指引;也可以使用微信支付平台证书公钥加密,参考获取平台证书序列号平台证书加密敏感信息指引;作为响应字段需解密,参考如何使用API证书解密敏感字段


 email  选填   string

【邮箱地址】 用户邮箱地址。注意:该字段为密文字段,作为请求字段需加密,使用微信支付公钥加密(推荐),参考获取微信支付公钥ID说明以及微信支付公钥加密敏感信息指引;也可以使用微信支付平台证书公钥加密,参考获取平台证书序列号平台证书加密敏感信息指引;作为响应字段需解密,参考如何使用API证书解密敏感字段


 amount  选填   integer

【订单金额】 微信支付订单金额,仅在微信支付场景下有效,单位:分


 out_trade_no  选填   string(32)

【商户订单号】 商户订单号,仅在微信支付场景下有效


 fapiao_bill_type  选填   string

【开具的发票类型】 用户选择提交开具发票的类型

可选取值

  • COMM_FAPIAO:  增值税普通发票

  • VAT_FAPIAO:  增值税专用发票


 user_apply_message  选填   string(100)

【留言信息】 用户申请开票时提交的留言信息

应答示例

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" : "mI7HGEJ4Q2B91IGjHrl7FNN9QuFPDfzeXoaJM4B8ZghZPzXK+vNotEZu/Gthm87Szv0MK2AoC0/3ZMDgltMtdoY6O0qZ4F1iXiwCuqkkBe+9M4ggvdzpPGM+fyed2QU1seUGbii5RVVVB9s+zLEQ8nv74vsgl77MZx14nd5obtCcfAvPfDJob3oG7FqlThmYKJqjiOwBvvQse7p9R8onj/POzSrbM8re8ZYGp4LcehXopTLdk2ZVWRv8bnJgKZWArAcqMdahq4jY2UVYeY4vpMmq4xuRTYk6xNXvowBBKK2SX8SqM+jm1USyoBIazLu4oaNFNdBO3fip1a1rFW0vRw==",
10  "email" : "NzJy3r0Z2u2Vs5l+WSH0A3CZ1oGlCZ66aa2wUlMXNmACbd4wU8LqqYCuTG4cYWxrVUSmviV59/Uy9vLdIwuHZVrMalYAZGtb8inWGhDj3wUqQnPkmBKBVGIWG5Y6XJmMvpXW6rIKsdzxs8NwWj30cRNfjanLxiWc0aIgl8Knwo0JcxlcYLo38T9ntsrRkQZMQEWHaMYnzjp7ysLbp6yW83OZb/NwEufERBdPnIbDbVE7DUd5MGhvO+tlr2YC1b4VCsrDmjryuTD5nvYYCGHyfXW2CM23hZdBm9tPc+mU18Z9d4XkasnfsecGWd2ISkpPmnk3DtapnD64Nw8JyLtkgw==",
11  "amount" : 1000,
12  "out_trade_no" : "order_20200701_123456",
13  "fapiao_bill_type" : "COMM_FAPIAO",
14  "user_apply_message" : "用户留言"
15}
16

 

错误码

公共错误码

状态码

错误码

描述

解决方案

400

PARAM_ERROR

参数错误

请根据错误提示正确传入参数

400

INVALID_REQUEST

HTTP 请求不符合微信支付 APIv3 接口规则

请参阅 接口规则

401

SIGN_ERROR

验证不通过

请参阅 签名常见问题

500

SYSTEM_ERROR

系统异常,请稍后重试

请稍后重试

业务错误码

状态码

错误码

描述

解决方案

400

INVALID_REQUEST

请求参数符合参数格式,但不符合业务规则

请使用正确的参数重新调用

403

NO_AUTH

商户无权限

请检查是否已经开通电子发票产品相关功能权限,并检查子商户是否接受了服务商的邀请

404

RESOURCE_NOT_EXISTS

用户尚未完成发票抬头的填写

请在接收到微信支付侧的【用户已申请开票】通知后重新调用,或者等待一段时间后重新调用

429

FREQUENCY_LIMITED

频率超限

请降低请求接口频率

 

 

反馈
咨询
目录
置顶