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

接口说明

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

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

请求参数

Header HTTP头参数

Authorization 必填 string

Accept 必填 string

请设置为application/json

query 查询参数

sub_mchid 必填 string(32)

【子商户号】 微信支付分配的子商户号，

【开票场景】 开票场景

可选取值

• WITH_WECHATPAY: 微信支付场景

• WITHOUT_WECHATPAY: 非微信支付场景

fapiao_apply_id 必填 string(32)

【发票申请单号】 发票申请单号，唯一标识一次开票行为。当开票场景为WITHOUT_WECHATPAY时，为调用

请求示例

curl

Java

Go

GET

curl-XGET\/v3/new-tax-control-fapiao/user-title?sub_mchid=1900000109&scene=WITH_WECHATPAY&fapiao_apply_id=4200000444201910177461284488\-H"Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..."\-H"Accept: application/json"

应答参数

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

【手机号】 用户手机号。注意：该字段为密文字段，作为请求字段需加密，使用微信支付公钥加密（推荐）

email 选填 string

【邮箱地址】 用户邮箱地址。

amount 选填 integer

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

out_trade_no 选填 string(32)

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

fapiao_bill_type 选填 string

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

可选取值

• COMM_FAPIAO: 增值税普通发票

• VAT_FAPIAO: 增值税专用发票

user_apply_message 选填 string(100)

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

应答示例

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":"用户留言"}

错误码

人人皆为创造者，共创方能共成长

每个人都是使用者，也是创造者；是数字世界的消费者，更是价值的生产者与分享者。在智能时代的浪潮里，单打独斗的发展模式早已落幕，唯有开放连接、创意共创、利益共享，才能让个体价值汇聚成生态合力，让技术与创意双向奔赴，实现平台与伙伴的快速成长、共赢致远。

原创永久分成，共赴星辰大海

原创创意共创、永久收益分成，是东方仙盟始终坚守的核心理念。我们坚信，每一份原创智慧都值得被尊重与回馈，以永久分成锚定共创初心，让创意者长期享有价值红利，携手万千伙伴向着科技星辰大海笃定前行，拥抱硅基 生命与数字智能交融的未来，共筑跨越时代的数字文明共同体。

东方仙盟：拥抱知识开源，共筑数字新生态

在全球化与数字化浪潮中，东方仙盟始终秉持开放协作、知识共享的理念，积极拥抱开源技术与开放标准。我们相信，唯有打破技术壁垒、汇聚全球智慧，才能真正推动行业的可持续发展。

开源赋能中小商户：通过将前端异常检测、跨系统数据互联等核心能力开源化，东方仙盟为全球中小商户提供了低成本、高可靠的技术解决方案，让更多商家能够平等享受数字转型的红利。
共建行业标准：我们积极参与国际技术社区，与全球开发者、合作伙伴共同制定开放协议 与技术规范，推动跨境零售、文旅、餐饮等多业态的系统互联互通，构建更加公平、高效的数字生态。
知识普惠，共促发展：通过开源社区 、技术文档与培训体系，东方仙盟致力于将前沿技术转化为可落地的行业实践，赋能全球合作伙伴，共同培育创新人才，推动数字经济 的普惠式增长

阿雪技术观

在科技发展浪潮中，我们不妨积极投身技术共享。不满足于做受益者，更要主动担当贡献者 。无论是分享代码、撰写技术博客，还是参与开源项目 维护改进，每一个微小举动都可能蕴含推动技术进步的巨大能量。东方仙盟是汇聚力量的天地，我们携手在此探索硅基 生命，为科技进步添砖加瓦。

Hey folks, in this wild tech - driven world, why not dive headfirst into the whole tech - sharing scene? Don't just be the one reaping all the benefits; step up and be a contributor too. Whether you're tossing out your code snippets , hammering out some tech blogs, or getting your hands dirty with maintaining and sprucing up open - source projects, every little thing you do might just end up being a massive force that pushes tech forward. And guess what? The Eastern FairyAlliance is this awesome place where we all come together. We're gonna team up and explore the whole silicon - based life thing, and in the process, we'll be fueling the growth of technology