本開發(fā)指引對微信支付電子發(fā)票的標(biāo)準(zhǔn)流程、關(guān)鍵場景的開發(fā)思路和最佳實(shí)踐展開介紹。你可以閱讀開發(fā)指引,并結(jié)合【API文檔】完成微信支付電子發(fā)票的接入流程。
# 1、前置條件
為降低開發(fā)指引環(huán)節(jié)的閱讀和實(shí)踐成本,建議在閱讀本指引前,確保你已經(jīng):
閱讀【接入前準(zhǔn)備】文檔,完成AppID、商戶證書等相關(guān)參數(shù)和材料的準(zhǔn)備
閱讀【接口規(guī)則】,了解微信支付API v3通用的基礎(chǔ)約定,包括認(rèn)證機(jī)制、請求規(guī)則、數(shù)據(jù)格式、參數(shù)兼容性、錯誤處理等
# 2、開發(fā)指引
你可以根據(jù)商戶的不同需求,調(diào)用微信的電子發(fā)票能力,進(jìn)行場景應(yīng)用。
# 業(yè)務(wù)時序圖
步驟一 服務(wù)商邀請子商戶開通電子發(fā)票,子商戶并完成相關(guān)的開票模式選擇和產(chǎn)品設(shè)置后,可先調(diào)用《檢查子商戶開票功能狀態(tài)》檢查商戶是否完成電子發(fā)票功能授權(quán),如未授權(quán)需根據(jù)《接入前準(zhǔn)備》操作步驟完成授權(quán)邀請;
步驟二 確認(rèn)授權(quán)關(guān)系后,須先調(diào)用《配置開發(fā)選項(xiàng)》接口設(shè)置回調(diào)地址、支付開票入口標(biāo)識等,用于接收獲取用戶抬頭等信息通知;調(diào)用《創(chuàng)建電子發(fā)票卡券模板》接口為商戶創(chuàng)建電子發(fā)票的卡券模板;
步驟三 配置完成后,可調(diào)用《獲取商品和服務(wù)稅收分類對照表》查詢商戶設(shè)置的開票商品稅率信息;調(diào)用《獲取商戶開票基礎(chǔ)信息》,查詢獲取商戶配置的電子發(fā)票開票基礎(chǔ)信息;
步驟四 申請開具電子發(fā)票
- 場景1、微信支付場景申請開票
用戶通過微信支付消費(fèi),商戶可在支付賬單頁展示開票入口。通過《微信支付下單接口》傳入電子發(fā)票入口開放標(biāo)識字段(僅指定訂單展示)或通過《配置開發(fā)選項(xiàng)》設(shè)置支付訂單標(biāo)識(設(shè)置后全部訂單展示);用戶支付完成后,收到帶「開發(fā)票」入口的支付消息通知,通過支付賬單頁填寫發(fā)票抬頭,并提交申請。
- 場景2、非微信支付場景申請開票
用戶通過其他方式消費(fèi),可通過《獲取抬頭填寫鏈接》,生成開票二維碼或在訂單小程序展示,用戶掃碼或點(diǎn)擊后,填寫發(fā)票抬頭信息。
步驟五 用戶填寫抬頭后,會收到《用戶發(fā)票抬頭填寫完成通知》,然后通過《獲取用戶填寫的抬頭》,獲取用戶填寫的信息;獲取填寫抬頭后,根據(jù)訂單匹配相關(guān)訂單信息,然后調(diào)用《開具電子發(fā)票》為用戶開具電子發(fā)票并插入微信卡包;
步驟六 如商戶需對已開具的電子發(fā)票進(jìn)行沖紅(開具紅票),可調(diào)用《沖紅電子發(fā)票》進(jìn)行沖紅,并將其從用戶的微信卡包中刪除;
步驟七 調(diào)用《開具電子發(fā)票》接口或《沖紅電子發(fā)票》接口成功后,可通過《查詢電子發(fā)票》查詢電子發(fā)票開具/沖紅結(jié)果,并獲取已開具/沖紅/插卡的電子發(fā)票信息;
步驟八 如需下載電子發(fā)票,可先通過《查詢電子發(fā)票》獲取電子發(fā)票相關(guān)參數(shù)信息,然后通過《獲取發(fā)票下載信息》,獲取發(fā)票信息,調(diào)取《下載發(fā)票文件》,下載發(fā)票版式文件。