From 52d0b2fc1c8e9a1c776c8a2d081e15edee7a0026 Mon Sep 17 00:00:00 2001 From: Binary Wang Date: Wed, 2 Jul 2025 10:19:16 +0800 Subject: [PATCH] =?UTF-8?q?:art:=20=E4=B8=BA=E5=B0=8F=E7=A8=8B=E5=BA=8F?= =?UTF-8?q?=E8=99=9A=E6=8B=9F=E6=94=AF=E4=BB=98=E6=8E=A5=E5=8F=A3=E7=B1=BB?= =?UTF-8?q?=E5=A2=9E=E5=8A=A0=E6=B3=A8=E9=87=8A=E6=96=87=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../wx/miniapp/api/WxMaXPayService.java | 119 +++++++++++++++++- 1 file changed, 117 insertions(+), 2 deletions(-) diff --git a/weixin-java-miniapp/src/main/java/cn/binarywang/wx/miniapp/api/WxMaXPayService.java b/weixin-java-miniapp/src/main/java/cn/binarywang/wx/miniapp/api/WxMaXPayService.java index a099cd6dd..996a9517c 100644 --- a/weixin-java-miniapp/src/main/java/cn/binarywang/wx/miniapp/api/WxMaXPayService.java +++ b/weixin-java-miniapp/src/main/java/cn/binarywang/wx/miniapp/api/WxMaXPayService.java @@ -3,35 +3,150 @@ package cn.binarywang.wx.miniapp.api; import cn.binarywang.wx.miniapp.bean.xpay.*; import me.chanjar.weixin.common.error.WxErrorException; +/** + * 小程序虚拟支付相关接口。 + * 文档：https://developers.weixin.qq.com/miniprogram/dev/platform-capabilities/industry/virtual-payment.html + * + */ public interface WxMaXPayService { + /** + * 查询用户虚拟币余额。 + * + * @param request 查询用户余额请求对象 + * @param sigParams 签名参数对象 + * @return 用户余额查询结果 + * @throws WxErrorException 查询失败时抛出 + */ WxMaXPayQueryUserBalanceResponse queryUserBalance(WxMaXPayQueryUserBalanceRequest request, WxMaXPaySigParams sigParams) throws WxErrorException; + /** + * 虚拟币充值下单。 + * + * @param request 虚拟币充值请求对象 + * @param sigParams 签名参数对象 + * @return 虚拟币充值结果 + * @throws WxErrorException 充值失败时抛出 + */ WxMaXPayCurrencyPayResponse currencyPay(WxMaXPayCurrencyPayRequest request, WxMaXPaySigParams sigParams) throws WxErrorException; + /** + * 查询订单信息。 + * + * @param request 查询订单请求对象 + * @param sigParams 签名参数对象 + * @return 订单查询结果 + * @throws WxErrorException 查询失败时抛出 + */ WxMaXPayQueryOrderResponse queryOrder(WxMaXPayQueryOrderRequest request, WxMaXPaySigParams sigParams) throws WxErrorException; + /** + * 取消虚拟币充值订单。 + * + * @param request 取消充值订单请求对象 + * @param sigParams 签名参数对象 + * @return 取消充值订单结果 + * @throws WxErrorException 取消失败时抛出 + */ WxMaXPayCancelCurrencyPayResponse cancelCurrencyPay(WxMaXPayCancelCurrencyPayRequest request, WxMaXPaySigParams sigParams) throws WxErrorException; + /** + * 通知发货。 + * + * @param request 通知发货请求对象 + * @param sigParams 签名参数对象 + * @return 通知发货是否成功 + * @throws WxErrorException 通知失败时抛出 + */ boolean notifyProvideGoods(WxMaXPayNotifyProvideGoodsRequest request, WxMaXPaySigParams sigParams) throws WxErrorException; + /** + * 赠送虚拟币。 + * + * @param request 赠送虚拟币请求对象 + * @param sigParams 签名参数对象 + * @return 赠送虚拟币结果 + * @throws WxErrorException 赠送失败时抛出 + */ WxMaXPayPresentCurrencyResponse presentCurrency(WxMaXPayPresentCurrencyRequest request, WxMaXPaySigParams sigParams) throws WxErrorException; - + /** + * 下载对账单。 + * + * @param request 下载对账单请求对象 + * @param sigParams 签名参数对象 + * @return 对账单下载结果 + * @throws WxErrorException 下载失败时抛出 + */ WxMaXPayDownloadBillResponse downloadBill(WxMaXPayDownloadBillRequest request, WxMaXPaySigParams sigParams) throws WxErrorException; + /** + * 退款申请。 + * + * @param request 退款申请请求对象 + * @param sigParams 签名参数对象 + * @return 退款申请结果 + * @throws WxErrorException 退款失败时抛出 + */ WxMaXPayRefundOrderResponse refundOrder(WxMaXPayRefundOrderRequest request, WxMaXPaySigParams sigParams) throws WxErrorException; + /** + * 创建提现订单。 + * + * @param request 创建提现订单请求对象 + * @param sigParams 签名参数对象 + * @return 创建提现订单结果 + * @throws WxErrorException 创建失败时抛出 + */ WxMaXPayCreateWithdrawOrderResponse createWithdrawOrder(WxMaXPayCreateWithdrawOrderRequest request, WxMaXPaySigParams sigParams) throws WxErrorException; + /** + * 查询提现订单。 + * + * @param request 查询提现订单请求对象 + * @param sigParams 签名参数对象 + * @return 提现订单查询结果 + * @throws WxErrorException 查询失败时抛出 + */ WxMaXPayQueryWithdrawOrderResponse queryWithdrawOrder(WxMaXPayQueryWithdrawOrderRequest request, WxMaXPaySigParams sigParams) throws WxErrorException; + /** + * 启动道具上传。 + * + * @param request 启动道具上传请求对象 + * @param sigParams 签名参数对象 + * @return 启动道具上传是否成功 + * @throws WxErrorException 启动失败时抛出 + */ boolean startUploadGoods(WxMaXPayStartUploadGoodsRequest request, WxMaXPaySigParams sigParams) throws WxErrorException; + /** + * 查询道具上传状态。 + * + * @param request 查询道具上传状态请求对象 + * @param sigParams 签名参数对象 + * @return 道具上传状态查询结果 + * @throws WxErrorException 查询失败时抛出 + */ WxMaXPayQueryUploadGoodsResponse queryUploadGoods(WxMaXPayQueryUploadGoodsRequest request, WxMaXPaySigParams sigParams) throws WxErrorException; + /** + * 启动道具发布。 + * + * @param request 启动道具发布请求对象 + * @param sigParams 签名参数对象 + * @return 启动道具发布是否成功 + * @throws WxErrorException 启动失败时抛出 + */ boolean startPublishGoods(WxMaXPayStartPublishGoodsRequest request, WxMaXPaySigParams sigParams) throws WxErrorException; + /** + * 查询道具发布状态。 + * + * @param request 查询道具发布状态请求对象 + * @param sigParams 签名参数对象 + * @return 道具发布状态查询结果 + * @throws WxErrorException 查询失败时抛出 + */ WxMaXPayQueryPublishGoodsResponse queryPublishGoods(WxMaXPayQueryPublishGoodsRequest request, WxMaXPaySigParams sigParams) throws WxErrorException; - }