@mohasinac/appkit 3.2.20 → 3.3.0

package/dist/_internal/server/features/checkout/actions.d.ts

@@ -7,6 +7,8 @@ export interface CreateCheckoutOrderInput {
     /** Required for physical carts; omitted for digital-code-only carts (no shipping). */
     addressId?: string;
     paymentMethod: CheckoutPaymentMethod;
+    /** Required when paymentMethod === "emi" — the buyer's chosen tenure (2–6 months). */
+    emiTenureMonths?: number;
     notes?: string;
     excludedProductIds?: string[];
     /** When true this is an admin test order — OTP consent is pre-granted and the order is created paid/processing. */

package/dist/_internal/server/features/checkout/actions.js

@@ -16,6 +16,7 @@ import { failedCheckoutRepository } from "../../../../features/checkout/reposito
 import { sendOrderConfirmationEmail } from "../../../../features/contact/server";
 import { splitCartIntoOrderGroups } from "../../../../features/orders/index";
 import { resolveDate } from "../../../../utils";
+import { computeCodHandlingFee } from "../../../shared/fees/calculator";
 import { getAdminDb, getAdminRealtimeDb, RTDB_PATHS, } from "../../../../providers/db-firebase";
 import { PRODUCT_COLLECTION, PRODUCT_CODES_SUBCOLLECTION } from "../../../../features/products/schemas/firestore";
 import { CART_COLLECTION } from "../../../../features/cart/schemas/index";
@@ -25,7 +26,8 @@ import { consentOtpRef, consentOtpRateLimitRef, CONSENT_OTP_MAX_BYPASS_CREDITS,
 import { OrderStatusValues, PaymentStatusValues, PaymentMethodValues, } from "../../../../features/orders/schemas/index";
 import { getDefaultCurrency } from "../../../../core/index";
 import { verifyPaymentSignatureWithKeys, fetchRazorpayOrder, paiseToRupees, } from "../../../../providers/payment-razorpay/index";
-import { CHECKOUT_DEFAULT_COMMISSIONS } from "../../../shared/features/checkout/config";
+import { CHECKOUT_DEFAULT_COMMISSIONS, CHECKOUT_DEFAULT_EMI_SETTINGS } from "../../../shared/features/checkout/config";
+import { checkEmiEligibility, computeEmiSchedule } from "../../../shared/features/emi/schedule";
 import { formatShippingAddress } from "./data";
 import { enforceMaxPerUserForCart, computePrizeRevealDeadline, } from "./prize-bundle-gates";
 import { getListingRule, runSyncPreflight, } from "../../../shared/checkout/rules";
@@ -147,25 +149,19 @@ function accumulateCouponUsage(accumulator, couponCode, couponId, discountAmount
     entry.totalDiscount += discountAmount;
     accumulator.set(couponCode, entry);
 }
-async function resolveShippingCost(storeId, groupTotal, commissions) {
+async function resolveShippingCost(storeId) {
     if (!storeId)
-        return { shippingFee: 0, storeOwnerId: undefined };
+        return { shippingFee: 0, storeOwnerId: undefined, storeEmiEnabled: false };
     const store = await storeRepository.findById(storeId);
     const storeOwnerId = store?.ownerId;
+    const storeEmiEnabled = store?.emiEnabled === true;
     if (!storeOwnerId)
-        return { shippingFee: 0, storeOwnerId: undefined };
+        return { shippingFee: 0, storeOwnerId: undefined, storeEmiEnabled };
     const sellerUser = await userRepository.findById(storeOwnerId);
     const shippingConfig = sellerUser?.shippingConfig;
     if (!shippingConfig?.isConfigured)
-        return { shippingFee: 0, storeOwnerId };
-    if (shippingConfig.method === "custom") {
-        return { shippingFee: shippingConfig.customShippingPrice ?? 0, storeOwnerId };
-    }
-    if (shippingConfig.method === "shiprocket") {
-        const percentFee = groupTotal * (commissions.platformShippingPercent / 100);
-        return { shippingFee: Math.max(percentFee, commissions.platformShippingFixedMin), storeOwnerId };
-    }
-    return { shippingFee: 0, storeOwnerId };
+        return { shippingFee: 0, storeOwnerId, storeEmiEnabled };
+    return { shippingFee: shippingConfig.customShippingPrice ?? 0, storeOwnerId, storeEmiEnabled };
 }
 function buildStockUpdatePayload(product, qtyDelta) {
     const lt = (product.listingType ?? "standard");
@@ -224,6 +220,208 @@ function dispatchOrderConfirmationEmails(emailsToSend) {
         return;
     Promise.all(emailsToSend.map((e) => sendOrderConfirmationEmail(e))).catch((err) => serverLogger.error("Order confirmation email error:", err));
 }
+// SB-UNI-5 2026-05-13 — bundle cart-lines use item.price (locked bundle price
+// at add-time); regular lines use product.price (current Firestore). Prevents
+// stale cart-cached prices from being charged on COD/UPI orders.
+function unitPriceFor(item, product) {
+    return item.bundleCategorySlug && item.bundleProductIds?.length
+        ? item.price
+        : product.price;
+}
+/**
+ * Places one order for one seller-group of the checkout cart — fee math
+ * (COD deposit/handling, EMI schedule), coupon apportionment, order-doc
+ * creation, digital-code claim, and notification fan-out. Pushes into
+ * `ctx.orderIds` / `ctx.emailsToSend` and returns the group's pre-fee total
+ * so the caller can accumulate the checkout-wide `total`.
+ */
+async function createOrderForGroup(group, orderType, ctx) {
+    const { paymentMethod, emiTenureMonths, emiSettings, commissions, appliedCoupons, cartSubtotal, couponUsageAccumulator, uid, userName, userEmail, shippingAddress, notes, adminBypass, adminBypassBy, adminBatchId, orderIds, emailsToSend, } = ctx;
+    const firstItem = group[0].item;
+    const firstProduct = group[0].product;
+    const groupTotal = group.reduce((sum, { item, product }) => sum + unitPriceFor(item, product) * item.quantity, 0);
+    // S-SBUNI-RULES 2026-05-13 — order-item decoration via rule registry.
+    const orderItems = group.map(({ item, product }) => {
+        const lt = (product.listingType ?? "standard");
+        const itemRule = getListingRule(lt);
+        // SB-UNI-5 2026-05-13 — forward bundle identifiers so the order-detail
+        // UI can collapse expanded lines back under a "Bundle: <name>" header.
+        const bundleFields = item.bundleCategorySlug && item.bundleProductIds
+            ? {
+                bundleCategorySlug: item.bundleCategorySlug,
+                bundleProductIds: item.bundleProductIds,
+            }
+            : {};
+        const unitPrice = unitPriceFor(item, product);
+        const baseLine = {
+            productId: item.productId,
+            productTitle: item.productTitle,
+            quantity: item.quantity,
+            unitPrice,
+            totalPrice: unitPrice * item.quantity,
+            ...bundleFields,
+        };
+        return itemRule.decorateOrderItem(baseLine, product);
+    });
+    const totalQuantity = group.reduce((sum, { item }) => sum + item.quantity, 0);
+    const { shippingFee, storeOwnerId, storeEmiEnabled } = await resolveShippingCost(firstItem.storeId);
+    const isCodLike = paymentMethod === "cod" || paymentMethod === "upi_manual" || paymentMethod === "cash";
+    const depositAmount = isCodLike
+        ? Math.round(groupTotal * (commissions.codDepositPercent / 100) * 100) / 100
+        : undefined;
+    const codRemainingAmount = isCodLike
+        ? Math.round((groupTotal - (depositAmount ?? 0)) * 100) / 100
+        : undefined;
+    let emiSchedule;
+    if (paymentMethod === "emi" && emiTenureMonths) {
+        const eligibility = checkEmiEligibility(groupTotal, storeEmiEnabled, emiSettings);
+        if (!eligibility.eligible) {
+            throw new ValidationError(`EMI is not available for this order (${eligibility.reason}). Minimum order value per seller is ₹${Math.round(emiSettings.minOrderValueInPaise / 100)}.`);
+        }
+        emiSchedule = computeEmiSchedule(groupTotal, emiTenureMonths, emiSettings);
+    }
+    // Handling fee charged to the buyer for choosing COD, on top of the order
+    // total — not deducted from the deposit/remaining split above.
+    const codHandlingFee = paymentMethod === "cod" ? computeCodHandlingFee(groupTotal, commissions) : 0;
+    let couponDiscount = 0;
+    const appliedDiscounts = [];
+    const groupCouponCodes = new Set();
+    for (const coupon of appliedCoupons) {
+        let couponGroupDiscount = 0;
+        const isSellerScoped = coupon.scope === "seller" && coupon.storeId;
+        if (isSellerScoped) {
+            if (coupon.storeId !== firstItem.storeId)
+                continue;
+            if (coupon.applicableItemIds?.length) {
+                const eligibleTotal = group
+                    .filter(({ item }) => coupon.applicableItemIds.includes(item.itemId))
+                    .reduce((s, { item }) => s + item.price * item.quantity, 0);
+                couponGroupDiscount =
+                    eligibleTotal > 0
+                        ? Math.min(Math.round((eligibleTotal / groupTotal) * coupon.discountAmount * 100) / 100, eligibleTotal)
+                        : 0;
+            }
+            else {
+                couponGroupDiscount = Math.min(coupon.discountAmount, groupTotal);
+            }
+        }
+        else {
+            if (cartSubtotal > 0) {
+                couponGroupDiscount = Math.min(Math.round((groupTotal / cartSubtotal) * coupon.discountAmount * 100) / 100, groupTotal);
+            }
+        }
+        if (couponGroupDiscount > 0) {
+            couponDiscount += couponGroupDiscount;
+            appliedDiscounts.push({
+                code: coupon.code,
+                couponId: coupon.couponId,
+                type: "coupon",
+                discountAmount: couponGroupDiscount,
+                scope: coupon.scope,
+                storeId: coupon.storeId,
+            });
+            if (coupon.couponId) {
+                accumulateCouponUsage(couponUsageAccumulator, coupon.code, coupon.couponId, couponGroupDiscount);
+                groupCouponCodes.add(coupon.code);
+            }
+        }
+    }
+    couponDiscount = Math.min(couponDiscount, groupTotal);
+    const orderTotal = Math.max(0, groupTotal - couponDiscount) + shippingFee + codHandlingFee + (emiSchedule?.surchargeAmount ?? 0);
+    const imageUrls = [
+        ...new Set(group
+            .map(({ product }) => product.mainImage)
+            .filter((url) => typeof url === "string" && url.length > 0)),
+    ];
+    // S-SBUNI-RULES 2026-05-13 — order-doc decoration via rule registry.
+    const lt0 = (group[0].product.listingType ?? "standard");
+    const groupRule = getListingRule(lt0);
+    const extraOrderFields = {
+        ...groupRule.decorateOrderDoc(group[0].item, group[0].product),
+        ...(orderType === "prize-draw"
+            ? { prizeRevealDeadline: computePrizeRevealDeadline(group[0].product) }
+            : {}),
+    };
+    const order = await unitOfWork.orders.create({
+        productId: firstItem.productId,
+        productTitle: firstItem.productTitle,
+        userId: uid,
+        userName,
+        userEmail,
+        quantity: totalQuantity,
+        unitPrice: unitPriceFor(firstItem, firstProduct),
+        totalPrice: orderTotal,
+        currency: firstItem.currency ?? getDefaultCurrency(),
+        storeId: firstItem.storeId || undefined,
+        storeName: firstItem.storeName || undefined,
+        items: orderItems,
+        orderType,
+        offerId: firstItem.offerId ?? undefined,
+        status: adminBypass ? OrderStatusValues.PROCESSING : OrderStatusValues.PENDING,
+        paymentStatus: adminBypass ? PaymentStatusValues.PAID : PaymentStatusValues.PENDING,
+        paymentMethod: adminBypass ? PaymentMethodValues.ADMIN_BYPASS : paymentMethod,
+        paymentId: adminBatchId,
+        adminBypassBy: adminBypassBy,
+        shippingAddress,
+        notes,
+        shippingFee: shippingFee > 0 ? shippingFee : undefined,
+        depositAmount: adminBypass ? undefined : depositAmount,
+        codRemainingAmount: adminBypass ? undefined : codRemainingAmount,
+        codHandlingFee: !adminBypass && codHandlingFee > 0 ? codHandlingFee : undefined,
+        emiEnabled: !adminBypass && !!emiSchedule ? true : undefined,
+        emiTenureMonths: !adminBypass && emiSchedule ? emiTenureMonths : undefined,
+        emiTokenAmount: !adminBypass ? emiSchedule?.tokenAmount : undefined,
+        emiSurchargeAmount: !adminBypass ? emiSchedule?.surchargeAmount : undefined,
+        emiInstallments: !adminBypass && emiSchedule
+            ? emiSchedule.installments.map((i) => ({ index: i.index, dueDate: i.dueDate, amount: i.amount, status: "pending" }))
+            : undefined,
+        emiRemainingBalance: !adminBypass ? emiSchedule?.remainingBalance : undefined,
+        emiComplete: !adminBypass && emiSchedule ? false : undefined,
+        couponCode: appliedDiscounts[0]?.code,
+        couponDiscount: couponDiscount > 0 ? couponDiscount : undefined,
+        appliedDiscounts: appliedDiscounts.length > 0 ? appliedDiscounts : undefined,
+        imageUrls: imageUrls.length > 0 ? imageUrls : undefined,
+        ...extraOrderFields,
+    });
+    orderIds.push(order.id);
+    // SB-UNI-N — claim a digital code for digital-code orders (fire-and-forget,
+    // order is already persisted so a claim failure is logged, not thrown).
+    if ((group[0]?.product?.listingType ?? "standard") === "digital-code") {
+        claimDigitalCodeForOrder(getAdminDb(), firstItem.productId, order.id, uid, {
+            userEmail: userEmail || undefined,
+            userName,
+            productTitle: firstItem.productTitle,
+        }).catch((e) => serverLogger.error("claimDigitalCode", e));
+    }
+    for (const code of groupCouponCodes) {
+        const entry = couponUsageAccumulator.get(code);
+        if (entry)
+            entry.orderIds.push(order.id);
+    }
+    if (userEmail) {
+        emailsToSend.push({
+            to: userEmail,
+            userName,
+            orderId: order.id,
+            productTitle: orderItems.length > 1 ? `${orderItems.length} items` : firstItem.productTitle,
+            quantity: totalQuantity,
+            totalPrice: orderTotal,
+            currency: firstItem.currency ?? getDefaultCurrency(),
+            shippingAddress,
+            paymentMethod,
+            items: orderItems,
+        });
+    }
+    emitOrderPlacedNotifications({
+        orderId: order.id,
+        buyerUid: uid,
+        buyerName: userName,
+        storeOwnerId,
+        productLabel: orderItems.length > 1 ? `${orderItems.length} items` : firstItem.productTitle,
+        paid: adminBypass,
+    });
+    return groupTotal;
+}
 /**
  * Place order(s) from the user's cart in a single Firestore transaction.
  *
@@ -231,9 +429,15 @@ function dispatchOrderConfirmationEmails(emailsToSend) {
  * auth + rate-limiting before calling this and supply the resolved user fields.
  */
 export async function createCheckoutOrderAction(input) {
-    const { userId: uid, userName, userEmail, addressId, paymentMethod, notes, excludedProductIds = [], adminBypass = false, adminBypassBy, } = input;
+    const { userId: uid, userName, userEmail, addressId, paymentMethod, emiTenureMonths, notes, excludedProductIds = [], adminBypass = false, adminBypassBy, } = input;
     const siteSettings = await siteSettingsRepository.getSingleton();
     const commissions = siteSettings?.commissions ?? CHECKOUT_DEFAULT_COMMISSIONS;
+    const emiSettings = siteSettings?.emi ?? CHECKOUT_DEFAULT_EMI_SETTINGS;
+    if (paymentMethod === "emi") {
+        if (!emiTenureMonths || !emiSettings.tenureOptions.includes(emiTenureMonths)) {
+            throw new ValidationError(`emiTenureMonths must be one of: ${emiSettings.tenureOptions.join(", ")}`);
+        }
+    }
     // W1-43 — enforce COD toggle.
     if (!adminBypass &&
         paymentMethod === "cod" &&
@@ -440,178 +644,29 @@ export async function createCheckoutOrderAction(input) {
     const orderIds = [];
     let total = 0;
     const emailsToSend = [];
-    // SB-UNI-5 2026-05-13 — bundle cart-lines use item.price (locked bundle
-    // price at add-time); regular lines use product.price (current Firestore).
-    // This prevents stale cart-cached prices from being charged on COD/UPI orders.
-    const unitPriceFor = (item, product) => item.bundleCategorySlug && item.bundleProductIds?.length
-        ? item.price
-        : product.price;
     const cartSubtotal = orderGroups.reduce((s, { items: g }) => s + g.reduce((gs, { item, product }) => gs + unitPriceFor(item, product) * item.quantity, 0), 0);
     const couponUsageAccumulator = new Map();
+    const groupCtx = {
+        paymentMethod,
+        emiTenureMonths,
+        emiSettings,
+        commissions,
+        appliedCoupons,
+        cartSubtotal,
+        couponUsageAccumulator,
+        uid,
+        userName,
+        userEmail,
+        shippingAddress,
+        notes,
+        adminBypass,
+        adminBypassBy,
+        adminBatchId,
+        orderIds,
+        emailsToSend,
+    };
     for (const { items: group, orderType } of orderGroups) {
-        const firstItem = group[0].item;
-        const firstProduct = group[0].product;
-        const groupTotal = group.reduce((sum, { item, product }) => sum + unitPriceFor(item, product) * item.quantity, 0);
-        total += groupTotal;
-        // S-SBUNI-RULES 2026-05-13 — order-item decoration via rule registry.
-        const orderItems = group.map(({ item, product }) => {
-            const lt = (product.listingType ?? "standard");
-            const itemRule = getListingRule(lt);
-            // SB-UNI-5 2026-05-13 — forward bundle identifiers so the order-detail
-            // UI can collapse expanded lines back under a "Bundle: <name>" header.
-            const bundleFields = item.bundleCategorySlug && item.bundleProductIds
-                ? {
-                    bundleCategorySlug: item.bundleCategorySlug,
-                    bundleProductIds: item.bundleProductIds,
-                }
-                : {};
-            const unitPrice = unitPriceFor(item, product);
-            const baseLine = {
-                productId: item.productId,
-                productTitle: item.productTitle,
-                quantity: item.quantity,
-                unitPrice,
-                totalPrice: unitPrice * item.quantity,
-                ...bundleFields,
-            };
-            return itemRule.decorateOrderItem(baseLine, product);
-        });
-        const totalQuantity = group.reduce((sum, { item }) => sum + item.quantity, 0);
-        const { shippingFee, storeOwnerId } = await resolveShippingCost(firstItem.storeId, groupTotal, commissions);
-        const isCodLike = paymentMethod === "cod" || paymentMethod === "upi_manual" || paymentMethod === "cash";
-        const depositAmount = isCodLike
-            ? Math.round(groupTotal * (commissions.codDepositPercent / 100) * 100) / 100
-            : undefined;
-        const codRemainingAmount = isCodLike
-            ? Math.round((groupTotal - (depositAmount ?? 0)) * 100) / 100
-            : undefined;
-        let couponDiscount = 0;
-        const appliedDiscounts = [];
-        const groupCouponCodes = new Set();
-        for (const coupon of appliedCoupons) {
-            let couponGroupDiscount = 0;
-            const isSellerScoped = coupon.scope === "seller" && coupon.storeId;
-            if (isSellerScoped) {
-                if (coupon.storeId !== firstItem.storeId)
-                    continue;
-                if (coupon.applicableItemIds?.length) {
-                    const eligibleTotal = group
-                        .filter(({ item }) => coupon.applicableItemIds.includes(item.itemId))
-                        .reduce((s, { item }) => s + item.price * item.quantity, 0);
-                    couponGroupDiscount =
-                        eligibleTotal > 0
-                            ? Math.min(Math.round((eligibleTotal / groupTotal) * coupon.discountAmount * 100) / 100, eligibleTotal)
-                            : 0;
-                }
-                else {
-                    couponGroupDiscount = Math.min(coupon.discountAmount, groupTotal);
-                }
-            }
-            else {
-                if (cartSubtotal > 0) {
-                    couponGroupDiscount = Math.min(Math.round((groupTotal / cartSubtotal) * coupon.discountAmount * 100) / 100, groupTotal);
-                }
-            }
-            if (couponGroupDiscount > 0) {
-                couponDiscount += couponGroupDiscount;
-                appliedDiscounts.push({
-                    code: coupon.code,
-                    couponId: coupon.couponId,
-                    type: "coupon",
-                    discountAmount: couponGroupDiscount,
-                    scope: coupon.scope,
-                    storeId: coupon.storeId,
-                });
-                if (coupon.couponId) {
-                    accumulateCouponUsage(couponUsageAccumulator, coupon.code, coupon.couponId, couponGroupDiscount);
-                    groupCouponCodes.add(coupon.code);
-                }
-            }
-        }
-        couponDiscount = Math.min(couponDiscount, groupTotal);
-        const orderTotal = Math.max(0, groupTotal - couponDiscount) + shippingFee;
-        const imageUrls = [
-            ...new Set(group
-                .map(({ product }) => product.mainImage)
-                .filter((url) => typeof url === "string" && url.length > 0)),
-        ];
-        // S-SBUNI-RULES 2026-05-13 — order-doc decoration via rule registry.
-        const lt0 = (group[0].product.listingType ?? "standard");
-        const groupRule = getListingRule(lt0);
-        const extraOrderFields = {
-            ...groupRule.decorateOrderDoc(group[0].item, group[0].product),
-            ...(orderType === "prize-draw"
-                ? { prizeRevealDeadline: computePrizeRevealDeadline(group[0].product) }
-                : {}),
-        };
-        const order = await unitOfWork.orders.create({
-            productId: firstItem.productId,
-            productTitle: firstItem.productTitle,
-            userId: uid,
-            userName,
-            userEmail,
-            quantity: totalQuantity,
-            unitPrice: unitPriceFor(firstItem, firstProduct),
-            totalPrice: orderTotal,
-            currency: firstItem.currency ?? getDefaultCurrency(),
-            storeId: firstItem.storeId || undefined,
-            storeName: firstItem.storeName || undefined,
-            items: orderItems,
-            orderType,
-            offerId: firstItem.offerId ?? undefined,
-            status: adminBypass ? OrderStatusValues.PROCESSING : OrderStatusValues.PENDING,
-            paymentStatus: adminBypass ? PaymentStatusValues.PAID : PaymentStatusValues.PENDING,
-            paymentMethod: adminBypass ? PaymentMethodValues.ADMIN_BYPASS : paymentMethod,
-            paymentId: adminBatchId,
-            adminBypassBy: adminBypassBy,
-            shippingAddress,
-            notes,
-            shippingFee: shippingFee > 0 ? shippingFee : undefined,
-            depositAmount: adminBypass ? undefined : depositAmount,
-            codRemainingAmount: adminBypass ? undefined : codRemainingAmount,
-            couponCode: appliedDiscounts[0]?.code,
-            couponDiscount: couponDiscount > 0 ? couponDiscount : undefined,
-            appliedDiscounts: appliedDiscounts.length > 0 ? appliedDiscounts : undefined,
-            imageUrls: imageUrls.length > 0 ? imageUrls : undefined,
-            ...extraOrderFields,
-        });
-        orderIds.push(order.id);
-        // SB-UNI-N — claim a digital code for digital-code orders (fire-and-forget,
-        // order is already persisted so a claim failure is logged, not thrown).
-        if ((group[0]?.product?.listingType ?? "standard") === "digital-code") {
-            claimDigitalCodeForOrder(getAdminDb(), firstItem.productId, order.id, uid, {
-                userEmail: userEmail || undefined,
-                userName,
-                productTitle: firstItem.productTitle,
-            }).catch((e) => serverLogger.error("claimDigitalCode", e));
-        }
-        for (const code of groupCouponCodes) {
-            const entry = couponUsageAccumulator.get(code);
-            if (entry)
-                entry.orderIds.push(order.id);
-        }
-        if (userEmail) {
-            emailsToSend.push({
-                to: userEmail,
-                userName,
-                orderId: order.id,
-                productTitle: orderItems.length > 1 ? `${orderItems.length} items` : firstItem.productTitle,
-                quantity: totalQuantity,
-                totalPrice: orderTotal,
-                currency: firstItem.currency ?? getDefaultCurrency(),
-                shippingAddress,
-                paymentMethod,
-                items: orderItems,
-            });
-        }
-        emitOrderPlacedNotifications({
-            orderId: order.id,
-            buyerUid: uid,
-            buyerName: userName,
-            storeOwnerId,
-            productLabel: orderItems.length > 1 ? `${orderItems.length} items` : firstItem.productTitle,
-            paid: adminBypass,
-        });
+        total += await createOrderForGroup(group, orderType, groupCtx);
     }
     await flushCouponUsageAccumulator(couponUsageAccumulator, uid);
     grantConsentOtpBypassCredit(db, uid, emailOtpUsed, unavailable.length);
@@ -821,13 +876,7 @@ export async function verifyAndPlaceRazorpayOrderAction(input) {
             const sellerUser = storeOwnerId ? await userRepository.findById(storeOwnerId) : null;
             const shippingConfig = sellerUser?.shippingConfig;
             if (shippingConfig?.isConfigured) {
-                if (shippingConfig.method === "custom") {
-                    shippingFee = shippingConfig.customShippingPrice ?? 0;
-                }
-                else if (shippingConfig.method === "shiprocket") {
-                    const percentFee = groupTotal * (commissions.platformShippingPercent / 100);
-                    shippingFee = Math.max(percentFee, commissions.platformShippingFixedMin);
-                }
+                shippingFee = shippingConfig.customShippingPrice ?? 0;
             }
         }
         let couponDiscount = 0;

package/dist/_internal/server/functions/scheduled.d.ts

@@ -19,4 +19,5 @@ export declare const prizeRevealClose: import("./types").ScheduledFunctionDefini
 export declare const prizeRevealExpiry: import("./types").ScheduledFunctionDefinition;
 export declare const prizeRevealReminder: import("./types").ScheduledFunctionDefinition;
 export declare const bundleStockSync: import("./types").ScheduledFunctionDefinition;
-export declare const SCHEDULED_FUNCTIONS: readonly [import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition];
+export declare const emiInstallmentReminder: import("./types").ScheduledFunctionDefinition;
+export declare const SCHEDULED_FUNCTIONS: readonly [import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition, import("./types").ScheduledFunctionDefinition];

package/dist/_internal/server/functions/scheduled.js

@@ -1,6 +1,6 @@
 // Scheduled function definitions (Cloud Scheduler triggers).
 // Cron syntax accepts both Firebase shorthand and standard cron expressions.
-import { auctionSettlementHandler, autoPayoutEligibilityHandler, bundleStockSyncHandler, cartPruneHandler, cleanupRtdbEventsHandler, countersReconcileHandler, couponExpiryHandler, dailyDataCleanupHandler, draftPruneHandler, mediaTmpCleanupHandler, notificationPruneHandler, offerExpiryHandler, payoutBatchHandler, pendingOrderTimeoutHandler, positionsReconcileHandler, prizeRevealCloseHandler, prizeRevealExpiryHandler, prizeRevealOpenHandler, prizeRevealReminderHandler, productStatsSyncHandler, weeklyPayoutEligibilityHandler, } from "../jobs/handlers";
+import { auctionSettlementHandler, autoPayoutEligibilityHandler, bundleStockSyncHandler, cartPruneHandler, cleanupRtdbEventsHandler, countersReconcileHandler, couponExpiryHandler, dailyDataCleanupHandler, draftPruneHandler, emiInstallmentReminderHandler, mediaTmpCleanupHandler, notificationPruneHandler, offerExpiryHandler, payoutBatchHandler, pendingOrderTimeoutHandler, positionsReconcileHandler, prizeRevealCloseHandler, prizeRevealExpiryHandler, prizeRevealOpenHandler, prizeRevealReminderHandler, productStatsSyncHandler, weeklyPayoutEligibilityHandler, } from "../jobs/handlers";
 import { defineFunction } from "./define";
 const REGION = "asia-south1";
 const EVERY_5_MIN = "every 5 minutes";
@@ -151,6 +151,13 @@ export const bundleStockSync = defineFunction({
     handler: bundleStockSyncHandler,
     options: { region: REGION, timeoutSeconds: 540, memory: "256MiB", maxInstances: 1 },
 });
+export const emiInstallmentReminder = defineFunction({
+    name: "emiInstallmentReminder",
+    description: "Nudge buyers on upcoming EMI installments and flag overdue ones (daily 09:00 IST).",
+    trigger: { kind: "schedule", cron: "0 9 * * *", timeZone: "Asia/Kolkata" },
+    handler: emiInstallmentReminderHandler,
+    options: { region: REGION, timeoutSeconds: 300, memory: "256MiB", maxInstances: 1 },
+});
 export const SCHEDULED_FUNCTIONS = [
     auctionSettlement,
     pendingOrderTimeout,
@@ -173,4 +180,5 @@ export const SCHEDULED_FUNCTIONS = [
     prizeRevealExpiry,
     prizeRevealReminder,
     bundleStockSync,
+    emiInstallmentReminder,
 ];

package/dist/_internal/server/jobs/core/autoPayoutEligibility.js

@@ -1,10 +1,8 @@
-import { orderRepository, payoutRepository, storeRepository, userRepository, } from "../../../../repositories";
+import { orderRepository, payoutRepository, storeRepository, userRepository, siteSettingsRepository, } from "../../../../repositories";
 import { getDefaultCurrency } from "../../../../core/index";
+import { computePayoutDeduction } from "../../../shared/fees/calculator";
 import { BATCH_LIMIT } from "../handlers/messages";
 const AUTO_PAYOUT_WINDOW_DAYS = 7;
-const PLATFORM_COMMISSION_RATE = 0.05;
-const GATEWAY_FEE_RATE = 0.0236;
-const GST_RATE = 0.18;
 function getBusinessDayCutoff(daysAgo) {
     const now = new Date();
     const cutoff = new Date(now);
@@ -20,6 +18,8 @@ export async function runAutoPayoutEligibility(ctx) {
     ctx.logger.info("Starting daily auto-payout eligibility sweep", {
         windowDays: AUTO_PAYOUT_WINDOW_DAYS,
     });
+    const siteSettings = await siteSettingsRepository.getSingleton();
+    const commissions = siteSettings.commissions;
     const cutoff = getBusinessDayCutoff(AUTO_PAYOUT_WINDOW_DAYS);
     const eligible = await orderRepository.getEligibleAutomatic(cutoff);
     if (eligible.length === 0) {
@@ -49,10 +49,7 @@ export async function runAutoPayoutEligibility(ctx) {
         }
         const sellerId = store.ownerId;
         const grossAmount = orders.reduce((sum, o) => sum + (o.data.totalPrice ?? 0), 0);
-        const platformFee = Math.round(grossAmount * PLATFORM_COMMISSION_RATE * 100) / 100;
-        const gatewayFee = Math.round(grossAmount * GATEWAY_FEE_RATE * 100) / 100;
-        const gstAmount = Math.round(platformFee * GST_RATE * 100) / 100;
-        const netAmount = Math.round((grossAmount - platformFee - gatewayFee - gstAmount) * 100) / 100;
+        const { platformFee, gatewayFee, gstOnFee: gstAmount, netAmount } = computePayoutDeduction(grossAmount, commissions);
         const payoutInput = {
             storeId,
             sellerName: (seller.displayName ?? seller.email ?? sellerId),
@@ -61,11 +58,11 @@ export async function runAutoPayoutEligibility(ctx) {
             amount: netAmount,
             grossAmount,
             platformFee,
-            platformFeeRate: PLATFORM_COMMISSION_RATE,
+            platformFeeRate: commissions.platformFeePercent / 100,
             gatewayFee,
-            gatewayFeeRate: GATEWAY_FEE_RATE,
+            gatewayFeeRate: (commissions.gatewayFeePercent ?? 0) / 100,
             gstAmount,
-            gstRate: GST_RATE,
+            gstRate: commissions.gstPercent / 100,
             isAutomatic: true,
             currency: getDefaultCurrency(),
             status: "pending",

package/dist/_internal/server/jobs/core/emiInstallmentReminder.d.ts

@@ -0,0 +1,8 @@
+import type { JobContext } from "../runtime/types";
+/**
+ * EMI reminder sweep — nudges buyers ahead of an upcoming installment due
+ * date and flips overdue-but-unpaid installments to `status: "overdue"`.
+ * `reminderSentAt` gates re-notification so a buyer isn't paged on every
+ * sweep run for the same installment.
+ */
+export declare function runEmiInstallmentReminder(ctx: JobContext): Promise<void>;