商戶調(diào)用本接口,檢查用戶是否已完成抬頭填寫,并獲取用戶填寫的抬頭信息。在微信支付場(chǎng)景下,若該筆訂單在下單時(shí)指定在支付憑證上展示開票入口,則也可以調(diào)用本接口查詢用戶填寫的抬頭。
# 接口說明
支持商戶:
【普通服務(wù)商】
請(qǐng)求方式:
【GET】/v3/new-tax-control-fapiao/user-title
請(qǐng)求域名:
【主域名】
https://api.mch.weixin.qq.com
使用該域名將訪問就近的接入點(diǎn)【備域名】
https://api2.mch.weixin.qq.com
使用該域名將訪問異地的接入點(diǎn) ,指引點(diǎn)擊查看
# 請(qǐng)求參數(shù)
- Authorization 必填 string請(qǐng)參考 簽名認(rèn)證 生成認(rèn)證信息
- Accept 必填 string請(qǐng)?jiān)O(shè)置為
application/json
Header HTTP頭參數(shù)
- sub_mchid 選填 string(32)【子商戶號(hào)】 微信支付分配的子商戶號(hào),服務(wù)商模式下必傳
- fapiao_apply_id 必填 string(32)【發(fā)票申請(qǐng)單號(hào)】 發(fā)票申請(qǐng)單號(hào),唯一標(biāo)識(shí)一次開票行為。當(dāng)開票場(chǎng)景為WITHOUT_WECHATPAY時(shí),為調(diào)用【獲取抬頭填寫鏈接】接口時(shí)指定的發(fā)票申請(qǐng)單號(hào);當(dāng)開票場(chǎng)景為WITH_WECHATPAY時(shí),為與本次開票關(guān)聯(lián)的微信支付訂單號(hào),且必須是屬于相應(yīng)商戶的訂單
- scene 必填 string【開票場(chǎng)景】 開票場(chǎng)景
可選取值:WITH_WECHATPAY
: 微信支付場(chǎng)景WITHOUT_WECHATPAY
: 非微信支付場(chǎng)景
Query 查詢參數(shù)
請(qǐng)求示例
GET
# 應(yīng)答參數(shù)
- type 必填 string【購買方類型】 購買方類型
可選取值:INDIVIDUAL
: 個(gè)人ORGANIZATION
: 單位
- name 必填 string(256)【名稱】 購買方名稱
- taxpayer_id 選填 string(32)【納稅人識(shí)別號(hào)】 購買方納稅人識(shí)別號(hào),購買方類型為ORGANIZATION時(shí)必須存在
- address 選填 string(128)【地址】 購買方地址
- telephone 選填 string(32)【電話】 購買方電話
- bank_name 選填 string(128)【開戶銀行】 購買方開戶銀行
- bank_account 選填 string(32)【銀行賬號(hào)】 購買方銀行賬號(hào)
- phone 選填 string【手機(jī)號(hào)】 用戶手機(jī)號(hào)。注意:該字段為密文字段,加解密算法請(qǐng)參見《微信支付V3版規(guī)范》
- email 選填 string【郵箱地址】 用戶郵箱地址。注意:該字段為密文字段,加解密算法請(qǐng)參見《微信支付V3版規(guī)范》
200OK
應(yīng)答示例
200 OK
# 錯(cuò)誤碼
# 公共錯(cuò)誤碼
狀態(tài)碼 | 錯(cuò)誤碼 | 描述 | 解決方案 |
---|---|---|---|
400 | PARAM_ERROR | 參數(shù)錯(cuò)誤 | 請(qǐng)根據(jù)錯(cuò)誤提示正確傳入?yún)?shù) |
400 | INVALID_REQUEST | HTTP 請(qǐng)求不符合微信支付 APIv3 接口規(guī)則 | 請(qǐng)參閱 接口規(guī)則 |
401 | SIGN_ERROR | 驗(yàn)證不通過 | 請(qǐng)參閱 簽名常見問題 |
500 | SYSTEM_ERROR | 系統(tǒng)異常,請(qǐng)稍后重試 | 請(qǐng)稍后重試 |
# 業(yè)務(wù)錯(cuò)誤碼
狀態(tài)碼 | 錯(cuò)誤碼 | 描述 | 解決方案 |
---|---|---|---|
400 | INVALID_REQUEST | 請(qǐng)求參數(shù)符合參數(shù)格式,但不符合業(yè)務(wù)規(guī)則 | 請(qǐng)使用正確的參數(shù)重新調(diào)用 |
401 | SIGN_ERROR | 簽名錯(cuò)誤或簽名信息不完整 | 請(qǐng)檢查簽名參數(shù)和方法是否都符合簽名算法要求 |
403 | NO_AUTH | 商戶無權(quán)限 | 請(qǐng)檢查是否已經(jīng)開通電子發(fā)票產(chǎn)品相關(guān)功能權(quán)限,若是服務(wù)商模式,還需確認(rèn)子商戶是否接受了服務(wù)商的邀請(qǐng) |
404 | RESOURCE_NOT_EXISTS | 用戶尚未完成發(fā)票抬頭的填寫 | 請(qǐng)?jiān)诮邮盏轿⑿胖Ц秱?cè)的【用戶已申請(qǐng)開票】通知后重新調(diào)用,或者等待一段時(shí)間后重新調(diào)用 |
429 | FREQUENCY_LIMITED | 頻率超限 | 請(qǐng)降低請(qǐng)求接口頻率 |