電子回單查詢
1. 產品介紹
1.1 簡介
客戶在交易完成后可以獲得該筆交易的電子回單,用作憑證提供給自己的用戶。可以通過接口和控臺獲得該筆交易的電子回單。
1.2 應用場景
需要通過接口方式獲取電子回單的渠道商、SAAS服務商,可以通過接口和控臺獲得該筆交易的電子回單。
以上場景可以支持兩種類型的電子回單:
- 支持向電商平臺提供一張電子回單,展示100元訂單金額及交易手續費;
- 支持為兩個分賬接收方分別生成電子回單,分別是90元與10元,不顯示交易手續費;
如有更多場景可以咨詢支持人員。
2. 接入前準備
2.1 商務準備
商戶入駐開通后默認都是支持調用電子回單接口的。
2.2 對接準備
第一步:密鑰獲取
聯調之前需要先獲取公私鑰,參見公私解鑰參數獲取說明;
第二步:公共參數獲取
登錄服務商/商戶控臺后,可在開發設置-開發者信息中,獲取sys_id,product_id參數信息;
3. 開發指引
3.1 對接規范
調用匯付接口,均采取POST形式提交,數據格式統一為JSON格式,相關SDK及簽名方法見鏈接:
SDK示例:Java 開發工具包
加簽驗簽:v2版接口加簽驗簽
3.2 系統調用流程
3.2.1 交易流程
調用電子回單查詢接口獲取所需電子回單。
選擇不同模板類型會有不同的電子回單效果。
電子回單模板樣式
訂單模板
訂單模板的“金額展示字段”展示為訂單金額,不扣除手續費,示例如下。
金額模板
金額模板的“金額展示字段”展示為實際入賬金額,已扣除手續費,示例如下。
有分賬的模板
分賬: 調用方傳入主交易流水號,將按每個分賬接收方分別生成一張展示對應實際接收方入賬金額的電子回單(只生成已經交易確認完成的交易),生成壓縮包供調用方下載。注:此時展示手續費為分賬手續費而非主交易手續費。其中一方收到電子回單圖例如下。
不分賬: 調用方傳入主交易流水號,將生成出款方到延遲戶,展示金額為主交易金額的一張單子回單。
注:此時展示手續費為分主交易手續費。
收費模板
匯付收取支付手續費的電子回單,示例如下:
4. API列表
類型 | 功能 | 描述 |
---|---|---|
應用程序接口 | 電子回單查詢 | 獲取交易的電子回單 |
5.常見問題
- 下載地址失效。
問題原因:鏈接超過下載有效期。
當為分賬模式時返回的為壓縮包下載鏈接,其他模式均為pdf文件下載鏈接。分賬模式的電子回單下載鏈接有效期為3天,建議下載保存。其它電子回單下載鏈接永久有效。
解決方案:
獲取到電子發票鏈接時請及時下載保存。
更多問題詳見斗拱開發者社區:https://service.dougong.net/t/qa