Pine
f1147dced3
- app/pay 独立支付子应用（config/wxpay/models/repository/service/routers），便于后期拆分微服务 - 充值订单表 0026_compute_recharge；套餐支持折扣(discount)与上架开关(enabled)，DB system_configs 优先、env 兜底 - 统一小程序支付：桌面端出小程序码→扫码进小程序确认页按 openid 发起 JSAPI→回调幂等到账(引擎 adjust_user_quota+镜像回写) - 内嵌 wechatpayv3(含 async_)，响应验签失败降级告警；新增 aiofiles 依赖 Co-Authored-By: Claude <noreply@anthropic.com>
217 lines
8.9 KiB
Python
217 lines
8.9 KiB
Python
# -*- coding: utf-8 -*-
|
|
|
|
from .type import RequestType
|
|
|
|
|
|
async def transfer_batch(
|
|
self,
|
|
out_batch_no,
|
|
batch_name,
|
|
batch_remark,
|
|
total_amount,
|
|
total_num,
|
|
transfer_detail_list=[],
|
|
appid=None,
|
|
transfer_scene_id=None,
|
|
notify_url=None,
|
|
):
|
|
"""发起商家转账
|
|
:param out_batch_no: 商户系统内部的商家批次单号，要求此参数只能由数字、大小写字母组成，在商户系统内部唯一，示例值：'plfk2020042013'
|
|
:param batch_name: 该笔批量转账的名称，示例值：'2019年1月深圳分部报销单'
|
|
:param batch_remark: 转账说明，UTF8编码，最多允许32个字符，示例值：'2019年1月深圳分部报销单'
|
|
:param total_amount: 转账总金额，单位为分，必须与批次内所有明细转账金额之和保持一致，否则无法发起转账操作，示例值：'4000000'
|
|
:param total_num: 转账总笔数，必须与批次内所有明细之和保持一致，否则无法发起转账操作，示例值：200
|
|
:param transfer_detail_list: 发起批量转账的明细列表，最多三千笔，示例值：[{"out_detail_no": "x23zy545Bd5436", "transfer_amount": 200000, "transfer_remark": "2020年4月报销", "openid": "o-MYE42l80oelYMDE34nYD456Xoy", "user_name": "张三"}]
|
|
:param appid: 应用ID，可不填，默认传入初始化时的appid，示例值:'wx1234567890abcdef'
|
|
:param transfer_scene_id: 转账场景ID，示例值:'1001'
|
|
:param notify_url: 通知地址，示例值:'https://www.weixin.qq.com/wxpay/pay.php'
|
|
"""
|
|
params = {}
|
|
if out_batch_no:
|
|
params.update({"out_batch_no": out_batch_no})
|
|
else:
|
|
raise Exception("out_batch_no is not assigned")
|
|
if batch_name:
|
|
params.update({"batch_name": batch_name})
|
|
else:
|
|
raise Exception("batch_name is not assigned")
|
|
if batch_remark:
|
|
params.update({"batch_remark": batch_remark})
|
|
else:
|
|
raise Exception("batch_remark is not assigned")
|
|
if total_amount:
|
|
params.update({"total_amount": total_amount})
|
|
else:
|
|
raise Exception("total_amount is not assigned")
|
|
if total_num:
|
|
params.update({"total_num": total_num})
|
|
else:
|
|
raise Exception("total_num is not assigned")
|
|
if transfer_detail_list:
|
|
params.update({"transfer_detail_list": transfer_detail_list})
|
|
else:
|
|
raise Exception("transfer_detail_list is not assigned")
|
|
cipher_data = False
|
|
for transfer_detail in params.get("transfer_detail_list"):
|
|
if transfer_detail.get("user_name"):
|
|
transfer_detail["user_name"] = self._core.encrypt(
|
|
transfer_detail.get("user_name")
|
|
)
|
|
cipher_data = True
|
|
params.update({"appid": appid or self._appid})
|
|
if notify_url or self._notify_url:
|
|
params.update({"notify_url": notify_url or self._notify_url})
|
|
if transfer_scene_id:
|
|
params.update({"transfer_scene_id": transfer_scene_id})
|
|
path = "/v3/transfer/batches"
|
|
return await self._core.request(
|
|
path, method=RequestType.POST, data=params, cipher_data=cipher_data
|
|
)
|
|
|
|
|
|
async def transfer_query_batchid(
|
|
self, batch_id, need_query_detail=False, offset=0, limit=20, detail_status="ALL"
|
|
):
|
|
"""微信批次单号查询批次单
|
|
:param batch_id: 微信批次单号，微信商家转账系统返回的唯一标识，示例值：1030000071100999991182020050700019480001
|
|
:param need_query_detail: 是否查询转账明细单，枚举值：true：是；false：否，默认否。
|
|
:param offset: 请求资源起始位置，默认值为0
|
|
:param limit: 最大资源条数，默认值为20
|
|
:param detail_status: 明细状态， ALL:全部。需要同时查询转账成功和转账失败的明细单；SUCCESS:转账成功。只查询转账成功的明细单；FAIL:转账失败。
|
|
"""
|
|
if batch_id:
|
|
path = "/v3/transfer/batches/batch-id/%s" % batch_id
|
|
else:
|
|
raise Exception("batch_id is not assigned")
|
|
if need_query_detail:
|
|
path += "?need_query_detail=true"
|
|
path += "&detail_status=%s" % detail_status
|
|
else:
|
|
path += "?need_query_detail=false"
|
|
path += "&offset=%s" % offset
|
|
path += "&limit=%s" % limit
|
|
return await self._core.request(path)
|
|
|
|
|
|
async def transfer_query_detail_id(self, batch_id, detail_id):
|
|
"""微信明细单号查询明细单
|
|
:param batch_id: 微信批次单号，微信商家转账系统返回的唯一标识，示例值：1030000071100999991182020050700019480001
|
|
:param detail_id: 微信明细单号，微信支付系统内部区分转账批次单下不同转账明细单的唯一标识，示例值：1040000071100999991182020050700019500100
|
|
"""
|
|
if batch_id and detail_id:
|
|
path = "/v3/transfer/batches/batch-id/%s/details/detail-id/%s" % (
|
|
batch_id,
|
|
detail_id,
|
|
)
|
|
else:
|
|
raise Exception("batch_id or detail_id is not assigned")
|
|
return await self._core.request(path)
|
|
|
|
|
|
async def transfer_query_out_batch_no(
|
|
self, out_batch_no, need_query_detail=False, offset=0, limit=20, detail_status="ALL"
|
|
):
|
|
"""商家批次单号查询批次单
|
|
:param out_batch_no: 商家批次单号，示例值：plfk2020042013
|
|
:param need_query_detail: 是否查询转账明细单，枚举值：true：是；false：否，默认否。
|
|
:param offset: 请求资源起始位置，默认值为0
|
|
:param limit: 最大资源条数，默认值为20
|
|
:param detail_status: 明细状态， ALL:全部。需要同时查询转账成功和转账失败的明细单；SUCCESS:转账成功。只查询转账成功的明细单；FAIL:转账失败。
|
|
"""
|
|
if out_batch_no:
|
|
path = "/v3/transfer/batches/out-batch-no/%s" % out_batch_no
|
|
else:
|
|
raise Exception("batch_id is not assigned")
|
|
if need_query_detail:
|
|
path += "?need_query_detail=true"
|
|
path += "&detail_status=%s" % detail_status
|
|
else:
|
|
path += "?need_query_detail=false"
|
|
path += "&offset=%s" % offset
|
|
path += "&limit=%s" % limit
|
|
return await self._core.request(path)
|
|
|
|
|
|
async def transfer_query_out_detail_no(self, out_detail_no, out_batch_no):
|
|
"""商家明细单号查询明细单
|
|
:param out_detail_no: 商家明细单号，示例值：x23zy545Bd5436
|
|
:param out_batch_no: 商家批次单号，示例值：plfk2020042013
|
|
"""
|
|
if out_detail_no and out_batch_no:
|
|
path = "/v3/transfer/batches/out-batch-no/%s/details/out-detail-no/%s" % (
|
|
out_batch_no,
|
|
out_detail_no,
|
|
)
|
|
else:
|
|
raise Exception("out_detail_no or out_batch_no is not assigned")
|
|
return await self._core.request(path)
|
|
|
|
|
|
async def transfer_bill_receipt(self, out_batch_no):
|
|
"""转账电子回单申请受理
|
|
:param out_batch_no: 商家批次单号，示例值：plfk2020042013
|
|
"""
|
|
params = {}
|
|
if out_batch_no:
|
|
params.update({"out_batch_no": out_batch_no})
|
|
else:
|
|
raise Exception("out_batch_no is assigned")
|
|
path = "/v3/transfer/bill-receipt"
|
|
return await self._core.request(path, method=RequestType.POST, params=params)
|
|
|
|
|
|
async def transfer_query_bill_receipt(self, out_batch_no):
|
|
"""查询转账电子回单
|
|
:param out_batch_no: 商家批次单号，示例值：plfk2020042013
|
|
"""
|
|
if out_batch_no:
|
|
path = "/v3/transfer/bill-receipt/%s" % out_batch_no
|
|
else:
|
|
raise Exception("out_batch_no is not assigned")
|
|
return await self._core.request(path)
|
|
|
|
|
|
async def transfer_detail_receipt(
|
|
self,
|
|
accept_type,
|
|
out_detail_no,
|
|
out_batch_no=None,
|
|
):
|
|
"""转账明细电子回单受理
|
|
:param accept_type: 受理类型
|
|
:param out_detail_no: 商家明细单号，示例值：x23zy545Bd5436
|
|
:param out_batch_no: 商家批次单号，示例值：plfk2020042013
|
|
"""
|
|
params = {}
|
|
if accept_type:
|
|
params.update({"accept_type": accept_type})
|
|
else:
|
|
raise Exception("accept_type is not assigned")
|
|
if out_detail_no:
|
|
params.update({"out_detail_no": out_detail_no})
|
|
else:
|
|
raise Exception("out_detail_no is not assigned")
|
|
if out_batch_no:
|
|
params.update({"out_batch_no": out_batch_no})
|
|
path = "/v3/transfer-detail/electronic-receipts"
|
|
return await self._core.request(path, method=RequestType.POST, params=params)
|
|
|
|
|
|
async def transfer_query_receipt(self, accept_type, out_detail_no, out_batch_no=None):
|
|
"""查询转账明细电子回单受理结果
|
|
:param accept_type: 受理类型
|
|
:param out_detail_no: 商家明细单号，示例值：x23zy545Bd5436
|
|
:param out_batch_no: 商家批次单号，示例值：plfk2020042013
|
|
"""
|
|
if accept_type:
|
|
path = "/v3/transfer-detail/electronic-receipts?accept_type=%s" % accept_type
|
|
else:
|
|
raise Exception("accept_type is not assigned")
|
|
if out_detail_no:
|
|
path += "&out_batch_no=%s" % out_detail_no
|
|
else:
|
|
raise Exception("out_detail_no is not assigned")
|
|
if out_batch_no:
|
|
path += "&out_batch_no=%s" % out_batch_no
|
|
return await self._core.request(path)
|