From bf36890bd3f65d7c1d464382022d3addcded16c6 Mon Sep 17 00:00:00 2001
From: Joedeep Singh <joedeepbrar@gmail.com>
Date: Sun, 12 Oct 2025 17:07:42 +0000
Subject: [PATCH] feat: added coupon code functionality

---
 frontend/components.d.ts                      |   2 +
 .../src/components/Settings/CouponDetails.vue | 157 +++++++++++++++++
 frontend/src/components/Settings/Coupons.vue  |  92 ++++++++++
 frontend/src/components/Settings/Settings.vue |   7 +
 .../Settings/TransactionDetails.vue           |  52 +++++-
 frontend/src/pages/Billing.vue                |  48 ++++-
 lms/lms/doctype/lms_coupon/__init__.py        |   0
 lms/lms/doctype/lms_coupon/lms_coupon.js      |   8 +
 lms/lms/doctype/lms_coupon/lms_coupon.json    | 166 ++++++++++++++++++
 lms/lms/doctype/lms_coupon/lms_coupon.py      |  56 ++++++
 lms/lms/doctype/lms_coupon/test_lms_coupon.py |  22 +++
 lms/lms/doctype/lms_coupon_item/__init__.py   |   0
 .../lms_coupon_item/lms_coupon_item.json      |  43 +++++
 .../lms_coupon_item/lms_coupon_item.py        |   9 +
 lms/lms/doctype/lms_payment/lms_payment.json  |  27 +++
 lms/lms/payments.py                           |  72 +++++---
 lms/lms/utils.py                              |  83 +++++++++
 17 files changed, 821 insertions(+), 23 deletions(-)
 create mode 100644 frontend/src/components/Settings/CouponDetails.vue
 create mode 100644 frontend/src/components/Settings/Coupons.vue
 create mode 100644 lms/lms/doctype/lms_coupon/__init__.py
 create mode 100644 lms/lms/doctype/lms_coupon/lms_coupon.js
 create mode 100644 lms/lms/doctype/lms_coupon/lms_coupon.json
 create mode 100644 lms/lms/doctype/lms_coupon/lms_coupon.py
 create mode 100644 lms/lms/doctype/lms_coupon/test_lms_coupon.py
 create mode 100644 lms/lms/doctype/lms_coupon_item/__init__.py
 create mode 100644 lms/lms/doctype/lms_coupon_item/lms_coupon_item.json
 create mode 100644 lms/lms/doctype/lms_coupon_item/lms_coupon_item.py

diff --git a/frontend/components.d.ts b/frontend/components.d.ts
index b9411e86..c205bb11 100644
--- a/frontend/components.d.ts
+++ b/frontend/components.d.ts
@@ -42,6 +42,8 @@ declare module 'vue' {
     CodeEditor: typeof import('./src/components/Controls/CodeEditor.vue')['default']
     CollapseSidebar: typeof import('./src/components/Icons/CollapseSidebar.vue')['default']
     ColorSwatches: typeof import('./src/components/Controls/ColorSwatches.vue')['default']
+    CouponDetails: typeof import('./src/components/Settings/CouponDetails.vue')['default']
+    Coupons: typeof import('./src/components/Settings/Coupons.vue')['default']
     CourseCard: typeof import('./src/components/CourseCard.vue')['default']
     CourseCardOverlay: typeof import('./src/components/CourseCardOverlay.vue')['default']
     CourseInstructors: typeof import('./src/components/CourseInstructors.vue')['default']
diff --git a/frontend/src/components/Settings/CouponDetails.vue b/frontend/src/components/Settings/CouponDetails.vue
new file mode 100644
index 00000000..3e3fff36
--- /dev/null
+++ b/frontend/src/components/Settings/CouponDetails.vue
@@ -0,0 +1,157 @@
+<template>
+	<Dialog v-model="show" :options="{ title: dialogTitle, size: '3xl' }">
+		<template #body-content>
+			<div class="grid grid-cols-2 gap-4 pt-4">
+				<FormControl v-model="doc.code" :label="__('Coupon Code')" :required="true" pattern="^[A-Za-z0-9]+$" minlength="6" @beforeinput="handleCodeInput" @input="doc.code = $event.target.value.toUpperCase()" />
+				<FormControl
+					v-model="doc.discount_type"
+					:label="__('Discount Type')"
+					:required="true"
+					type="select"
+					:options="['Percent', 'Amount']"
+				/>
+				<FormControl
+					v-if="doc.discount_type === 'Percent'"
+					v-model="doc.percent_off"
+					:required="true"
+					:label="__('Discount Percentage')"
+					type="number"
+				/>
+				<FormControl
+					v-else
+					v-model="doc.amount_off"
+					:required="true"
+					:label="__('Discount Amount')"
+					type="number"
+				/>
+				<FormControl v-model="doc.expires_on" :label="__('Expires On')" type="date" />
+				<FormControl v-model="doc.usage_limit" :label="__('Usage Limit')" type="number" />
+				<Switch v-model="doc.active" :label="__('Active')" />
+				<div class="col-span-2">
+					<div class="text-sm font-medium text-ink-gray-7 mb-2">{{ __('Applicable Items (optional)') }}</div>
+					<div class="space-y-2">
+						<div v-for="(row, idx) in doc.applicable_items" :key="idx" class="flex gap-2 items-center">
+							<FormControl v-model="row.reference_doctype" :label="__('Type')" type="select" :options="['LMS Course', 'LMS Batch']" />
+							<Link :doctype="row.reference_doctype || 'LMS Course'" :label="__('Item')" :value="row.reference_name" @change="(opt) => (row.reference_name = opt)" />
+							<Button variant="subtle" @click="removeRow(idx)">
+								<X class="h-3 w-3" />
+							</Button>
+						</div>
+					</div>
+					<Button class="mt-2" @click="addRow">
+						<template #prefix><Plus class="h-3 w-3" /></template>
+						{{ __('Add Item') }}
+					</Button>
+				</div>
+			</div>
+		</template>
+		<template #actions>
+			<div class="pb-5 float-right space-x-2">
+				<Button variant="outline" @click="show = false">{{ __('Cancel') }}</Button>
+				<Button variant="solid" @click="save">{{ __('Save') }}</Button>
+			</div>
+		</template>
+	</Dialog>
+</template>
+<script setup>
+import { Dialog, Button, FormControl, createResource, toast } from 'frappe-ui'
+import { ref, watch, computed } from 'vue'
+import { Plus, X } from 'lucide-vue-next'
+import Link from '@/components/Controls/Link.vue'
+
+const show = defineModel({ type: Boolean, required: true })
+const props = defineProps({ couponId: String })
+const emit = defineEmits(['saved'])
+
+const doc = ref({
+	code: '',
+	discount_type: 'Percent',
+	percent_off: null,
+	amount_off: null,
+	active: 1,
+	expires_on: null,
+	usage_limit: null,
+	applicable_items: [],
+})
+
+const dialogTitle = computed(() => (props.couponId === 'new' ? __('New Coupon') : __('Edit Coupon')))
+
+const getDoc = createResource({
+	url: 'frappe.client.get',
+	makeParams() {
+		return { doctype: 'LMS Coupon', name: props.couponId }
+	},
+	onSuccess(data) {
+		doc.value = data
+	},
+})
+
+watch(
+	() => show.value,
+	(val) => {
+		if (val) {
+			if (props.couponId && props.couponId !== 'new') {
+				getDoc.submit()
+			} else {
+				doc.value = { code: '', discount_type: 'Percent', active: 1, applicable_items: [] }
+			}
+		}
+	}
+)
+
+function addRow() {
+	doc.value.applicable_items.push({ reference_doctype: 'LMS Course', reference_name: null })
+}
+function removeRow(idx) {
+	doc.value.applicable_items.splice(idx, 1)
+}
+
+const saveDoc = createResource({
+	url: 'frappe.client.save',
+	makeParams(values) {
+		return { doc: doc.value }
+	},
+})
+
+const insertDoc = createResource({
+	url: 'frappe.client.insert',
+	makeParams(values) {
+		return { doc: { doctype: 'LMS Coupon', ...doc.value } }
+	},
+})
+
+function handleCodeInput(event) {
+	if (event.data && !/^[A-Za-z0-9]*$/.test(event.data)) {
+		event.preventDefault()
+	}
+}
+
+function save() {
+	if (props.couponId && props.couponId !== 'new') {
+		saveDoc.submit({}, {
+			onSuccess() {
+				toast.success(__('Saved'))
+				show.value = false
+				emit('saved')
+			},
+			onError(err) {
+				console.log('Save error:', err)
+				toast.error(err.messages?.[0] || err.message || err)
+			}
+		})
+	} else {
+		insertDoc.submit({}, {
+			onSuccess() {
+				toast.success(__('Saved'))
+				show.value = false
+				emit('saved')
+			},
+			onError(err) {
+				console.log('Insert error:', err)
+				toast.error(err.messages?.[0] || err.message || err)
+			}
+		})
+	}
+}
+</script>
+
diff --git a/frontend/src/components/Settings/Coupons.vue b/frontend/src/components/Settings/Coupons.vue
new file mode 100644
index 00000000..078f4846
--- /dev/null
+++ b/frontend/src/components/Settings/Coupons.vue
@@ -0,0 +1,92 @@
+<template>
+	<div class="flex min-h-0 flex-col text-base">
+		<div class="flex items-center justify-between mb-5">
+			<div>
+				<div class="text-xl font-semibold mb-1 text-ink-gray-9">
+					{{ __(label) }}
+				</div>
+				<div class="text-ink-gray-6 leading-5">
+					{{ __(description) }}
+				</div>
+			</div>
+			<Button @click="openForm('new')">
+				<template #prefix>
+					<Plus class="h-3 w-3 stroke-1.5" />
+				</template>
+				{{ __('New') }}
+			</Button>
+		</div>
+
+		<div v-if="coupons.data?.length" class="overflow-y-scroll">
+			<table class="w-full text-sm">
+				<thead>
+					<tr class="bg-surface-gray-2 text-ink-gray-7">
+						<th class="text-left p-2">{{ __('Code') }}</th>
+						<th class="text-left p-2">{{ __('Type') }}</th>
+						<th class="text-left p-2">{{ __('Value') }}</th>
+						<th class="text-left p-2">{{ __('Expires On') }}</th>
+						<th class="text-left p-2">{{ __('Usage') }}</th>
+						<th class="text-left p-2">{{ __('Active') }}</th>
+					</tr>
+				</thead>
+				<tbody>
+					<tr v-for="row in coupons.data" :key="row.name" class="hover:bg-surface-gray-2 cursor-pointer" @click="openForm(row.name)">
+						<td class="p-2">{{ row.code }}</td>
+						<td class="p-2">{{ row.discount_type }}</td>
+						<td class="p-2">
+							<span v-if="row.discount_type === 'Percent'">{{ row.percent_off }}%</span>
+							<span v-else>{{ row.amount_off }}</span>
+						</td>
+						<td class="p-2">{{ row.expires_on || '-' }}</td>
+						<td class="p-2">{{ row.times_redeemed }}/{{ row.usage_limit || '∞' }}</td>
+						<td class="p-2">
+							<Badge v-if="row.active" theme="green">{{ __('Enabled') }}</Badge>
+							<Badge v-else theme="gray">{{ __('Disabled') }}</Badge>
+						</td>
+					</tr>
+				</tbody>
+			</table>
+		</div>
+
+		<CouponDetails v-model="showDialog" :coupon-id="selected" @saved="onSaved" />
+	</div>
+</template>
+<script setup>
+import { Button, Badge, createListResource } from 'frappe-ui'
+import { ref } from 'vue'
+import { Plus } from 'lucide-vue-next'
+import CouponDetails from '@/components/Settings/CouponDetails.vue'
+
+defineProps({
+	label: String,
+	description: String,
+})
+
+const showDialog = ref(false)
+const selected = ref(null)
+
+const coupons = createListResource({
+	doctype: 'LMS Coupon',
+	fields: [
+		'name',
+		'code',
+		'discount_type',
+		'percent_off',
+		'amount_off',
+		'expires_on',
+		'usage_limit',
+		'times_redeemed',
+		'active',
+	],
+})
+
+function openForm(id) {
+	selected.value = id
+	showDialog.value = true
+}
+
+function onSaved() {
+	coupons.reload()
+}
+</script>
+
diff --git a/frontend/src/components/Settings/Settings.vue b/frontend/src/components/Settings/Settings.vue
index 57c40f3e..f660fab4 100644
--- a/frontend/src/components/Settings/Settings.vue
+++ b/frontend/src/components/Settings/Settings.vue
@@ -81,6 +81,7 @@ import Categories from '@/components/Settings/Categories.vue'
 import EmailTemplates from '@/components/Settings/EmailTemplates.vue'
 import BrandSettings from '@/components/Settings/BrandSettings.vue'
 import PaymentGateways from '@/components/Settings/PaymentGateways.vue'
+import Coupons from '@/components/Settings/Coupons.vue'
 import Transactions from '@/components/Settings/Transactions.vue'
 import ZoomSettings from '@/components/Settings/ZoomSettings.vue'
 import Badges from '@/components/Settings/Badges.vue'
@@ -230,6 +231,12 @@ const tabsStructure = computed(() => {
 					template: markRaw(PaymentGateways),
 					description: 'Add and manage all your payment gateways',
 				},
+				{
+					label: 'Coupons',
+					icon: 'Tag',
+					template: markRaw(Coupons),
+					description: 'Create and manage coupon codes',
+				},
 				{
 					label: 'Transactions',
 					icon: 'Landmark',
diff --git a/frontend/src/components/Settings/TransactionDetails.vue b/frontend/src/components/Settings/TransactionDetails.vue
index b996b02d..a3e38933 100644
--- a/frontend/src/components/Settings/TransactionDetails.vue
+++ b/frontend/src/components/Settings/TransactionDetails.vue
@@ -72,6 +72,40 @@
 					/>
 				</div>
 
+				<div
+					v-if="transactionData && (transactionData.coupon || transactionData.discount_amount || transactionData.discount_percent)"
+					class="mt-10"
+				>
+					<div class="font-semibold">
+						{{ __('Coupon (if applied)') }}
+					</div>
+					<div class="grid grid-cols-3 gap-5 mt-5">
+						<Link
+							:label="__('Coupon')"
+							v-model="transactionData.coupon"
+							doctype="LMS Coupon"
+							:disabled="true"
+						/>
+						<FormControl
+							:label="__('Discount Type')"
+							v-model="transactionData.discount_type"
+							:disabled="true"
+						/>
+						<FormControl
+							v-if="transactionData.discount_type === 'Percent'"
+							:label="__('Discount Percent')"
+							v-model="transactionData.discount_percent"
+							:disabled="true"
+						/>
+						<FormControl
+							v-else
+							:label="__('Discount Amount')"
+							v-model="transactionData.discount_amount"
+							:disabled="true"
+						/>
+					</div>
+				</div>
+
 				<div class="grid grid-cols-3 gap-5 mt-5">
 					<FormControl :label="__('GSTIN')" v-model="transactionData.gstin" />
 					<FormControl :label="__('PAN')" v-model="transactionData.pan" />
@@ -100,7 +134,7 @@
 	</Dialog>
 </template>
 <script setup lang="ts">
-import { Dialog, FormControl, Button } from 'frappe-ui'
+import { Dialog, FormControl, Button, createResource } from 'frappe-ui'
 import { useRouter } from 'vue-router'
 import { ref, watch } from 'vue'
 import Link from '@/components/Controls/Link.vue'
@@ -115,10 +149,24 @@ const props = defineProps<{
 	transaction: { [key: string]: any } | null
 }>()
 
+const paymentDoc = createResource({
+	url: 'frappe.client.get',
+	makeParams() {
+		return { doctype: 'LMS Payment', name: props.transaction?.name }
+	},
+	onSuccess(data) {
+		transactionData.value = data
+	},
+})
+
 watch(
 	() => props.transaction,
 	(newVal) => {
-		transactionData.value = newVal ? { ...newVal } : null
+		if (newVal?.name) {
+			paymentDoc.submit()
+		} else {
+			transactionData.value = null
+		}
 	},
 	{ immediate: true }
 )
diff --git a/frontend/src/pages/Billing.vue b/frontend/src/pages/Billing.vue
index 551e041d..cad12d4f 100644
--- a/frontend/src/pages/Billing.vue
+++ b/frontend/src/pages/Billing.vue
@@ -46,6 +46,10 @@
 							{{ orderSummary.data.gst_amount_formatted }}
 						</div>
 					</div>
+					<div v-if="orderSummary.data.discount_amount" class="flex items-center justify-between mt-2">
+						<div class="text-ink-gray-5">{{ __('Discount') }}</div>
+						<div>-{{ orderSummary.data.discount_amount_formatted }}</div>
+					</div>
 					<div
 						class="flex items-center justify-between border-t border-outline-gray-3 pt-4 mt-2"
 					>
@@ -56,6 +60,14 @@
 							{{ orderSummary.data.total_amount_formatted }}
 						</div>
 					</div>
+					<div class="mb-5">
+						<div class="flex items-center gap-3 mt-2 flex-wrap md:flex-nowrap" v-if="props.type !== 'certificate'">
+							<span class="text-ink-gray-5 text-xs shrink-0">{{ __('Coupon') }}</span>
+							<FormControl class="flex-1 min-w-0 [&_input]:!bg-[#fefefe]" v-model="couponCode" @input="couponCode = $event.target.value.toUpperCase()"/>
+							<Button @click="applyCouponCode" variant="outline">{{ __('Apply') }}</Button>
+							<Button v-if="appliedCoupon" @click="removeCoupon" variant="subtle">{{ __('Remove') }}</Button>
+						</div>
+					</div>
 				</div>
 
 				<div class="flex-1 lg:mr-10">
@@ -158,7 +170,7 @@ import {
 	usePageMeta,
 	toast,
 } from 'frappe-ui'
-import { reactive, inject, onMounted, computed } from 'vue'
+import { reactive, inject, onMounted, computed, ref } from 'vue'
 import { sessionStore } from '../stores/session'
 import Link from '@/components/Controls/Link.vue'
 import NotPermitted from '@/components/NotPermitted.vue'
@@ -212,6 +224,29 @@ const orderSummary = createResource({
 	},
 })
 
+const couponCode = ref('')
+const appliedCoupon = ref(null)
+
+const applyCoupon = createResource({
+	url: 'lms.lms.utils.apply_coupon',
+	makeParams() {
+		return {
+			doctype: props.type == 'batch' ? 'LMS Batch' : 'LMS Course',
+			docname: props.name,
+			code: couponCode.value,
+			country: billingDetails.country,
+		}
+	},
+	onSuccess(data) {
+		orderSummary.data = data
+		appliedCoupon.value = couponCode.value
+		toast.success(__('Coupon applied'))
+	},
+	onError(err) {
+		toast.error(err.messages?.[0] || err)
+	},
+})
+
 const billingDetails = reactive({})
 
 const setBillingDetails = (data) => {
@@ -241,6 +276,7 @@ const paymentLink = createResource({
 			address: billingDetails,
 			redirect_to: redirectTo.value,
 			payment_for_certificate: props.type == 'certificate',
+			coupon_code: appliedCoupon.value,
 		}
 	},
 })
@@ -265,6 +301,16 @@ const generatePaymentLink = () => {
 	)
 }
 
+function applyCouponCode() {
+	if (!couponCode.value) return
+	applyCoupon.submit()
+}
+
+function removeCoupon() {
+	appliedCoupon.value = null
+	orderSummary.reload()
+}
+
 const validateAddress = () => {
 	let mandatoryFields = [
 		'billing_name',
diff --git a/lms/lms/doctype/lms_coupon/__init__.py b/lms/lms/doctype/lms_coupon/__init__.py
new file mode 100644
index 00000000..e69de29b
diff --git a/lms/lms/doctype/lms_coupon/lms_coupon.js b/lms/lms/doctype/lms_coupon/lms_coupon.js
new file mode 100644
index 00000000..4e406d49
--- /dev/null
+++ b/lms/lms/doctype/lms_coupon/lms_coupon.js
@@ -0,0 +1,8 @@
+// Copyright (c) 2025, Frappe and contributors
+// For license information, please see license.txt
+
+// frappe.ui.form.on("LMS Coupon", {
+// 	refresh(frm) {
+
+// 	},
+// });
diff --git a/lms/lms/doctype/lms_coupon/lms_coupon.json b/lms/lms/doctype/lms_coupon/lms_coupon.json
new file mode 100644
index 00000000..31eb826a
--- /dev/null
+++ b/lms/lms/doctype/lms_coupon/lms_coupon.json
@@ -0,0 +1,166 @@
+{
+ "actions": [],
+ "allow_rename": 1,
+ "autoname": "hash",
+ "creation": "2025-10-11 21:39:11.456420",
+ "doctype": "DocType",
+ "engine": "InnoDB",
+ "field_order": [
+  "code",
+  "discount_type",
+  "percent_off",
+  "amount_off",
+  "active",
+  "expires_on",
+  "usage_limit",
+  "times_redeemed",
+  "description",
+  "applicable_items"
+ ],
+ "fields": [
+  {
+   "fieldname": "code",
+   "fieldtype": "Data",
+   "in_list_view": 1,
+   "label": "Code",
+   "reqd": 1,
+   "unique": 1
+  },
+  {
+   "fieldname": "discount_type",
+   "fieldtype": "Select",
+   "in_list_view": 1,
+   "label": "Discount Type",
+   "options": "Percent\nAmount",
+   "reqd": 1
+  },
+  {
+   "depends_on": "eval:doc.discount_type=='Percent'",
+   "fieldname": "percent_off",
+   "fieldtype": "Percent",
+   "label": "Percent Off",
+   "mandatory_depends_on": "eval:doc.discount_type=='Percent'"
+  },
+  {
+   "depends_on": "eval:doc.discount_type=='Amount'",
+   "fieldname": "amount_off",
+   "fieldtype": "Int",
+   "label": "Amount Off",
+   "mandatory_depends_on": "eval:doc.discount_type=='Amount'"
+  },
+  {
+   "default": "1",
+   "fieldname": "active",
+   "fieldtype": "Check",
+   "in_list_view": 1,
+   "label": "Active"
+  },
+  {
+   "fieldname": "expires_on",
+   "fieldtype": "Date",
+   "in_standard_filter": 1,
+   "label": "Expires On"
+  },
+  {
+   "fieldname": "usage_limit",
+   "fieldtype": "Int",
+   "label": "Usage Limit"
+  },
+  {
+   "default": "0",
+   "fieldname": "times_redeemed",
+   "fieldtype": "Int",
+   "in_list_view": 1,
+   "label": "Times Redeemed",
+   "read_only": 1
+  },
+  {
+   "fieldname": "description",
+   "fieldtype": "Small Text",
+   "label": "Description"
+  },
+  {
+   "fieldname": "applicable_items",
+   "fieldtype": "Table",
+   "label": "Applicable Items",
+   "options": "LMS Coupon Item",
+   "reqd": 1
+  }
+ ],
+ "grid_page_length": 50,
+ "index_web_pages_for_search": 1,
+ "links": [],
+ "modified": "2025-10-12 18:41:35.034875",
+ "modified_by": "Administrator",
+ "module": "LMS",
+ "name": "LMS Coupon",
+ "naming_rule": "Random",
+ "owner": "Administrator",
+ "permissions": [
+  {
+   "create": 1,
+   "delete": 1,
+   "email": 1,
+   "export": 1,
+   "print": 1,
+   "read": 1,
+   "report": 1,
+   "role": "System Manager",
+   "share": 1,
+   "write": 1
+  },
+  {
+   "create": 1,
+   "delete": 1,
+   "email": 1,
+   "export": 1,
+   "print": 1,
+   "read": 1,
+   "report": 1,
+   "role": "Administrator",
+   "share": 1,
+   "write": 1
+  },
+  {
+   "create": 1,
+   "delete": 1,
+   "email": 1,
+   "export": 1,
+   "print": 1,
+   "read": 1,
+   "report": 1,
+   "role": "Batch Evaluator",
+   "share": 1,
+   "write": 1
+  },
+  {
+   "create": 1,
+   "delete": 1,
+   "email": 1,
+   "export": 1,
+   "print": 1,
+   "read": 1,
+   "report": 1,
+   "role": "Course Creator",
+   "share": 1,
+   "write": 1
+  },
+  {
+   "create": 1,
+   "delete": 1,
+   "email": 1,
+   "export": 1,
+   "print": 1,
+   "read": 1,
+   "report": 1,
+   "role": "Moderator",
+   "share": 1,
+   "write": 1
+  }
+ ],
+ "row_format": "Dynamic",
+ "rows_threshold_for_grid_search": 20,
+ "sort_field": "creation",
+ "sort_order": "DESC",
+ "states": []
+}
diff --git a/lms/lms/doctype/lms_coupon/lms_coupon.py b/lms/lms/doctype/lms_coupon/lms_coupon.py
new file mode 100644
index 00000000..fc8f33b8
--- /dev/null
+++ b/lms/lms/doctype/lms_coupon/lms_coupon.py
@@ -0,0 +1,56 @@
+# Copyright (c) 2025, Frappe and contributors
+# For license information, please see license.txt
+
+import frappe
+from frappe.model.document import Document
+from frappe import _
+from frappe.utils import nowdate
+
+
+class LMSCoupon(Document):
+    def validate(self):
+        # Normalize code to uppercase and strip spaces
+        if self.code:
+            self.code = self.code.strip().upper()
+
+        if not self.code:
+            frappe.throw(_("Coupon code is required."))
+
+        # Ensure uniqueness of code (case-insensitive)
+        if self.name:
+            existing = frappe.db.exists(
+                "LMS Coupon",
+                {
+                    "code": self.code,
+                    "name": ["!=", self.name],
+                },
+            )
+        else:
+            existing = frappe.db.exists("LMS Coupon", {"code": self.code})
+        if existing:
+            frappe.throw(_("Coupon code already exists."))
+
+        if not self.discount_type:
+            frappe.throw(_("Discount type is required."))
+
+        if self.discount_type == "Percent":
+            if self.percent_off is None:
+                frappe.throw(_("Percent Off is required for Percent discount type."))
+            if not (0 < float(self.percent_off) <= 100):
+                frappe.throw(_("Percent Off must be between 1 and 100."))
+            # Clear the other field to avoid confusion
+            self.amount_off = None
+
+        if self.discount_type == "Amount":
+            if self.amount_off is None:
+                frappe.throw(_("Amount Off is required for Amount discount type."))
+            if float(self.amount_off) < 0:
+                frappe.throw(_("Amount Off cannot be negative."))
+            # Clear the other field
+            self.percent_off = None
+
+        if self.usage_limit is not None and int(self.usage_limit) < 0:
+            frappe.throw(_("Usage limit cannot be negative."))
+
+        if self.expires_on and str(self.expires_on) < nowdate():
+            frappe.throw(_("Expiry date cannot be in the past."))
diff --git a/lms/lms/doctype/lms_coupon/test_lms_coupon.py b/lms/lms/doctype/lms_coupon/test_lms_coupon.py
new file mode 100644
index 00000000..11cdf628
--- /dev/null
+++ b/lms/lms/doctype/lms_coupon/test_lms_coupon.py
@@ -0,0 +1,22 @@
+# Copyright (c) 2025, Frappe and Contributors
+# See license.txt
+
+# import frappe
+from frappe.tests import IntegrationTestCase
+
+
+# On IntegrationTestCase, the doctype test records and all
+# link-field test record dependencies are recursively loaded
+# Use these module variables to add/remove to/from that list
+EXTRA_TEST_RECORD_DEPENDENCIES = []  # eg. ["User"]
+IGNORE_TEST_RECORD_DEPENDENCIES = []  # eg. ["User"]
+
+
+
+class IntegrationTestLMSCoupon(IntegrationTestCase):
+	"""
+	Integration tests for LMSCoupon.
+	Use this class for testing interactions between multiple components.
+	"""
+
+	pass
diff --git a/lms/lms/doctype/lms_coupon_item/__init__.py b/lms/lms/doctype/lms_coupon_item/__init__.py
new file mode 100644
index 00000000..e69de29b
diff --git a/lms/lms/doctype/lms_coupon_item/lms_coupon_item.json b/lms/lms/doctype/lms_coupon_item/lms_coupon_item.json
new file mode 100644
index 00000000..359b3910
--- /dev/null
+++ b/lms/lms/doctype/lms_coupon_item/lms_coupon_item.json
@@ -0,0 +1,43 @@
+{
+ "actions": [],
+ "allow_rename": 1,
+ "creation": "2025-10-11 21:45:00",
+ "doctype": "DocType",
+ "editable_grid": 1,
+ "engine": "InnoDB",
+ "field_order": [
+  "reference_doctype",
+  "reference_name"
+ ],
+ "fields": [
+  {
+   "fieldname": "reference_doctype",
+   "fieldtype": "Select",
+   "in_list_view": 1,
+   "label": "Reference DocType",
+   "options": "\nLMS Course\nLMS Batch",
+   "reqd": 1
+  },
+  {
+   "fieldname": "reference_name",
+   "fieldtype": "Dynamic Link",
+   "in_list_view": 1,
+   "label": "Reference Name",
+   "options": "reference_doctype",
+   "reqd": 1
+  }
+ ],
+ "index_web_pages_for_search": 1,
+ "istable": 1,
+ "links": [],
+ "modified": "2025-10-12 17:27:14.123811",
+ "modified_by": "Administrator",
+ "module": "LMS",
+ "name": "LMS Coupon Item",
+ "owner": "Administrator",
+ "permissions": [],
+ "row_format": "Dynamic",
+ "sort_field": "modified",
+ "sort_order": "DESC",
+ "states": []
+}
diff --git a/lms/lms/doctype/lms_coupon_item/lms_coupon_item.py b/lms/lms/doctype/lms_coupon_item/lms_coupon_item.py
new file mode 100644
index 00000000..ca44dbef
--- /dev/null
+++ b/lms/lms/doctype/lms_coupon_item/lms_coupon_item.py
@@ -0,0 +1,9 @@
+# Copyright (c) 2025, Frappe and contributors
+# For license information, please see license.txt
+
+# import frappe
+from frappe.model.document import Document
+
+
+class LMSCouponItem(Document):
+	pass
diff --git a/lms/lms/doctype/lms_payment/lms_payment.json b/lms/lms/doctype/lms_payment/lms_payment.json
index 662aa6e1..fec68f94 100644
--- a/lms/lms/doctype/lms_payment/lms_payment.json
+++ b/lms/lms/doctype/lms_payment/lms_payment.json
@@ -18,6 +18,10 @@
   "payment_details_section",
   "currency",
   "amount",
+  "coupon",
+  "discount_type",
+  "discount_percent",
+  "discount_amount",
   "amount_with_gst",
   "column_break_yxpl",
   "order_id",
@@ -47,6 +51,29 @@
    "options": "currency",
    "reqd": 1
   },
+  {
+   "fieldname": "coupon",
+   "fieldtype": "Link",
+   "label": "Coupon",
+   "options": "LMS Coupon"
+  },
+  {
+   "fieldname": "discount_type",
+   "fieldtype": "Select",
+   "label": "Discount Type",
+   "options": "\nPercent\nAmount"
+  },
+  {
+   "fieldname": "discount_percent",
+   "fieldtype": "Percent",
+   "label": "Discount Percent"
+  },
+  {
+   "fieldname": "discount_amount",
+   "fieldtype": "Currency",
+   "label": "Discount Amount",
+   "options": "currency"
+  },
   {
    "fieldname": "currency",
    "fieldtype": "Link",
diff --git a/lms/lms/payments.py b/lms/lms/payments.py
index 9f4e31fe..6bc3fe32 100644
--- a/lms/lms/payments.py
+++ b/lms/lms/payments.py
@@ -19,23 +19,45 @@ def validate_currency(payment_gateway, currency):
 
 @frappe.whitelist()
 def get_payment_link(
-	doctype,
-	docname,
-	title,
-	amount,
-	total_amount,
-	currency,
-	address,
-	redirect_to,
-	payment_for_certificate,
+    doctype,
+    docname,
+    title,
+    amount,
+    total_amount,
+    currency,
+    address,
+    redirect_to,
+    payment_for_certificate,
+    coupon_code=None,
 ):
 	payment_gateway = get_payment_gateway()
 	address = frappe._dict(address)
-	amount_with_gst = total_amount if total_amount != amount else 0
+    amount_with_gst = total_amount if total_amount != amount else 0
 
-	payment = record_payment(
-		address, doctype, docname, amount, currency, amount_with_gst, payment_for_certificate
-	)
+    coupon_context = None
+    # Coupon application only for courses/batches
+    if doctype in ["LMS Course", "LMS Batch"] and coupon_code:
+        try:
+            from lms.lms.utils import apply_coupon
+
+            applied = apply_coupon(doctype, docname, coupon_code)
+            # Override total_amount based on validated coupon calculation
+            total_amount = applied.get("amount", total_amount)
+            coupon_context = applied
+        except Exception:
+            # Ignore coupon errors here; frontend handles validation
+            pass
+
+    payment = record_payment(
+        address,
+        doctype,
+        docname,
+        amount,
+        currency,
+        amount_with_gst,
+        payment_for_certificate,
+        coupon_context,
+    )
 	controller = get_controller(payment_gateway)
 
 	payment_details = {
@@ -61,13 +83,14 @@ def get_payment_link(
 
 
 def record_payment(
-	address,
-	doctype,
-	docname,
-	amount,
-	currency,
-	amount_with_gst=0,
-	payment_for_certificate=0,
+    address,
+    doctype,
+    docname,
+    amount,
+    currency,
+    amount_with_gst=0,
+    payment_for_certificate=0,
+    coupon_context=None,
 ):
 	address = frappe._dict(address)
 	address_name = save_address(address)
@@ -89,6 +112,15 @@ def record_payment(
 			"payment_for_certificate": payment_for_certificate,
 		}
 	)
+    if coupon_context:
+        payment_doc.update(
+            {
+                "coupon": coupon_context.get("coupon"),
+                "discount_type": coupon_context.get("discount_type"),
+                "discount_percent": coupon_context.get("discount_percent"),
+                "discount_amount": coupon_context.get("discount_amount"),
+            }
+        )
 	payment_doc.save(ignore_permissions=True)
 	return payment_doc
 
diff --git a/lms/lms/utils.py b/lms/lms/utils.py
index c978cfcd..c571b56c 100644
--- a/lms/lms/utils.py
+++ b/lms/lms/utils.py
@@ -951,6 +951,77 @@ def get_current_exchange_rate(source, target="USD"):
 	return details["rates"][target]
 
 
+@frappe.whitelist()
+def apply_coupon(doctype, docname, code, country=None):
+    # Validate doctype
+    if doctype not in ["LMS Course", "LMS Batch"]:
+        frappe.throw(_("Invalid doctype for coupon application."))
+
+    if not code:
+        frappe.throw(_("Coupon code is required."))
+
+    summary = get_order_summary(doctype, docname, country)
+
+    base_amount = summary.original_amount
+    currency = summary.currency
+
+    # Fetch coupon case-insensitively
+    coupon_name = frappe.db.get_value("LMS Coupon", {"code": code.strip().upper(), "active": 1}, "name")
+    if not coupon_name:
+        frappe.throw(_("Invalid or inactive coupon code."))
+
+    coupon = frappe.get_doc("LMS Coupon", coupon_name)
+
+    # Expiry
+    if coupon.expires_on and getdate(coupon.expires_on) < getdate():
+        frappe.throw(_("This coupon has expired."))
+
+    # Usage limit
+    if coupon.usage_limit and cint(coupon.times_redeemed) >= cint(coupon.usage_limit):
+        frappe.throw(_("This coupon has reached its usage limit."))
+
+    # Applicability (if rows exist, must match; if none, applies to all)
+    applicable = True
+    if len(coupon.applicable_items):
+        applicable = any(
+            (row.reference_doctype == doctype and row.reference_name == docname)
+            for row in coupon.applicable_items
+        )
+    if not applicable:
+        frappe.throw(_("This coupon is not applicable to this item."))
+
+    # Compute discount before tax
+    discount_amount = 0
+    if coupon.discount_type == "Percent":
+        discount_amount = cint(flt(base_amount) * flt(coupon.percent_off) / 100)
+    else:
+        discount_amount = min(flt(coupon.amount_off), flt(base_amount))
+
+    subtotal = max(flt(base_amount) - flt(discount_amount), 0)
+
+    gst_applied = 0
+    final_amount = subtotal
+    if currency == "INR":
+        final_amount, gst_applied = apply_gst(subtotal, country)
+
+    return {
+        "title": summary.title,
+        "name": summary.name,
+        "currency": currency,
+        "original_amount": base_amount,
+        "original_amount_formatted": fmt_money(base_amount, 0, currency),
+        "discount_amount": discount_amount,
+        "discount_amount_formatted": fmt_money(discount_amount, 0, currency),
+        "amount": final_amount,
+        "gst_applied": gst_applied,
+        "gst_amount_formatted": fmt_money(gst_applied, 0, currency) if gst_applied else None,
+        "total_amount_formatted": fmt_money(final_amount, 0, currency),
+        "coupon": coupon.name,
+        "discount_type": coupon.discount_type,
+        "discount_percent": coupon.percent_off if coupon.discount_type == "Percent" else None,
+    }
+
+
 @frappe.whitelist()
 def change_currency(amount, currency, country=None):
 	amount = cint(amount)
@@ -1867,6 +1938,18 @@ def update_payment_record(doctype, docname):
 				"order_id": data.get("order_id"),
 			},
 		)
+
+		# Increment coupon usage if applicable
+		coupon = frappe.db.get_value("LMS Payment", data.payment, "coupon")
+		if coupon:
+			frappe.db.sql(
+				"""
+				UPDATE `tabLMS Coupon`
+				SET times_redeemed = COALESCE(times_redeemed, 0) + 1
+				WHERE name = %s
+				""",
+				(coupon,),
+			)
 		payment_for_certificate = frappe.db.get_value("LMS Payment", data.payment, "payment_for_certificate")
 
 		try: