feat: 支持 0 元退款(仅作废权益不退钱)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
邹进
2026-10-22 11:17:29 +09:00
parent 1f28ac3151
commit 437d1c2c2c
5 changed files with 60 additions and 15 deletions

View File

@@ -36,7 +36,8 @@ type refundMethodDecision struct {
// decideRefundMethods 派生权威实收金额并按来源实际支付方式生成可选退款方式。
//
// 派生来源:线上支付取该订单原成功支付记录金额;资产钱包、代理主钱包与后台线下套餐订单
// 取订单实际收款或实际扣款金额。无法确定或金额非正时拒绝,绝不允许提交人以自填金额替代。
// 取订单实际收款或实际扣款金额。无法确定或金额非正时拒绝,绝不允许提交人以自填金额替代;
// 唯一例外是后台线下订单实收为 0(如迁移订单),冻结实收取 0,只能申请 0 元退款。
func (s *Service) decideRefundMethods(ctx context.Context, order *model.Order) (*refundMethodDecision, error) {
if order == nil || order.ID == 0 {
return nil, errors.New(errors.CodeInvalidParam, "退款来源订单无效")
@@ -81,7 +82,7 @@ func (s *Service) decideRefundMethods(ctx context.Context, order *model.Order) (
return nil, errors.New(errors.CodeInvalidParam, "钱包支付订单的买家类型不支持退款")
}
case model.PaymentMethodOffline:
amount, err := orderActualPaidAmount(order)
amount, err := offlineActualPaidAmount(order)
if err != nil {
return nil, err
}
@@ -103,6 +104,14 @@ func orderActualPaidAmount(order *model.Order) (int64, error) {
return *order.ActualPaidAmount, nil
}
// offlineActualPaidAmount 取后台线下订单的实际收款金额:允许为 0(只能申请 0 元退款),缺失或为负时拒绝。
func offlineActualPaidAmount(order *model.Order) (int64, error) {
if order.ActualPaidAmount == nil || *order.ActualPaidAmount < 0 {
return 0, errors.New(errors.CodeInvalidParam, "订单实际收款金额缺失或为负,无法确定权威实收金额")
}
return *order.ActualPaidAmount, nil
}
// loadPaidPackagePayment 读取该订单原成功的线上支付记录。
func (s *Service) loadPaidPackagePayment(ctx context.Context, orderID uint) (*model.Payment, error) {
var payment model.Payment
@@ -219,12 +228,13 @@ func validateRefundMethod(decision *refundMethodDecision, method string) error {
}
// validateCustomerAccountMaterial 校验客户收款信息方式的材料完整性。
// 客户收款信息与至少一个客户凭证附件必须同时存在;不得复用公司员工收款方式字典。
func validateCustomerAccountMaterial(method, customerAccountInfo string, voucherKeys []string) error {
// 正数退款时客户收款信息与至少一个客户凭证附件必须同时存在;0 元退款不退钱,客户收款信息可为空,
// 但仍须至少一个客户凭证附件。不得复用公司员工收款方式字典。
func validateCustomerAccountMaterial(method string, amount int64, customerAccountInfo string, voucherKeys []string) error {
if method != constants.RefundMethodCustomerAccount {
return nil
}
if strings.TrimSpace(customerAccountInfo) == "" {
if amount > 0 && strings.TrimSpace(customerAccountInfo) == "" {
return errors.New(errors.CodeInvalidParam, "客户收款信息退款必须填写客户收款信息")
}
hasVoucher := false
@@ -240,13 +250,13 @@ func validateCustomerAccountMaterial(method, customerAccountInfo string, voucher
return nil
}
// validateFrozenRefundAmount 校验退款金额为正分且不超过冻结实收金额。
// validateFrozenRefundAmount 校验退款金额不为负且不超过冻结实收金额;0 元退款表示作废权益、不退钱。
func validateFrozenRefundAmount(amount, frozenActualReceivedAmount int64) error {
if amount <= 0 {
return errors.New(errors.CodeInvalidParam, "退款金额必须为正分")
if amount < 0 {
return errors.New(errors.CodeInvalidParam, "退款金额不能为负")
}
if frozenActualReceivedAmount <= 0 {
return errors.New(errors.CodeInvalidParam, "冻结实收金额缺失或非正,无法受理退款申请")
if frozenActualReceivedAmount < 0 {
return errors.New(errors.CodeInvalidParam, "冻结实收金额为负,无法受理退款申请")
}
if amount > frozenActualReceivedAmount {
return errors.New(errors.CodeInvalidParam, "退款金额不能超过冻结实收金额")
@@ -254,6 +264,15 @@ func validateFrozenRefundAmount(amount, frozenActualReceivedAmount int64) error
return nil
}
// validateZeroAmountMethod 校验 0 元退款只能选客户收款信息方式:原路退款与退回原钱包都要动钱。
// 钱包支付订单的方式矩阵不含客户收款信息,因此本校验同时保证钱包订单不能申请 0 元退款。
func validateZeroAmountMethod(amount int64, method string) error {
if amount == 0 && strings.TrimSpace(method) != constants.RefundMethodCustomerAccount {
return errors.New(errors.CodeInvalidParam, "0 元退款仅支持客户收款信息方式")
}
return nil
}
// buildChannelRefundRequestNo 仅在原路退款方式下按冻结商户派生本次尝试的渠道退款请求号。
// 请求号由收口审批申请用例冻结到不可变尝试记录上,同一尝试的渠道重试复用它作为幂等标识,
// 重提生成新值;非原路方式返回空串。