新增异常退款、查询下载电子发票接口

Author: minibear2021

CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## [1.2.40] - 2023-08-31
+
+### Added
+
+- 检查子商户开票功能状态
+- 获取发票下载信息
+- 下载发票文件
+- 发起异常退款
+
 ## [1.2.39] - 2023-05-16
 
 ### Fixed

README.md

@@ -154,7 +154,7 @@ Native 支付调试最简单便捷，调试通过没有问题证明初始化参
 | 公用| 公用 | 调起支付签名| sign | 是 | 是 |
 | 公用| 公用 | 回调通知| callback | 是 | 是 |
 | 公用| 公用 | 敏感信息参数解密 | decrypt | 是 | 是 |
-| 公用| 公用 | 下载账单| download_bill| 是 | 是 |
+| 公用| 公用 | 下载(交易、资金)账单| download_bill| 是 | 是 |
 | 商户进件 | 特约商户进件、小微商户进件| 提交申请单 | applyment_submit | 否| 是|
 | 商户进件 | 特约商户进件、小微商户进件| 查询申请单状态| applyment_query| 否| 是|
 | 商户进件 | 特约商户进件、小微商户进件| 修改结算账号| applyment_settlement_modify| 否| 是|
@@ -165,8 +165,9 @@ Native 支付调试最简单便捷，调试通过没有问题证明初始化参
 | 基础支付 | 合单支付 | 统一下单 | combine_pay| 是| 是|
 | 基础支付 | 合单支付 | 查询订单 | combine_query| 是| 是|
 | 基础支付 | 合单支付 | 关闭订单 | combine_close| 是| 是|
-| 基础支付 | JSAPI、APP、H5、Native、小程序、合单支付 | 申请退款 | refund| 是| 是|
-| 基础支付 | JSAPI、APP、H5、Native、小程序、合单支付 | 查询单笔退款| query_refund | 是| 是|
+| 基础支付 | 退款 | 申请退款 | refund| 是| 是|
+| 基础支付 | 退款 | 查询单笔退款| query_refund | 是| 是|
+| 基础支付 | 退款 | 发起异常退款| abnormal_refund | 是| 是|
 | 基础支付 | JSAPI、APP、H5、Native、小程序、合单支付 | 申请交易账单| trade_bill | 是| 是|
 | 基础支付 | JSAPI、APP、H5、Native、小程序、合单支付 | 申请资金账单| fundflow_bill| 是| 是|
 | 基础支付 | JSAPI、APP、H5、Native、小程序、合单支付 | 申请单个子商户资金账单 | submch_fundflow_bill| 否| 是|
@@ -300,18 +301,21 @@ Native 支付调试最简单便捷，调试通过没有问题证明初始化参
 | 风险合规 | 商户违规通知回调 | 删除商户违规通知回调地址 | merchantrisk_callback_delete | 否| 是|
 | 其他能力 | 图片上传 | 图片上传 | image_upload | 是| 是|
 | 其他能力 | 视频上传 | 视频上传 | video_upload | 是| 是|
-| 其他 | 电子发票（公共API） | 创建电子发票卡券模板 | fapiao_card_template | 是 | 是 |
-| 其他 | 电子发票（公共API） | 配置开发选项 | fapiao_set_merchant_config | 是 | 是 |
-| 其他 | 电子发票（公共API） | 查询商户配置的开发选项 | fapiao_merchant_config | 是 | 是 |
-| 其他 | 电子发票（公共API） | 获取抬头填写链接 | fapiao_title_url | 是 | 是 |
-| 其他 | 电子发票（公共API） | 获取用户填写的抬头 | fapiao_title | 是 | 是 |
-| 其他 | 电子发票(区块链模式) | 获取商品和服务税收分类对照表 | fapiao_tax_codes | 是 | 是 |
-| 其他 | 电子发票(区块链模式) | 获取商户开票基础信息 | fapiao_merchant_base_info | 是 | 是 |
-| 其他 | 电子发票(区块链模式) | 开具电子发票 | fapiao_applications | 是 | 是 |
-| 其他 | 电子发票(区块链模式) | 查询电子发票 | fapiao_query | 是 | 是 |
-| 其他 | 电子发票(区块链模式) | 冲红电子发票 | fapiao_reverse | 是 | 是 |
-| 其他 | 电子发票(自建平台模式) | 上传电子发票文件 | fapiao_upload_file | 是 | 是 |
-| 其他 | 电子发票(自建平台模式) | 将电子发票插入微信用户卡包 | fapiao_insert_cards | 是 | 是 |
+| 其他 | 电子发票 | 创建电子发票卡券模板 | fapiao_card_template | 是 | 是 |
+| 其他 | 电子发票 | 配置开发选项 | fapiao_set_merchant_config | 是 | 是 |
+| 其他 | 电子发票 | 查询商户配置的开发选项 | fapiao_merchant_config | 是 | 是 |
+| 其他 | 电子发票 | 获取抬头填写链接 | fapiao_title_url | 是 | 是 |
+| 其他 | 电子发票 | 获取用户填写的抬头 | fapiao_title | 是 | 是 |
+| 其他 | 电子发票 | 获取商品和服务税收分类对照表 | fapiao_tax_codes | 是 | 是 |
+| 其他 | 电子发票 | 获取商户开票基础信息 | fapiao_merchant_base_info | 是 | 是 |
+| 其他 | 电子发票 | 开具电子发票 | fapiao_applications | 是 | 是 |
+| 其他 | 电子发票 | 查询电子发票 | fapiao_query | 是 | 是 |
+| 其他 | 电子发票 | 冲红电子发票 | fapiao_reverse | 是 | 是 |
+| 其他 | 电子发票 | 上传电子发票文件 | fapiao_upload_file | 是 | 是 |
+| 其他 | 电子发票 | 将电子发票插入微信用户卡包 | fapiao_insert_cards | 是 | 是 |
+| 其他 | 电子发票 | 检查子商户开票功能状态 | fapiao_check_submch | 否 | 是 |
+| 其他 | 电子发票 | 获取发票下载信息 | fapiao_query_files | 是 | 是 |
+| 其他 | 电子发票 | 下载发票文件 | fapiao_download_file | 是 | 是 |
 | 其他 | 银行组件 | 获取对私银行卡号开户银行 | capital_search_bank_number | 是 | 是 |
 | 其他 | 银行组件 | 查询支持个人业务的银行列表 | capital_personal_banks | 是 | 是 |
 | 其他 | 银行组件 | 查询支持对公业务的银行列表 | capital_corporate_banks | 是 | 是 |

setup.py

@@ -6,7 +6,7 @@
 
 setup(
     name="wechatpayv3",
-    version="1.2.39",
+    version="1.2.40",
     author="minibear",
     description="微信支付 API v3 Python SDK(python sdk for wechatpay v3)",
     long_description=long_description,

wechatpayv3/__init__.py

@@ -90,8 +90,10 @@ def decrypt(self, ciphtext):
                             complaint_notification_update, complaint_response,
                             complaint_update_refund)
     from .fapiao import (fapiao_applications, fapiao_card_template,
+                         fapiao_check_submch, fapiao_download_file,
                          fapiao_insert_cards, fapiao_merchant_base_info,
-                         fapiao_merchant_config, fapiao_query, fapiao_reverse,
+                         fapiao_merchant_config, fapiao_query,
+                         fapiao_query_files, fapiao_reverse,
                          fapiao_set_merchant_config, fapiao_tax_codes,
                          fapiao_title, fapiao_title_url, fapiao_upload_file)
     from .goldplan import (goldplan_advertising_close,
@@ -173,10 +175,10 @@ def decrypt(self, ciphtext):
                                 profitsharing_unfreeze)
     from .smartguide import (guides_assign, guides_query, guides_register,
                              guides_update)
-    from .transaction import (close, combine_close, combine_pay, combine_query,
-                              download_bill, fundflow_bill, pay, query,
-                              query_refund, refund, submch_fundflow_bill,
-                              trade_bill)
+    from .transaction import (abnormal_refund, close, combine_close,
+                              combine_pay, combine_query, download_bill,
+                              fundflow_bill, pay, query, query_refund, refund,
+                              submch_fundflow_bill, trade_bill)
     from .transfer import (transfer_batch, transfer_bill_receipt,
                            transfer_detail_receipt, transfer_query_batchid,
                            transfer_query_bill_receipt,

wechatpayv3/fapiao.py

@@ -232,3 +232,48 @@ def fapiao_insert_cards(self, fapiao_apply_id, buyer_information, fapiao_card_in
         raise Exception('fapiao_card_information is not assigned.')
     params.update({'scene': scene})
     return self._core.request(path, method=RequestType.POST, data=params)
+
+
+def fapiao_check_submch(self, sub_mchid):
+    """检查子商户开票功能状态
+    :param sub_mch: 子商户号，微信支付分配的子商户号。示例值：'1900000001'
+    """
+    if sub_mchid:
+        path = '/v3/new-tax-control-fapiao/merchant/%s/check' % sub_mchid
+    else:
+        raise Exception('sub_mchid is not assigned.')
+    return self._core.request(path)
+
+
+def fapiao_query_files(self, fapiao_apply_id, sub_mchid=None, fapiao_id=None):
+    """获取发票下载信息
+    :param fapiao_apply_id: 发票申请单号，开票时指定的发票申请单号。
+    :param sub_mchid: 子商户号，微信支付分配的子商户号。示例值：'1900000001'
+    :param fapiao_id: 商户发票单号，开票时指定的商户发票单号，唯一标识一张电子发票。
+    """
+    if fapiao_apply_id:
+        path = '/v3/new-tax-control-fapiao/fapiao-applications/%s/fapiao-files' % fapiao_apply_id
+    else:
+        raise Exception('fapiao_apply_id is not assigned.')
+    params = {}
+    if sub_mchid:
+        params.update({'sub_mchid': sub_mchid})
+    if fapiao_id:
+        params.update({'fapiao_id': fapiao_id})
+    return self._core.request(path, method=RequestType.POST, data=params)
+
+
+def fapiao_download_file(self, url, openid, invoice_code, invoice_no, fapiao_id, sub_mchid=None):
+    """下载发票文件
+    :param url: 获取发票下载信息接口返回的download_url，保留其中的token字段不要删除。
+    """
+    if not (url and openid and invoice_code and invoice_no and fapiao_id):
+        raise Exception('url, openid, invoice_code, invocide_no or fapiao_id is not assigned.')
+    else:
+        path = '%s&mchid=%s&openid=%s&invoice_code=%s&invoice_no=%s&fapiao_id=%s' % (url, self._mchid, openid, invoice_code, invoice_no, fapiao_id)
+    if self._partner_mode:
+        if sub_mchid:
+            path = '%s&sub_mchid=%s' % (path, sub_mchid)
+        else:
+            raise Exception('sub_mchid is not assigned.')
+    return self._core.request(path)

wechatpayv3/transaction.py

@@ -389,3 +389,38 @@ def combine_close(self, combine_out_trade_no, sub_orders, combine_appid=None):
         params.update({'sub_orders': sub_orders})
     path = '/v3/combine-transactions/out-trade-no/%s/close' % combine_out_trade_no
     return self._core.request(path, method=RequestType.POST, data=params)
+
+
+def abnormal_refund(self, refund_id, out_refund_no, type, bank_type=None, bank_account=None, real_name=None, sub_mchid=None):
+    """发起异常退款
+    :param refund_id: 微信退款单号，退款单的主键，唯一定义此资源的标识。
+    :param out_refund_no: 商户退款单号，商户系统内部的退款单号，商户系统内部唯一，只能是数字、大小写字母_-|*@ ，同一退款单号多次请求只退一笔。
+    :param type: 异常退款处理方式，可选值：'COUPON', 'DISCOUNT'。
+    :param bank_type: 开户银行类型，采用字符串类型的银行标识，值列表详见官网银行类型。
+    :param bank_account: 收款银行卡号，用户的银行卡账号。
+    :param real_name: 收款用户姓名。
+    """
+    if refund_id:
+        path = '/v3/refund/domestic/refunds/%s/apply-abnormal-refund' % refund_id
+    else:
+        raise Exception('refund_id is not assigned.')
+    params = {}
+    if self._partner_mode:
+        if sub_mchid:
+            params.update({'sub_mchid': sub_mchid})
+        else:
+            raise Exception('sub_mchid is not assigned.')
+    if not (out_refund_no and type):
+        raise Exception('out_refund_no or type is not assigned.')
+    params.update({'out_refund_no': out_refund_no})
+    params.update({'type': type})
+    if bank_type:
+        params.update({'bank_type': bank_type})
+    cipher_data = False
+    if bank_account:
+        params.update({'bank_account': self._core.encrypt(bank_account)})
+        cipher_data = True
+    if real_name:
+        params.update({'real_name': self._core.encrypt(real_name)})
+        cipher_data = True
+    return self._core.request(path, method=RequestType.POST, data=params, cipher_data=cipher_data)