@wtree/payload-ecommerce-coupon 3.79.0 → 3.79.3

package/dist/index.mjs

@@ -87,14 +87,14 @@ const createCouponsCollection = (pluginConfig) => {
 				type: "number",
 				required: true,
 				admin: {
-					description: `If percentage, 10 = 10%. If fixed, interpreted in ${defaultCurrency} (smallest currency units)`,
+					description: `If percentage, 10 means 10% (must be 0–100). If fixed, amount in ${defaultCurrency} with up to 2 decimal places (e.g. 10.99).`,
 					step: .01
 				}
 			},
 			{
 				name: "maxDiscountAmount",
 				type: "number",
-				admin: { description: `Maximum discount amount in ${defaultCurrency} (smallest currency unit). Leave empty for no cap.` }
+				admin: { description: `Maximum discount in ${defaultCurrency} (major units, e.g. 20.00). Leave empty for no cap.` }
 			},
 			{
 				name: "usageLimit",
@@ -119,12 +119,12 @@ const createCouponsCollection = (pluginConfig) => {
 			{
 				name: "minOrderValue",
 				type: "number",
-				admin: { description: `Minimum order value required in ${defaultCurrency} (smallest currency units)` }
+				admin: { description: `Minimum cart subtotal in ${defaultCurrency} (major units, e.g. 50.00)` }
 			},
 			{
 				name: "maxOrderValue",
 				type: "number",
-				admin: { description: `Maximum order value allowed in ${defaultCurrency} (smallest currency units)` }
+				admin: { description: `Maximum cart subtotal allowed in ${defaultCurrency} (major units, e.g. 500.00)` }
 			},
 			{
 				name: "usageCount",
@@ -151,6 +151,10 @@ const createCouponsCollection = (pluginConfig) => {
 					data.code = data.code.trim();
 					data.normalizedCode = data.code.toUpperCase();
 				}
+				if (data?.type === "percentage" && typeof data.value === "number") {
+					if (data.value < 0 || data.value > 100) throw new APIError("Percentage coupon value must be between 0 and 100", 400);
+				}
+				if (data?.type === "fixed" && typeof data.value === "number" && data.value < 0) throw new APIError("Fixed coupon value must be non-negative", 400);
 				return data;
 			}],
 			beforeChange: [({ operation, req, data }) => {
@@ -706,6 +710,12 @@ const createReferralProgramsCollection = (pluginConfig) => {
 		timestamps: true
 	};
 };
+function minorToMajor2dp(minor) {
+	return Math.round(minor) / 100;
+}
+function majorToMinor2dp(major) {
+	return Math.round(major * 100);
+}
 function normalizeCurrencyCode(currencyCode) {
 	if (!currencyCode) return "AED";
 	return currencyCode.toUpperCase();
@@ -771,7 +781,7 @@ function calculateCouponDiscount({ coupon, cartTotal }) {
 	}
 	return fromCents(discountCents);
 }
-function relationId$5(value) {
+function relationId$4(value) {
 	if (value == null) return null;
 	if (typeof value === "string" || typeof value === "number") return value;
 	if (typeof value === "object" && (typeof value.id === "string" || typeof value.id === "number")) return value.id;
@@ -780,7 +790,7 @@ function relationId$5(value) {
 const allowedCommissionTypesSet = (allowed) => new Set((allowed && allowed.length ? allowed : ["fixed", "percentage"]).map((v) => v));
 function normalizeIds(values) {
 	if (!Array.isArray(values)) return [];
-	return values.map(relationId$5).filter((v) => v != null);
+	return values.map(relationId$4).filter((v) => v != null);
 }
 function getRuleSplits(rule) {
 	const partnerRaw = typeof rule.partnerSplit === "number" ? rule.partnerSplit : typeof rule.referrerSplit === "number" ? rule.referrerSplit : null;
@@ -894,21 +904,21 @@ function calculateItemRewardByRule({ rule, itemTotalCents, quantity, allowedTota
 }
 function getItemCategoryIds(item) {
 	const productCategories = Array.isArray(item?.product?.categories) ? normalizeIds(item.product.categories) : [];
-	const singleCategory = relationId$5(item?.category ?? item?.product?.category);
+	const singleCategory = relationId$4(item?.category ?? item?.product?.category);
 	return [...productCategories, ...singleCategory != null ? [singleCategory] : []];
 }
 function getItemTagIds(item) {
 	return Array.isArray(item?.product?.tags) ? normalizeIds(item.product.tags) : [];
 }
-function selectBestRuleForItem({ rules, item, itemTotalCents, quantity, cartTotalCents, minOrderAmountCents, allowedTotalCommissionTypes }) {
+function selectBestRuleForItem({ rules, item, itemTotalCents, quantity, cartTotalCents, allowedTotalCommissionTypes }) {
 	const allowedTypes = allowedCommissionTypesSet(allowedTotalCommissionTypes);
 	const eligibleRules = rules.filter((rule) => {
 		if (!(rule?.totalCommission?.type ? allowedTypes.has(rule.totalCommission.type) : true)) return false;
-		const resolvedMinCents = minOrderAmountCents != null && Number.isFinite(minOrderAmountCents) ? minOrderAmountCents : typeof rule?.minOrderAmount === "number" && Number.isFinite(rule.minOrderAmount) ? toCents(rule.minOrderAmount) : null;
+		const resolvedMinCents = typeof rule?.minOrderAmount === "number" && rule?.minOrderAmount ? toCents(rule.minOrderAmount) : null;
 		if (resolvedMinCents != null) return cartTotalCents >= resolvedMinCents;
 		return true;
 	});
-	const productId = relationId$5(item.product);
+	const productId = relationId$4(item.product);
 	const itemCategoryIds = new Set(getItemCategoryIds(item));
 	const itemTagIds = new Set(getItemTagIds(item));
 	const candidates = [
@@ -973,27 +983,32 @@ function getProgramMinimumOrderAmount({ program, allowedTotalCommissionTypes })
 /**
 * Calculate total partner commission and customer discount for a cart.
 *
-* All monetary inputs are in NORMAL CURRENCY.
-* Returns results in NORMAL CURRENCY (2 dp).
+* By default, cart line prices and `cartTotal` are **major** currency (e.g. 10.50 = $10.50).
+* When `cartAmountsInMinorUnits` is true, `cartTotal` and line unit prices are **minor**
+* (Payload ecommerce); results are returned in minor units in that mode.
 */
-function calculateCommissionAndDiscount({ cartItems, program, currencyCode = "AED", cartTotal = 0, allowedTotalCommissionTypes }) {
+function calculateCommissionAndDiscount({ cartItems, program, currencyCode = "AED", cartTotal = 0, allowedTotalCommissionTypes, cartAmountsInMinorUnits = false }) {
 	const rules = Array.isArray(program?.commissionRules) ? program.commissionRules : [];
 	if (!rules.length) return {
 		partnerCommission: 0,
 		customerDiscount: 0
 	};
-	const cartTotalCents = toCents(cartTotal);
-	const programMinOrderAmountCents = typeof program?.minOrderAmount === "number" && Number.isFinite(program.minOrderAmount) ? toCents(program.minOrderAmount) : null;
+	const cartTotalCents = toCents(cartAmountsInMinorUnits ? minorToMajor2dp(cartTotal) : cartTotal);
+	if (typeof program?.minOrderAmount === "number" && Number.isFinite(program.minOrderAmount) && toCents(program.minOrderAmount) > 0 && cartTotalCents < toCents(program.minOrderAmount)) return {
+		partnerCommission: 0,
+		customerDiscount: 0
+	};
+	const toMajorUnitPrice = (raw) => cartAmountsInMinorUnits ? minorToMajor2dp(raw) : raw;
 	let totalPartnerCents = 0;
 	let totalCustomerCents = 0;
 	for (const item of cartItems) {
 		const product = typeof item.product === "object" ? item.product : {};
-		const itemPriceCurrency = getCartItemUnitPrice({
+		const itemPriceCurrency = toMajorUnitPrice(getCartItemUnitPrice({
 			item,
 			product,
 			variant: typeof item.variant === "object" ? item.variant : {},
 			currencyCode
-		});
+		}));
 		const quantity = item.quantity ?? 1;
 		const itemTotalCents = toCents(itemPriceCurrency) * quantity;
 		const bestMatch = selectBestRuleForItem({
@@ -1005,7 +1020,6 @@ function calculateCommissionAndDiscount({ cartItems, program, currencyCode = "AE
 			itemTotalCents,
 			quantity,
 			cartTotalCents,
-			minOrderAmountCents: programMinOrderAmountCents,
 			allowedTotalCommissionTypes
 		});
 		if (!bestMatch) continue;
@@ -1016,10 +1030,96 @@ function calculateCommissionAndDiscount({ cartItems, program, currencyCode = "AE
 	const maxCustomerCents = typeof program?.maxCustomerDiscountPerOrder === "number" && Number.isFinite(program.maxCustomerDiscountPerOrder) ? toCents(program.maxCustomerDiscountPerOrder) : null;
 	if (maxPartnerCents != null) totalPartnerCents = Math.min(totalPartnerCents, maxPartnerCents);
 	if (maxCustomerCents != null) totalCustomerCents = Math.min(totalCustomerCents, maxCustomerCents);
+	const partnerMajor = fromCents(totalPartnerCents);
+	const customerMajor = fromCents(totalCustomerCents);
+	if (cartAmountsInMinorUnits) return {
+		partnerCommission: majorToMinor2dp(partnerMajor),
+		customerDiscount: majorToMinor2dp(customerMajor)
+	};
 	return {
-		partnerCommission: fromCents(totalPartnerCents),
-		customerDiscount: fromCents(totalCustomerCents)
+		partnerCommission: partnerMajor,
+		customerDiscount: customerMajor
+	};
+}
+//#endregion
+//#region src/utilities/couponDebug.ts
+/**
+* Set DEBUG_COUPON_CART=1 in the environment to log coupon/cart recalculation details
+* (server console + Payload logger when available).
+*/
+function isCouponCartDebugEnabled() {
+	try {
+		return process.env.DEBUG_COUPON_CART === "1" || process.env.DEBUG_COUPON_CART === "true";
+	} catch {
+		return false;
+	}
+}
+function logCouponCartDebug(label, data, req) {
+	if (!isCouponCartDebugEnabled()) return;
+	const payload = {
+		msg: `[payload-ecommerce-coupon] ${label}`,
+		...data
 	};
+	try {
+		req?.payload?.logger?.info(payload);
+	} catch {}
+	console.log("[payload-ecommerce-coupon]", label, data);
+}
+/** Detailed server console snapshot for coupon relation resolution (DEBUG_COUPON_CART only). */
+function logRecalculateCartCouponSnapshot(ctx, req) {
+	if (!isCouponCartDebugEnabled()) return;
+	const f = ctx.cartAppliedCouponField;
+	const fromData = ctx.mutableData[f];
+	const fromOrig = ctx.original[f];
+	const dataHasOwn = Object.prototype.hasOwnProperty.call(ctx.mutableData, f);
+	const origHasOwn = Object.prototype.hasOwnProperty.call(ctx.original, f);
+	const keys = Object.keys(ctx.mutableData);
+	logCouponCartDebug("recalculateCart: coupon snapshot", {
+		couponField: f,
+		dataHasOwnAppliedCoupon: dataHasOwn,
+		origHasOwnAppliedCoupon: origHasOwn,
+		mutableDataAppliedCoupon: fromData,
+		originalAppliedCoupon: fromOrig,
+		effectiveAppliedCoupon: ctx.effectiveAppliedCoupon,
+		appliedCouponID: ctx.appliedCouponID,
+		mutableDataKeysCount: keys.length,
+		mutableDataKeysSample: keys.slice(0, 45)
+	}, req);
+}
+//#endregion
+//#region src/utilities/applyCouponContext.ts
+/**
+* When `payload.update` is called from the apply-coupon (or referral) endpoint, that
+* handler has already computed the correct discount, commission, and total. Setting
+* this key on `req.context` (with a `SkipRecalculateContext` value) tells
+* `recalculateCart` to skip its own recalculation and pass the data through unchanged,
+* while also restoring the relationship IDs that Payload strips during its merge.
+*/
+const SKIP_COUPON_RECALCULATE_CONTEXT_KEY = "__payloadEcommerceCouponSkipRecalculate";
+//#endregion
+//#region src/utilities/relationId.ts
+function relationId$3(value) {
+	if (value == null) return null;
+	if (typeof value === "bigint") {
+		const n = Number(value);
+		return Number.isSafeInteger(n) ? n : String(value);
+	}
+	if (typeof value === "string" || typeof value === "number") return value;
+	if (typeof value === "object" && value !== null && "id" in value) {
+		const id = value.id;
+		if (id == null) return null;
+		if (typeof id === "bigint") {
+			const n = Number(id);
+			return Number.isSafeInteger(n) ? n : String(id);
+		}
+		if (typeof id === "string" || typeof id === "number") return id;
+	}
+	return null;
+}
+/** Compare two ids that may differ in type (number vs string vs bigint). */
+function idsEqual(a, b) {
+	if (a == null || b == null) return false;
+	return String(a) === String(b);
 }
 //#endregion
 //#region src/utilities/roundTo2.ts
@@ -1031,11 +1131,15 @@ function roundTo2(value) {
 }
 //#endregion
 //#region src/endpoints/applyCoupon.ts
-function relationId$4(value) {
-	if (value == null) return null;
-	if (typeof value === "string" || typeof value === "number") return value;
-	if (typeof value === "object" && (typeof value.id === "string" || typeof value.id === "number")) return value.id;
-	return null;
+function buildReqWithCartSecret(req, secret) {
+	if (!secret || typeof secret !== "string" || secret.trim().length === 0) return req;
+	return {
+		...req,
+		context: {
+			...req.context || {},
+			cartSecret: secret.trim()
+		}
+	};
 }
 function readField$3(doc, field) {
 	if (!doc || typeof doc !== "object") return void 0;
@@ -1097,6 +1201,8 @@ const applyCouponHandler = ({ pluginConfig }) => async (req) => {
 	const cartIDRaw = data?.cartID;
 	const cartID = typeof cartIDRaw === "string" || typeof cartIDRaw === "number" ? cartIDRaw : null;
 	const customerEmail = typeof data?.customerEmail === "string" ? data.customerEmail : void 0;
+	const rawSecret = data?.secret;
+	const reqForCart = buildReqWithCartSecret(req, typeof rawSecret === "string" && rawSecret.trim().length > 0 ? rawSecret.trim() : void 0);
 	const normalizedCode = normalizeCode$1(rawCode);
 	if (!normalizedCode || !cartID) return Response.json({
 		success: false,
@@ -1120,14 +1226,16 @@ const applyCouponHandler = ({ pluginConfig }) => async (req) => {
 		const cart = await payload.findByID({
 			collection: collections.cartsSlug,
 			id: cartID,
-			depth: 2
+			depth: 2,
+			overrideAccess: true,
+			req: reqForCart
 		});
 		if (!cart) return Response.json({
 			success: false,
 			error: "Cart not found"
 		}, { status: 404 });
-		const cartAppliedCoupon = relationId$4(readField$3(cart, fields.cartAppliedCouponField));
-		const cartAppliedReferral = relationId$4(readField$3(cart, fields.cartAppliedReferralCodeField));
+		const cartAppliedCoupon = relationId$3(readField$3(cart, fields.cartAppliedCouponField));
+		const cartAppliedReferral = relationId$3(readField$3(cart, fields.cartAppliedReferralCodeField));
 		if (pluginConfig.referralConfig.singleCodePerCart && (cartAppliedCoupon || cartAppliedReferral)) return Response.json({
 			success: false,
 			error: "A code has already been applied to this cart. Only one code can be used per order."
@@ -1138,7 +1246,8 @@ const applyCouponHandler = ({ pluginConfig }) => async (req) => {
 				cart,
 				cartID,
 				normalizedCode,
-				pluginConfig
+				pluginConfig,
+				reqForCart
 			});
 			if (!referralResult.ok && referralResult.status === 404 && pluginConfig.referralConfig.allowBothSystems && allowCoupon) return await handleCouponCode({
 				payload,
@@ -1146,7 +1255,9 @@ const applyCouponHandler = ({ pluginConfig }) => async (req) => {
 				cartID,
 				normalizedCode,
 				customerEmail,
-				pluginConfig
+				pluginConfig,
+				req,
+				reqForCart
 			});
 			return referralResult;
 		}
@@ -1160,7 +1271,9 @@ const applyCouponHandler = ({ pluginConfig }) => async (req) => {
 			cartID,
 			normalizedCode,
 			customerEmail,
-			pluginConfig
+			pluginConfig,
+			req,
+			reqForCart
 		});
 	} catch (error) {
 		console.error("Code application error:", error);
@@ -1170,9 +1283,10 @@ const applyCouponHandler = ({ pluginConfig }) => async (req) => {
 		}, { status: 500 });
 	}
 };
-async function handleCouponCode({ payload, cart, cartID, normalizedCode, customerEmail, pluginConfig }) {
+async function handleCouponCode({ payload, cart, cartID, normalizedCode, customerEmail, pluginConfig, req, reqForCart }) {
 	const fields = pluginConfig.integration.fields;
 	const resolvers = pluginConfig.integration.resolvers;
+	const cartMinor = pluginConfig.integration?.cartAmountsInMinorUnits === true;
 	const coupon = await findByNormalizedCode$1({
 		payload,
 		collection: pluginConfig.collections.couponsSlug,
@@ -1216,34 +1330,85 @@ async function handleCouponCode({ payload, cart, cartID, normalizedCode, custome
 			error: "You have reached the maximum uses for this coupon."
 		}, { status: 400 });
 	}
-	if (relationId$4(readField$3(cart, fields.cartAppliedCouponField)) === coupon.id) return Response.json({
+	if (idsEqual(relationId$3(readField$3(cart, fields.cartAppliedCouponField)), coupon.id)) return Response.json({
 		success: false,
 		error: "Coupon already applied to this cart"
 	}, { status: 400 });
-	const cartSubtotal = Number(resolvers.getCartSubtotal(cart)) || 0;
-	const cartTotal = Number(resolvers.getCartTotal(cart)) || cartSubtotal || 0;
-	if (coupon.minOrderValue && cartSubtotal < coupon.minOrderValue) return Response.json({
+	const referralOnCart = relationId$3(readField$3(cart, fields.cartAppliedReferralCodeField)) != null;
+	if (pluginConfig.enableReferrals && !pluginConfig.referralConfig.allowBothSystems && referralOnCart) {
+		logCouponCartDebug("applyCoupon: rejected — referral on cart (allowBothSystems=false)", {
+			cartID,
+			referralOnCart,
+			couponId: coupon.id
+		}, req);
+		return Response.json({
+			success: false,
+			error: "A referral code is already applied to this cart. Remove it before applying a coupon."
+		}, { status: 400 });
+	}
+	const cartSubtotalRaw = Number(resolvers.getCartSubtotal(cart)) || 0;
+	const cartSubtotalMajor = cartMinor ? minorToMajor2dp(cartSubtotalRaw) : cartSubtotalRaw;
+	const cartTotalRaw = Number(resolvers.getCartTotal(cart)) || cartSubtotalRaw || 0;
+	if (coupon.minOrderValue && cartSubtotalMajor < coupon.minOrderValue) return Response.json({
 		success: false,
 		error: `Minimum order value of ${coupon.minOrderValue} ${pluginConfig.defaultCurrency} required`
 	}, { status: 400 });
-	if (coupon.maxOrderValue && cartSubtotal > coupon.maxOrderValue) return Response.json({
+	if (coupon.maxOrderValue && cartSubtotalMajor > coupon.maxOrderValue) return Response.json({
 		success: false,
 		error: `Maximum order value of ${coupon.maxOrderValue} ${pluginConfig.defaultCurrency} exceeded`
 	}, { status: 400 });
-	const discountAmount = calculateCouponDiscount({
+	const discountMajor = calculateCouponDiscount({
 		coupon,
-		cartTotal: cartSubtotal
+		cartTotal: cartSubtotalMajor
 	});
-	const nextTotal = roundTo2(Math.max(0, cartTotal - discountAmount));
+	const discountAmount = cartMinor ? majorToMinor2dp(discountMajor) : discountMajor;
+	const nextTotal = cartMinor ? Math.max(0, Math.round(cartTotalRaw) - Math.round(discountAmount)) : roundTo2(Math.max(0, cartTotalRaw - discountAmount));
 	const data = {};
 	writeField$1(data, fields.cartAppliedCouponField, coupon.id);
 	writeField$1(data, fields.cartDiscountAmountField, discountAmount);
 	writeField$1(data, fields.cartTotalField, nextTotal);
+	reqForCart.context = {
+		...reqForCart.context || {},
+		[SKIP_COUPON_RECALCULATE_CONTEXT_KEY]: { couponId: coupon.id }
+	};
 	await payload.update({
 		collection: pluginConfig.integration.collections.cartsSlug,
 		id: cartID,
-		data
+		data,
+		overrideAccess: true,
+		req: reqForCart
 	});
+	if (isCouponCartDebugEnabled()) try {
+		const cartAfter = await payload.findByID({
+			collection: pluginConfig.integration.collections.cartsSlug,
+			id: cartID,
+			depth: 0,
+			overrideAccess: true,
+			req: reqForCart
+		});
+		console.log("[payload-ecommerce-coupon] applyCoupon: cart after update", {
+			cartID,
+			wroteAppliedCoupon: data[fields.cartAppliedCouponField],
+			appliedCouponOnDoc: readField$3(cartAfter, fields.cartAppliedCouponField),
+			discountAmountOnDoc: readField$3(cartAfter, fields.cartDiscountAmountField),
+			totalOnDoc: readField$3(cartAfter, fields.cartTotalField)
+		});
+	} catch (err) {
+		console.log("[payload-ecommerce-coupon] applyCoupon: cart after update (read failed)", err);
+	}
+	logCouponCartDebug("applyCoupon: success", {
+		cartID,
+		cartMinor,
+		cartSubtotalRaw,
+		cartSubtotalMajor,
+		cartTotalRaw,
+		discountMajor,
+		discountAmount,
+		nextTotal,
+		couponId: coupon.id,
+		couponType: coupon.type,
+		couponValue: coupon.value
+	}, req);
 	return Response.json({
 		success: true,
 		message: "Coupon applied successfully",
@@ -1256,9 +1421,10 @@ async function handleCouponCode({ payload, cart, cartID, normalizedCode, custome
 		currency: pluginConfig.defaultCurrency
 	});
 }
-async function handleReferralCode({ payload, cart, cartID, normalizedCode, pluginConfig }) {
+async function handleReferralCode({ payload, cart, cartID, normalizedCode, pluginConfig, reqForCart }) {
 	const fields = pluginConfig.integration.fields;
 	const resolvers = pluginConfig.integration.resolvers;
+	const cartMinor = pluginConfig.integration?.cartAmountsInMinorUnits === true;
 	const referralCode = await findByNormalizedCode$1({
 		payload,
 		collection: pluginConfig.collections.referralCodesSlug,
@@ -1289,18 +1455,19 @@ async function handleReferralCode({ payload, cart, cartID, normalizedCode, plugi
 		success: false,
 		error: "Referral program is not active"
 	}, { status: 400 });
-	if (relationId$4(readField$3(cart, fields.cartAppliedReferralCodeField)) === referralCode.id) return Response.json({
+	if (idsEqual(relationId$3(readField$3(cart, fields.cartAppliedReferralCodeField)), referralCode.id)) return Response.json({
 		success: false,
 		error: "Referral code already applied to this cart"
 	}, { status: 400 });
 	const cartItems = resolvers.getCartItems(cart);
 	const cartSubtotal = Number(resolvers.getCartSubtotal(cart)) || 0;
+	const cartSubtotalMajor = cartMinor ? minorToMajor2dp(cartSubtotal) : cartSubtotal;
 	const cartTotal = Number(resolvers.getCartTotal(cart)) || cartSubtotal || 0;
 	const minOrderAmount = getProgramMinimumOrderAmount({
 		program,
 		allowedTotalCommissionTypes: pluginConfig.referralConfig.allowedTotalCommissionTypes
 	});
-	if (typeof minOrderAmount === "number" && cartSubtotal < minOrderAmount) return Response.json({
+	if (typeof minOrderAmount === "number" && cartSubtotalMajor < minOrderAmount) return Response.json({
 		success: false,
 		error: `Minimum order value of ${minOrderAmount} ${pluginConfig.defaultCurrency} required for this referral program`
 	}, { status: 400 });
@@ -1309,20 +1476,27 @@ async function handleReferralCode({ payload, cart, cartID, normalizedCode, plugi
 		program,
 		currencyCode: pluginConfig.defaultCurrency,
 		cartTotal: cartSubtotal,
-		allowedTotalCommissionTypes: pluginConfig.referralConfig.allowedTotalCommissionTypes
+		allowedTotalCommissionTypes: pluginConfig.referralConfig.allowedTotalCommissionTypes,
+		cartAmountsInMinorUnits: cartMinor
 	});
 	const roundedPartnerCommission = roundTo2(partnerCommission);
 	const roundedCustomerDiscount = roundTo2(customerDiscount);
-	const nextTotal = roundTo2(Math.max(0, cartTotal - roundedCustomerDiscount));
+	const nextTotal = cartMinor ? Math.max(0, Math.round(cartTotal) - Math.round(roundedCustomerDiscount)) : roundTo2(Math.max(0, cartTotal - roundedCustomerDiscount));
 	const data = {};
 	writeField$1(data, fields.cartAppliedReferralCodeField, referralCode.id);
 	writeField$1(data, fields.cartPartnerCommissionField, roundedPartnerCommission);
 	writeField$1(data, fields.cartCustomerDiscountField, roundedCustomerDiscount);
 	writeField$1(data, fields.cartTotalField, nextTotal);
+	reqForCart.context = {
+		...reqForCart.context || {},
+		[SKIP_COUPON_RECALCULATE_CONTEXT_KEY]: { referralId: referralCode.id }
+	};
 	await payload.update({
 		collection: pluginConfig.integration.collections.cartsSlug,
 		id: cartID,
-		data
+		data,
+		overrideAccess: true,
+		req: reqForCart
 	});
 	return Response.json({
 		success: true,
@@ -1340,7 +1514,7 @@ const applyCouponEndpoint = ({ pluginConfig }) => ({
 });
 //#endregion
 //#region src/endpoints/partnerStats.ts
-function relationId$3(value) {
+function relationId$2(value) {
 	if (value == null) return null;
 	if (typeof value === "string" || typeof value === "number") return value;
 	if (typeof value === "object" && (typeof value.id === "string" || typeof value.id === "number")) return value.id;
@@ -1424,7 +1598,7 @@ const partnerStatsHandler = ({ pluginConfig }) => async (req) => {
 		const conversionRate = totalReferrals > 0 ? successfulReferrals / totalReferrals * 100 : 0;
 		const recentReferrals = [];
 		try {
-			const referralCodeIDs = referralCodes.map((c) => relationId$3(c?.id)).filter((id) => id != null);
+			const referralCodeIDs = referralCodes.map((c) => relationId$2(c?.id)).filter((id) => id != null);
 			if (referralCodeIDs.length > 0) {
 				const ordersQuery = await payload.find({
 					collection: collections.ordersSlug,
@@ -1433,8 +1607,8 @@ const partnerStatsHandler = ({ pluginConfig }) => async (req) => {
 					sort: `-${fields.orderCreatedAtField}`
 				});
 				for (const order of ordersQuery?.docs || []) {
-					const orderReferralID = relationId$3(readField$2(order, fields.orderAppliedReferralCodeField));
-					const matchedCode = referralCodes.find((c) => relationId$3(c?.id) === orderReferralID);
+					const orderReferralID = relationId$2(readField$2(order, fields.orderAppliedReferralCodeField));
+					const matchedCode = referralCodes.find((c) => relationId$2(c?.id) === orderReferralID);
 					const paymentStatus = readField$2(order, fields.orderPaymentStatusField);
 					const createdAt = readField$2(order, fields.orderCreatedAtField);
 					recentReferrals.push({
@@ -1464,7 +1638,7 @@ const partnerStatsHandler = ({ pluginConfig }) => async (req) => {
 		let program = null;
 		if (referralCodes.length > 0) {
 			const firstCode = referralCodes[0];
-			const programID = relationId$3(firstCode?.program);
+			const programID = relationId$2(firstCode?.program);
 			if (programID != null) try {
 				const programData = await payload.findByID({
 					collection: pluginConfig.collections.referralProgramsSlug,
@@ -1517,7 +1691,7 @@ const partnerStatsEndpoint = ({ pluginConfig }) => ({
 });
 //#endregion
 //#region src/endpoints/validateCoupon.ts
-function relationId$2(value) {
+function relationId$1(value) {
 	if (value == null) return null;
 	if (typeof value === "string" || typeof value === "number") return value;
 	if (typeof value === "object" && (typeof value.id === "string" || typeof value.id === "number")) return value.id;
@@ -1622,6 +1796,7 @@ const validateCouponHandler = ({ pluginConfig }) => async (req) => {
 };
 async function validateCouponCode$1({ payload, normalizedCode, cartValue, customerEmail, pluginConfig }) {
 	const fields = pluginConfig.integration.fields;
+	const cartMinor = pluginConfig.integration?.cartAmountsInMinorUnits === true;
 	const couponData = await findByNormalizedCode({
 		payload,
 		collection: pluginConfig.collections.couponsSlug,
@@ -1664,24 +1839,23 @@ async function validateCouponCode$1({ payload, normalizedCode, cartValue, custom
 	if (cartValue !== void 0) {
 		const minOrderValue = couponData.minOrderValue;
 		const maxOrderValue = couponData.maxOrderValue;
-		if (minOrderValue && cartValue < minOrderValue) return Response.json({
+		const cartValueMajor = cartMinor ? minorToMajor2dp(cartValue) : cartValue;
+		if (minOrderValue && cartValueMajor < minOrderValue) return Response.json({
 			success: false,
 			error: `Minimum order value of ${minOrderValue} ${pluginConfig.defaultCurrency} required`
 		}, { status: 400 });
-		if (maxOrderValue && cartValue > maxOrderValue) return Response.json({
+		if (maxOrderValue && cartValueMajor > maxOrderValue) return Response.json({
 			success: false,
 			error: `Maximum order value of ${maxOrderValue} ${pluginConfig.defaultCurrency} exceeded`
 		}, { status: 400 });
 	}
 	let discount = 0;
 	if (cartValue !== void 0) {
-		if (couponData.type === "percentage") {
-			discount = roundTo2(cartValue * couponData.value / 100);
-			if (couponData.maxDiscountAmount != null && discount > couponData.maxDiscountAmount) discount = roundTo2(couponData.maxDiscountAmount);
-		} else if (couponData.type === "fixed") {
-			discount = roundTo2(couponData.value);
-			if (discount > cartValue) discount = roundTo2(cartValue);
-		}
+		const discountMajor = calculateCouponDiscount({
+			coupon: couponData,
+			cartTotal: cartMinor ? minorToMajor2dp(cartValue) : cartValue
+		});
+		discount = cartMinor ? majorToMinor2dp(discountMajor) : discountMajor;
 	}
 	return Response.json({
 		success: true,
@@ -1698,6 +1872,7 @@ async function validateCouponCode$1({ payload, normalizedCode, cartValue, custom
 async function validateReferralCode({ payload, normalizedCode, cartID, pluginConfig }) {
 	const collections = pluginConfig.integration.collections;
 	const resolvers = pluginConfig.integration.resolvers;
+	const cartMinor = pluginConfig.integration?.cartAmountsInMinorUnits === true;
 	const referralData = await findByNormalizedCode({
 		payload,
 		collection: pluginConfig.collections.referralCodesSlug,
@@ -1719,7 +1894,7 @@ async function validateReferralCode({ payload, normalizedCode, cartID, pluginCon
 		success: false,
 		error: "Referral code usage limit exceeded"
 	}, { status: 400 });
-	const programId = relationId$2(referralData.program);
+	const programId = relationId$1(referralData.program);
 	if (programId == null) return Response.json({
 		success: false,
 		error: "Referral program not found"
@@ -1737,12 +1912,13 @@ async function validateReferralCode({ payload, normalizedCode, cartID, pluginCon
 		id: cartID,
 		depth: 2
 	}) : null;
-	const cartTotal = cart ? Number(resolvers.getCartSubtotal(cart)) || Number(resolvers.getCartTotal(cart)) || 0 : 0;
+	const cartSubtotal = cart ? Number(resolvers.getCartSubtotal(cart)) || Number(resolvers.getCartTotal(cart)) || 0 : 0;
+	const cartTotalMajor = cartMinor ? minorToMajor2dp(cartSubtotal) : cartSubtotal;
 	const minOrderAmount = getProgramMinimumOrderAmount({
 		program,
 		allowedTotalCommissionTypes: pluginConfig.referralConfig.allowedTotalCommissionTypes
 	});
-	if (typeof minOrderAmount === "number" && cartTotal < minOrderAmount) return Response.json({
+	if (typeof minOrderAmount === "number" && cartTotalMajor < minOrderAmount) return Response.json({
 		success: false,
 		error: `Minimum order value of ${minOrderAmount} ${pluginConfig.defaultCurrency} required for this referral program`
 	}, { status: 400 });
@@ -1750,17 +1926,19 @@ async function validateReferralCode({ payload, normalizedCode, cartID, pluginCon
 		cartItems: cart ? resolvers.getCartItems(cart) : [],
 		program,
 		currencyCode: pluginConfig.defaultCurrency,
-		cartTotal,
-		allowedTotalCommissionTypes: pluginConfig.referralConfig.allowedTotalCommissionTypes
+		cartTotal: cartSubtotal,
+		allowedTotalCommissionTypes: pluginConfig.referralConfig.allowedTotalCommissionTypes,
+		cartAmountsInMinorUnits: cartMinor
 	});
-	const cappedCustomerDiscount = cartTotal > 0 ? Math.min(customerDiscount, cartTotal) : customerDiscount;
+	const cappedCustomerDiscount = cartSubtotal > 0 ? Math.min(customerDiscount, cartSubtotal) : customerDiscount;
 	const roundedPartnerCommission = roundTo2(partnerCommission);
 	const roundedCustomerDiscount = roundTo2(cappedCustomerDiscount);
+	const displayDiscount = cartMinor ? minorToMajor2dp(roundedCustomerDiscount) : roundedCustomerDiscount;
 	return Response.json({
 		success: true,
 		referralCode: {
 			code: referralData.code,
-			description: `Get ${roundedCustomerDiscount.toFixed(2)} discount with this referral code`
+			description: `Get ${displayDiscount.toFixed(2)} discount with this referral code`
 		},
 		partnerCommission: roundedPartnerCommission,
 		customerDiscount: roundedCustomerDiscount,
@@ -1774,16 +1952,24 @@ const validateCouponEndpoint = ({ pluginConfig }) => ({
 });
 //#endregion
 //#region src/hooks/recalculateCart.ts
-function relationId$1(value) {
-	if (value == null) return null;
-	if (typeof value === "string" || typeof value === "number") return value;
-	if (typeof value === "object" && (typeof value.id === "string" || typeof value.id === "number")) return value.id;
-	return null;
-}
 function readField$1(doc, field) {
 	if (!doc || typeof doc !== "object") return void 0;
 	return doc[field];
 }
+/**
+* Prefer incoming patch when that field is present on `data`; otherwise use `originalDoc`.
+* If the key exists but the value is `undefined` (common with merged Payload update objects),
+* treat it like a missing patch and fall back to `originalDoc`.
+* Explicit `null` still means "clear relation".
+*/
+function effectiveRelationField(mutableData, original, fieldName) {
+	if (Object.prototype.hasOwnProperty.call(mutableData, fieldName)) {
+		const v = readField$1(mutableData, fieldName);
+		if (v === void 0) return readField$1(original, fieldName);
+		return v;
+	}
+	return readField$1(original, fieldName);
+}
 function writeField(doc, field, value) {
 	doc[field] = value;
 }
@@ -1798,6 +1984,24 @@ function clearReferralFields(target, fields) {
 }
 const recalculateCartHook = (pluginConfig) => async ({ data, req, originalDoc }) => {
 	if (!req.payload) return data;
+	const skipCtx = req?.context?.[SKIP_COUPON_RECALCULATE_CONTEXT_KEY];
+	if (skipCtx != null) {
+		const mutableData = data || {};
+		if (typeof skipCtx === "object") {
+			const { couponId, referralId } = skipCtx;
+			const f = pluginConfig.integration?.fields;
+			const couponField = f?.cartAppliedCouponField ?? "appliedCoupon";
+			const referralField = f?.cartAppliedReferralCodeField ?? "appliedReferralCode";
+			if (couponId != null) mutableData[couponField] = couponId;
+			if (referralId != null) mutableData[referralField] = referralId;
+			logCouponCartDebug("recalculateCart: skip flag active — passing through and restoring IDs", {
+				couponId: couponId ?? null,
+				referralId: referralId ?? null
+			}, req);
+		}
+		return mutableData;
+	}
+	const cartMinor = pluginConfig.integration?.cartAmountsInMinorUnits === true;
 	const integration = pluginConfig.integration || {};
 	const collections = integration.collections || {
 		cartsSlug: "carts",
@@ -1872,16 +2076,26 @@ const recalculateCartHook = (pluginConfig) => async ({ data, req, originalDoc })
 	};
 	const mutableData = data || {};
 	const original = originalDoc || {};
+	const rawCurrency = readField$1(mutableData, "currency") ?? readField$1(original, "currency");
+	const cartCurrency = typeof rawCurrency === "string" && rawCurrency.trim().length > 0 ? rawCurrency.trim() : pluginConfig.defaultCurrency;
 	const effectiveItems = readField$1(mutableData, fields.cartItemsField) ?? readField$1(original, fields.cartItemsField) ?? [];
-	const effectiveAppliedReferral = readField$1(mutableData, fields.cartAppliedReferralCodeField) !== void 0 ? readField$1(mutableData, fields.cartAppliedReferralCodeField) : readField$1(original, fields.cartAppliedReferralCodeField);
-	const effectiveAppliedCoupon = readField$1(mutableData, fields.cartAppliedCouponField) !== void 0 ? readField$1(mutableData, fields.cartAppliedCouponField) : readField$1(original, fields.cartAppliedCouponField);
+	const effectiveAppliedReferral = effectiveRelationField(mutableData, original, fields.cartAppliedReferralCodeField);
+	const effectiveAppliedCoupon = effectiveRelationField(mutableData, original, fields.cartAppliedCouponField);
+	const appliedCouponID = relationId$3(effectiveAppliedCoupon);
+	logRecalculateCartCouponSnapshot({
+		cartAppliedCouponField: fields.cartAppliedCouponField,
+		mutableData,
+		original,
+		effectiveAppliedCoupon,
+		appliedCouponID
+	}, req);
 	if (!Array.isArray(effectiveItems) || effectiveItems.length === 0) {
 		clearReferralFields(mutableData, fields);
 		clearCouponFields(mutableData, fields);
 		writeField(mutableData, fields.cartTotalField, 0);
 		return mutableData;
 	}
-	const getRelationID = (value) => relationId$1(value);
+	const getRelationID = (value) => relationId$3(value);
 	const productIds = effectiveItems.map((item) => getRelationID(item?.product)).filter((id) => id != null);
 	let productsMap = /* @__PURE__ */ new Map();
 	if (productIds.length > 0) {
@@ -1901,7 +2115,7 @@ const recalculateCartHook = (pluginConfig) => async ({ data, req, originalDoc })
 			item,
 			product,
 			variant,
-			currencyCode: pluginConfig.defaultCurrency
+			currencyCode: cartCurrency
 		}));
 		const quantity = typeof item?.quantity === "number" && Number.isFinite(item.quantity) ? item.quantity : 1;
 		const safeUnitPrice = Number.isFinite(unitPrice) ? unitPrice : 0;
@@ -1913,10 +2127,11 @@ const recalculateCartHook = (pluginConfig) => async ({ data, req, originalDoc })
 			quantity
 		};
 	});
-	writeField(mutableData, fields.cartSubtotalField, roundTo2(calculatedSubtotal));
+	const subtotalMajor = cartMinor ? minorToMajor2dp(calculatedSubtotal) : calculatedSubtotal;
+	writeField(mutableData, fields.cartSubtotalField, cartMinor ? Math.round(calculatedSubtotal) : roundTo2(calculatedSubtotal));
 	let customerDiscount = 0;
 	let couponDiscount = 0;
-	const appliedReferralID = relationId$1(effectiveAppliedReferral);
+	const appliedReferralID = relationId$3(effectiveAppliedReferral);
 	if (pluginConfig.enableReferrals && appliedReferralID != null) {
 		const referralCode = (await req.payload.find({
 			collection: pluginConfig.collections.referralCodesSlug,
@@ -1926,7 +2141,7 @@ const recalculateCartHook = (pluginConfig) => async ({ data, req, originalDoc })
 		}))?.docs?.[0];
 		if (!referralCode || referralCode.isActive === false) clearReferralFields(mutableData, fields);
 		else {
-			const programId = relationId$1(referralCode.program);
+			const programId = relationId$3(referralCode.program);
 			const program = typeof referralCode.program === "object" ? referralCode.program : programId != null ? await req.payload.findByID({
 				collection: pluginConfig.collections.referralProgramsSlug,
 				id: programId
@@ -1937,14 +2152,15 @@ const recalculateCartHook = (pluginConfig) => async ({ data, req, originalDoc })
 					program,
 					allowedTotalCommissionTypes: pluginConfig.referralConfig.allowedTotalCommissionTypes
 				});
-				if (typeof minOrderAmount === "number" && calculatedSubtotal < minOrderAmount) clearReferralFields(mutableData, fields);
+				if (typeof minOrderAmount === "number" && subtotalMajor < minOrderAmount) clearReferralFields(mutableData, fields);
 				else {
 					const result = calculateCommissionAndDiscount({
 						cartItems: enrichedItems,
 						program,
-						currencyCode: pluginConfig.defaultCurrency,
+						currencyCode: cartCurrency,
 						cartTotal: calculatedSubtotal,
-						allowedTotalCommissionTypes: pluginConfig.referralConfig.allowedTotalCommissionTypes
+						allowedTotalCommissionTypes: pluginConfig.referralConfig.allowedTotalCommissionTypes,
+						cartAmountsInMinorUnits: cartMinor
 					});
 					const roundedPartnerCommission = roundTo2(result.partnerCommission);
 					const roundedCustomerDiscount = roundTo2(Math.max(0, result.customerDiscount));
@@ -1955,39 +2171,97 @@ const recalculateCartHook = (pluginConfig) => async ({ data, req, originalDoc })
 			}
 		}
 	} else if (readField$1(mutableData, fields.cartAppliedReferralCodeField) === null) clearReferralFields(mutableData, fields);
-	const appliedCouponID = relationId$1(effectiveAppliedCoupon);
-	const canUseCouponWithReferral = !pluginConfig.enableReferrals || pluginConfig.referralConfig.allowBothSystems || relationId$1(readField$1(mutableData, fields.cartAppliedReferralCodeField)) == null;
-	if (appliedCouponID != null && canUseCouponWithReferral) {
+	const referralOnCart = appliedReferralID != null;
+	const canUseCouponWithReferral = !pluginConfig.enableReferrals || pluginConfig.referralConfig.allowBothSystems || !referralOnCart;
+	if (appliedCouponID != null && !canUseCouponWithReferral) {
+		clearCouponFields(mutableData, fields);
+		couponDiscount = 0;
+		logCouponCartDebug("recalculateCart: cleared coupon (referral on cart with allowBothSystems=false)", {
+			cartCurrency,
+			cartMinor,
+			calculatedSubtotal,
+			subtotalMajor,
+			appliedCouponID,
+			referralOnCart
+		}, req);
+	} else if (appliedCouponID != null && canUseCouponWithReferral) {
 		const coupon = (await req.payload.find({
 			collection: pluginConfig.collections.couponsSlug,
 			where: { id: { equals: appliedCouponID } },
 			limit: 1
 		}))?.docs?.[0];
-		if (!coupon) clearCouponFields(mutableData, fields);
-		else {
+		if (!coupon) {
+			clearCouponFields(mutableData, fields);
+			logCouponCartDebug("recalculateCart: cleared coupon (document not found)", { appliedCouponID }, req);
+		} else {
 			const now = /* @__PURE__ */ new Date();
 			const activeFrom = coupon.activeFrom ? new Date(coupon.activeFrom) : null;
 			const activeUntil = coupon.activeUntil ? new Date(coupon.activeUntil) : null;
 			const isValidDate = (!activeFrom || now >= activeFrom) && (!activeUntil || now <= activeUntil);
 			const underUsage = !coupon.usageLimit || Number(coupon.usageCount || 0) < Number(coupon.usageLimit || 0);
-			if (!isValidDate || !underUsage) clearCouponFields(mutableData, fields);
-			else {
-				couponDiscount = roundTo2(calculateCouponDiscount({
+			if (!isValidDate || !underUsage) {
+				clearCouponFields(mutableData, fields);
+				logCouponCartDebug("recalculateCart: cleared coupon (inactive or usage limit)", {
+					appliedCouponID,
+					isValidDate,
+					underUsage
+				}, req);
+			} else {
+				const discountMajor = calculateCouponDiscount({
 					coupon,
-					cartTotal: calculatedSubtotal
-				}));
+					cartTotal: subtotalMajor
+				});
+				couponDiscount = cartMinor ? majorToMinor2dp(discountMajor) : roundTo2(discountMajor);
 				writeField(mutableData, fields.cartDiscountAmountField, couponDiscount);
+				logCouponCartDebug("recalculateCart: coupon discount computed", {
+					couponId: appliedCouponID,
+					couponType: coupon.type,
+					couponValue: coupon.value,
+					cartCurrency,
+					cartMinor,
+					calculatedSubtotal,
+					subtotalMajor,
+					discountMajor,
+					couponDiscountStored: couponDiscount
+				}, req);
 			}
 		}
 	} else if (readField$1(mutableData, fields.cartAppliedCouponField) === null) {
 		clearCouponFields(mutableData, fields);
-		writeField(mutableData, fields.cartCustomerDiscountField, 0);
-		writeField(mutableData, fields.cartPartnerCommissionField, 0);
-		writeField(mutableData, fields.cartTotalField, roundTo2(Number(resolvers.getCartSubtotal(mutableData)) || calculatedSubtotal));
-		return mutableData;
+		if (!referralOnCart) {
+			writeField(mutableData, fields.cartCustomerDiscountField, 0);
+			writeField(mutableData, fields.cartPartnerCommissionField, 0);
+			const st = Number(resolvers.getCartSubtotal(mutableData)) || calculatedSubtotal;
+			writeField(mutableData, fields.cartTotalField, cartMinor ? Math.round(st) : roundTo2(st));
+			logCouponCartDebug("recalculateCart: no applied coupon field (early exit)", {
+				cartCurrency,
+				cartMinor,
+				calculatedSubtotal,
+				totalSetTo: cartMinor ? Math.round(st) : roundTo2(st)
+			}, req);
+			return mutableData;
+		}
+		logCouponCartDebug("recalculateCart: no coupon; referral present, computing total with referral discount", {
+			cartCurrency,
+			cartMinor,
+			calculatedSubtotal,
+			referralOnCart
+		}, req);
 	}
-	const nextTotal = roundTo2(Math.max(0, calculatedSubtotal - customerDiscount - couponDiscount));
+	const nextTotal = cartMinor ? Math.max(0, Math.round(calculatedSubtotal) - Math.round(customerDiscount) - Math.round(couponDiscount)) : roundTo2(Math.max(0, calculatedSubtotal - customerDiscount - couponDiscount));
 	writeField(mutableData, fields.cartTotalField, nextTotal);
+	logCouponCartDebug("recalculateCart: final", {
+		cartCurrency,
+		cartMinor,
+		calculatedSubtotal,
+		subtotalMajor,
+		customerDiscount,
+		couponDiscount,
+		nextTotal,
+		appliedCouponIDAfter: relationId$3(readField$1(mutableData, fields.cartAppliedCouponField)),
+		referralOnCart,
+		canUseCouponWithReferral
+	}, req);
 	return mutableData;
 };
 //#endregion
@@ -2235,7 +2509,8 @@ const sanitizePluginConfig = ({ pluginConfig }) => {
 		integration: {
 			collections: integrationCollections,
 			fields: integrationFields,
-			resolvers: integrationResolvers
+			resolvers: integrationResolvers,
+			cartAmountsInMinorUnits: toBoolean(pluginConfig?.integration?.cartAmountsInMinorUnits, false)
 		},
 		referralConfig: {
 			allowBothSystems: pluginConfig?.referralConfig?.allowBothSystems ?? false,
@@ -2399,16 +2674,8 @@ const payloadEcommerceCouponPlugin = (pluginOptions = {}) => async (incomingConf
 		if (pluginOptions.collections?.referralProgramsCollectionOverride) referralProgramsCollection = await pluginOptions.collections.referralProgramsCollectionOverride({ defaultCollection: referralProgramsCollection });
 		if (pluginOptions.collections?.referralCodesCollectionOverride) referralCodesCollection = await pluginOptions.collections.referralCodesCollectionOverride({ defaultCollection: referralCodesCollection });
 		collectionsToAdd.push(referralProgramsCollection, referralCodesCollection);
-		if (pluginConfig.referralConfig.allowBothSystems) {
-			let couponsCollection = createCouponsCollection(pluginConfig);
-			if (pluginOptions.collections?.couponsCollectionOverride) couponsCollection = await pluginOptions.collections.couponsCollectionOverride({ defaultCollection: couponsCollection });
-			couponsCollection = ensureCouponCollectionEndpoints({
-				collection: couponsCollection,
-				pluginConfig
-			});
-			collectionsToAdd.push(couponsCollection);
-		}
-	} else {
+	}
+	{
 		let couponsCollection = createCouponsCollection(pluginConfig);
 		if (pluginOptions.collections?.couponsCollectionOverride) couponsCollection = await pluginOptions.collections.couponsCollectionOverride({ defaultCollection: couponsCollection });
 		couponsCollection = ensureCouponCollectionEndpoints({
@@ -2456,7 +2723,7 @@ const payloadEcommerceCouponPlugin = (pluginOptions = {}) => async (incomingConf
 					admin: { description: "Customer discount amount for this cart" }
 				}
 			];
-			if (pluginConfig.referralConfig.allowBothSystems && allSlugs.has(pluginConfig.collections.couponsSlug)) cartReferralFields.push({
+			if (allSlugs.has(pluginConfig.collections.couponsSlug)) cartReferralFields.push({
 				name: cartAppliedCouponField,
 				type: "relationship",
 				relationTo: pluginConfig.collections.couponsSlug,
@@ -2494,7 +2761,7 @@ const payloadEcommerceCouponPlugin = (pluginOptions = {}) => async (incomingConf
 					}
 				}
 			];
-			if (pluginConfig.referralConfig.allowBothSystems && allSlugs.has(pluginConfig.collections.couponsSlug)) orderReferralFields.push({
+			if (allSlugs.has(pluginConfig.collections.couponsSlug)) orderReferralFields.push({
 				name: orderAppliedCouponField,
 				type: "relationship",
 				relationTo: pluginConfig.collections.couponsSlug,
@@ -2591,7 +2858,7 @@ function resolveEndpoints(input) {
 * @param endpointConfig - Optional endpoint override config
 */
 async function useCouponCode(options, endpointConfig) {
-	const { code, cartID, customerEmail } = options;
+	const { code, cartID, customerEmail, secret } = options;
 	if (!code) return {
 		success: false,
 		message: "Coupon code is required",
@@ -2605,7 +2872,8 @@ async function useCouponCode(options, endpointConfig) {
 			body: JSON.stringify({
 				code,
 				cartID,
-				customerEmail
+				customerEmail,
+				...typeof secret === "string" && secret.trim().length > 0 ? { secret: secret.trim() } : {}
 			})
 		});
 		const data = await response.json();