---
url: "https://pay.weixin.qq.com/doc/v3/partner/4015784260.md"
title: "获取用户填写抬头信息"
doc_id: 4015784260
---

>更新时间：2025.12.03

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




## 接口说明

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

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

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

　　　　　【备域名】https://api2.mch.weixin.qq.com 使用该域名将访问异地的接入点，指引[点击查看](https://pay.weixin.qq.com/doc/v3/merchant/4012075113.md)

## 请求参数

### Header 参数
| 参数名 | 类型 | 必填 | 描述 |
| --- |  --- | --- | --- |
| Authorization | string | true | 请参考 [签名认证](https://pay.weixin.qq.com/doc/v3/merchant/4012365342.md#%E8%AF%B7%E6%B1%82%E6%8E%A5%E5%8F%A3%E5%90%8E%E7%AB%AF%E7%AD%BE%E5%90%8D) 生成认证信息 |
| Accept | string | true | 请设置为 `application/json` |
### Query 参数
| 参数名 | 类型 | 必填 | 描述 |
| --- |  --- | --- | --- |
| sub_mchid | string(32) | true | 【子商户号】 微信支付分配的子商户号，具体请参考 [服务商模式开发必要参数说明](https://pay.weixin.qq.com/doc/v3/partner/4013080340.md) |
| scene | string | true | 【开票场景】 开票场景<br>可选取值<br><ul><li>`WITH_WECHATPAY`:  微信支付场景</li><li>`WITHOUT_WECHATPAY`:  非微信支付场景</li></ul> |
| fapiao_apply_id | string(32) | true | 【发票申请单号】 发票申请单号，唯一标识一次开票行为。当开票场景为WITHOUT\_WECHATPAY时，为调用 [【获取用户抬头填写链接】](https://pay.weixin.qq.com/doc/v3/partner/4015770776.md) 接口时指定的发票申请单号；当开票场景为WITH\_WECHATPAY时，为与本次开票关联的微信支付订单号，且必须是属于相应商户的订单 |
## 应答参数

200 OK

| 参数名 | 类型 | 必填 | 描述 |
| --- |  --- | --- | --- |
| type | string | true | 【购买方类型】 购买方类型<br>可选取值<br><ul><li>`INDIVIDUAL`:  个人、其他</li><li>`ORGANIZATION`:  单位</li></ul> |
| name | string(256) | true | 【名称】 购买方名称 |
| taxpayer_id | string(32) | false | 【纳税人识别号】 购买方纳税人识别号，购买方类型为ORGANIZATION时必填 |
| address | string(128) | false | 【地址】 购买方地址 |
| telephone | string(32) | false | 【电话】 购买方电话 |
| bank_name | string(128) | false | 【开户银行名称】 购买方开户银行名称 |
| bank_account | string(32) | false | 【银行账号】 购买方银行账号 |
| phone | string | false | 【手机号】 用户手机号。注意：该字段为密文字段，作为请求字段需加密，使用微信支付公钥加密（推荐），参考[获取微信支付公钥ID说明](https://pay.weixin.qq.com/doc/v3/partner/4013038589.md#Q:-%E5%A6%82%E4%BD%95%E8%8E%B7%E5%8F%96%E5%BE%AE%E4%BF%A1%E6%94%AF%E4%BB%98%E5%85%AC%E9%92%A5ID?)以及[微信支付公钥加密敏感信息指引](https://pay.weixin.qq.com/doc/v3/partner/4013059044.md)；也可以使用微信支付平台证书公钥加密，参考[获取平台证书序列号](https://pay.weixin.qq.com/doc/v3/partner/4013059181.md)、[平台证书加密敏感信息指引](https://pay.weixin.qq.com/doc/v3/partner/4013059053.md)；作为响应字段需解密，参考[如何使用API证书解密敏感字段](https://pay.weixin.qq.com/doc/v3/partner/4013059060.md) |
| email | string | false | 【邮箱地址】 用户邮箱地址。注意：该字段为密文字段，作为请求字段需加密，使用微信支付公钥加密（推荐），参考[获取微信支付公钥ID说明](https://pay.weixin.qq.com/doc/v3/partner/4013038589.md#Q:-%E5%A6%82%E4%BD%95%E8%8E%B7%E5%8F%96%E5%BE%AE%E4%BF%A1%E6%94%AF%E4%BB%98%E5%85%AC%E9%92%A5ID?)以及[微信支付公钥加密敏感信息指引](https://pay.weixin.qq.com/doc/v3/partner/4013059044.md)；也可以使用微信支付平台证书公钥加密，参考[获取平台证书序列号](https://pay.weixin.qq.com/doc/v3/partner/4013059181.md)、[平台证书加密敏感信息指引](https://pay.weixin.qq.com/doc/v3/partner/4013059053.md)；作为响应字段需解密，参考[如何使用API证书解密敏感字段](https://pay.weixin.qq.com/doc/v3/partner/4013059060.md) |
| amount | integer | false | 【订单金额】 微信支付订单金额，仅在微信支付场景下有效，单位：分 |
| out_trade_no | string(32) | false | 【商户订单号】 商户订单号，仅在微信支付场景下有效 |
| fapiao_bill_type | string | false | 【开具的发票类型】 用户选择提交开具发票的类型<br>可选取值<br><ul><li>`COMM_FAPIAO`:  增值税普通发票</li><li>`VAT_FAPIAO`:  增值税专用发票</li></ul> |
| user_apply_message | string(100) | false | 【留言信息】 用户申请开票时提交的留言信息 |
## 错误码

以下是本接口返回的错误码列表。详细错误码规则，请参考[微信支付接口规则-错误码和错误提示](https://pay.weixin.qq.com/doc/v3/partner/4012081726.md#%E9%94%99%E8%AF%AF%E7%A0%81%E5%92%8C%E9%94%99%E8%AF%AF%E6%8F%90%E7%A4%BA)

| 状态码 | 错误码 | 描述 | 解决方案 |
| --- | --- | --- | --- |
| 400 | PARAM\_ERROR | 参数错误 | 请根据错误提示正确传入参数 |
| 400 | INVALID\_REQUEST | HTTP 请求不符合微信支付 APIv3 接口规则 | 请参阅 [接口规则](https://pay.weixin.qq.com/doc/v3/merchant/4012081709.md) |
| 401 | SIGN\_ERROR | 验证不通过 | 请参阅 [签名常见问题](https://pay.weixin.qq.com/doc/v3/merchant/4012072670.md) |
| 500 | SYSTEM\_ERROR | 系统异常，请稍后重试 | 请稍后重试 |
| 400 | INVALID\_REQUEST | 请求参数符合参数格式，但不符合业务规则 | 请使用正确的参数重新调用 |
| 403 | NO\_AUTH | 商户无权限 | 请检查是否已经开通电子发票产品相关功能权限，并检查子商户是否接受了服务商的邀请 |
| 404 | RESOURCE\_NOT\_EXISTS | 用户尚未完成发票抬头的填写 | 请在接收到微信支付侧的【用户已申请开票】通知后重新调用，或者等待一段时间后重新调用 |
| 429 | FREQUENCY\_LIMITED | 频率超限 | 请降低请求接口频率 |

请求示例

- [curl 示例](https://pay.weixin.qq.com/doc/v3/partner/4015784260-curl.md)
- [Java 示例](https://pay.weixin.qq.com/doc/v3/partner/4015784260-java.md)
- [Go 示例](https://pay.weixin.qq.com/doc/v3/partner/4015784260-go.md)


应答示例

> 200 OK

```
{
  "type" : "INDIVIDUAL",
  "name" : "深圳市南山区测试企业",
  "taxpayer_id" : "202003261233701778",
  "address" : "深圳市南山区深南大道10000号",
  "telephone" : "075512345678",
  "bank_name" : "测试银行",
  "bank_account" : "62001234567890",
  "phone" : "mI7HGEJ4Q2B91IGjHrl7FNN9QuFPDfzeXoaJM4B8ZghZPzXK+vNotEZu/Gthm87Szv0MK2AoC0/3ZMDgltMtdoY6O0qZ4F1iXiwCuqkkBe+9M4ggvdzpPGM+fyed2QU1seUGbii5RVVVB9s+zLEQ8nv74vsgl77MZx14nd5obtCcfAvPfDJob3oG7FqlThmYKJqjiOwBvvQse7p9R8onj/POzSrbM8re8ZYGp4LcehXopTLdk2ZVWRv8bnJgKZWArAcqMdahq4jY2UVYeY4vpMmq4xuRTYk6xNXvowBBKK2SX8SqM+jm1USyoBIazLu4oaNFNdBO3fip1a1rFW0vRw==",
  "email" : "NzJy3r0Z2u2Vs5l+WSH0A3CZ1oGlCZ66aa2wUlMXNmACbd4wU8LqqYCuTG4cYWxrVUSmviV59/Uy9vLdIwuHZVrMalYAZGtb8inWGhDj3wUqQnPkmBKBVGIWG5Y6XJmMvpXW6rIKsdzxs8NwWj30cRNfjanLxiWc0aIgl8Knwo0JcxlcYLo38T9ntsrRkQZMQEWHaMYnzjp7ysLbp6yW83OZb/NwEufERBdPnIbDbVE7DUd5MGhvO+tlr2YC1b4VCsrDmjryuTD5nvYYCGHyfXW2CM23hZdBm9tPc+mU18Z9d4XkasnfsecGWd2ISkpPmnk3DtapnD64Nw8JyLtkgw==",
  "amount" : 1000,
  "out_trade_no" : "order_20200701_123456",
  "fapiao_bill_type" : "COMM_FAPIAO",
  "user_apply_message" : "用户留言"
}

```
