feat: Offline payments with manual approval

buzz/api.py

@@ -12,6 +12,9 @@
 from buzz.payments import get_payment_gateways_for_event, get_payment_link_for_booking
 from buzz.utils import is_app_installed
 
+OFFLINE_PAYMENT_METHOD = "Offline"
+OFFLINE_PAYMENT_DEFAULT_LABEL = "Offline Payment"
+
 
 @frappe.whitelist(allow_guest=True)
 @rate_limit(key="identifier", limit=5, seconds=3600)
@@ -307,12 +310,28 @@ def get_event_booking_data(event_route: str) -> dict:
 	data.custom_fields = custom_fields
 
 	# Payment Gateways
-	data.payment_gateways = get_payment_gateways_for_event(event_doc.name)
+	payment_gateways = get_payment_gateways_for_event(event_doc.name)
+
+	# If offline payment is enabled, add it to the payment gateways list
+	if event_doc.enable_offline_payments:
+		offline_label = event_doc.offline_payment_label or OFFLINE_PAYMENT_DEFAULT_LABEL
+		payment_gateways.append(offline_label)
+
+	data.payment_gateways = payment_gateways
+
+	# Offline Payment Settings
+	data.offline_payment_enabled = event_doc.enable_offline_payments
+	if event_doc.enable_offline_payments:
+		data.offline_settings = {
+			"payment_details": event_doc.offline_payment_details,
+			"collect_payment_proof": event_doc.collect_payment_proof,
+			"label": event_doc.offline_payment_label or OFFLINE_PAYMENT_DEFAULT_LABEL,
+		}
 
 	return data
 
 
-@frappe.whitelist(allow_guest=True)
+@frappe.whitelist(allow_guest=True)  # nosemgrep: frappe-semgrep-rules.rules.security.guest-whitelisted-method
 def process_booking(
 	attendees: list[dict],
 	event: str,
@@ -324,6 +343,8 @@ def process_booking(
 	guest_full_name: str | None = None,
 	otp: str | None = None,
 	guest_phone: str | None = None,
+	payment_proof: str | None = None,
+	is_offline: bool = False,
 ) -> dict:
 	event_doc = frappe.get_cached_doc("Buzz Event", event)
 	is_guest = frappe.session.user == "Guest"
@@ -423,6 +444,45 @@ def process_booking(
 		booking.submit()
 		return {"booking_name": booking.name}
 
+	# Check if offline payment is explicitly requested and enabled
+	if is_offline:
+		if not event_doc.enable_offline_payments:
+			frappe.throw(_("Offline payment is not enabled for this event"))
+
+		booking.append(
+			"additional_fields",
+			{
+				"fieldname": "payment_method",
+				"value": OFFLINE_PAYMENT_METHOD,
+				"label": "Payment Method",
+				"fieldtype": "Data",
+			},
+		)
+
+		# Keep booking in draft until approved — don't submit
+		booking.status = "Approval Pending"
+		booking.payment_status = "Verification Pending"
+		booking.flags.ignore_permissions = True
+		booking.save()
+
+		# Attach payment proof if provided
+		if payment_proof:
+			try:
+				file_doc = frappe.get_doc(
+					{
+						"doctype": "File",
+						"file_url": payment_proof,
+						"attached_to_doctype": "Event Booking",
+						"attached_to_name": booking.name,
+						"is_private": 1,
+					}
+				)
+				file_doc.insert(ignore_permissions=True)
+			except Exception as e:
+				frappe.log_error(f"Failed to attach payment proof: {e}")
+
+		return {"booking_name": booking.name, "offline_payment": True}
+
 	return {
 		"payment_link": get_payment_link_for_booking(
 			booking.name,

buzz/buzz/doctype/buzz_custom_field/buzz_custom_field.json

@@ -32,13 +32,6 @@
    "fieldname": "column_break_fpgn",
    "fieldtype": "Column Break"
   },
-  {
-   "default": "Booking",
-   "fieldname": "applied_to",
-   "fieldtype": "Select",
-   "label": "Applied To",
-   "options": "Booking\nTicket"
-  },
   {
    "fieldname": "label",
    "fieldtype": "Data",
@@ -93,6 +86,13 @@
    "fieldname": "default_value",
    "fieldtype": "Data",
    "label": "Default Value"
+  },
+  {
+   "default": "Booking",
+   "fieldname": "applied_to",
+   "fieldtype": "Select",
+   "label": "Applied To",
+   "options": "Booking\nTicket\nOffline Payment Form"
   }
  ],
  "grid_page_length": 50,

buzz/buzz/doctype/buzz_custom_field/buzz_custom_field.py

@@ -14,7 +14,7 @@ class BuzzCustomField(Document):
 	if TYPE_CHECKING:
 		from frappe.types import DF
 
-		applied_to: DF.Literal["Booking", "Ticket"]
+		applied_to: DF.Literal["Booking", "Ticket", "Offline Payment Form"]
 		default_value: DF.Data | None
 		enabled: DF.Check
 		event: DF.Link

buzz/events/doctype/buzz_event/buzz_event.json

@@ -37,13 +37,18 @@
   "card_image",
   "section_break_rmtj",
   "allow_guest_booking",
-  "column_break_mijz",
   "guest_verification_method",
   "section_break_kwlt",
   "featured_speakers",
   "payments_tab",
   "section_break_owtc",
   "payment_gateways",
+  "offline_payment_section",
+  "enable_offline_payments",
+  "offline_payment_label",
+  "collect_payment_proof",
+  "column_break_xgh",
+  "offline_payment_details",
   "tax_settings_section",
   "apply_tax",
   "tax_inclusive",
@@ -377,6 +382,40 @@
    "fieldtype": "Section Break",
    "label": "Tax Settings"
   },
+  {
+   "description": "Allow attendees to pay offline (e.g. bank transfer, UPI) and submit proof for verification",
+   "fieldname": "offline_payment_section",
+   "fieldtype": "Section Break",
+   "label": "Offline Payment Settings"
+  },
+  {
+   "default": "0",
+   "fieldname": "enable_offline_payments",
+   "fieldtype": "Check",
+   "label": "Enable Offline Payments"
+  },
+  {
+   "depends_on": "eval:doc.enable_offline_payments==1",
+   "description": "Add payment details, instructions, QR codes, bank details, etc. Users can paste images and format content as needed.",
+   "fieldname": "offline_payment_details",
+   "fieldtype": "Text Editor",
+   "label": "Payment Details"
+  },
+  {
+   "default": "Offline Payment",
+   "depends_on": "eval:doc.enable_offline_payments==1",
+   "description": "Label displayed to users when selecting payment method (e.g., UPI Payment, Bank Transfer, etc.)",
+   "fieldname": "offline_payment_label",
+   "fieldtype": "Data",
+   "label": "Payment Method Label"
+  },
+  {
+   "default": "0",
+   "depends_on": "eval:doc.enable_offline_payments==1",
+   "fieldname": "collect_payment_proof",
+   "fieldtype": "Check",
+   "label": "Collect Proof of Payment"
+  },
   {
    "default": "0",
    "fieldname": "apply_tax",
@@ -458,7 +497,7 @@
    "fieldtype": "Section Break"
   },
   {
-   "fieldname": "column_break_mijz",
+   "fieldname": "column_break_xgh",
    "fieldtype": "Column Break"
   }
  ],

buzz/events/doctype/buzz_event/buzz_event.py

@@ -34,7 +34,9 @@ class BuzzEvent(Document):
 		banner_image: DF.AttachImage | None
 		card_image: DF.AttachImage | None
 		category: DF.Link
+		collect_payment_proof: DF.Check
 		default_ticket_type: DF.Link | None
+		enable_offline_payments: DF.Check
 		end_date: DF.Date | None
 		end_time: DF.Time
 		external_registration_page: DF.Check
@@ -46,6 +48,8 @@ class BuzzEvent(Document):
 		medium: DF.Literal["In Person", "Online"]
 		meta_image: DF.AttachImage | None
 		name: DF.Int | None
+		offline_payment_details: DF.TextEditor | None
+		offline_payment_label: DF.Data | None
 		payment_gateways: DF.Table[EventPaymentGateway]
 		proposal: DF.Link | None
 		registration_url: DF.Data | None

buzz/patches.txt

@@ -8,4 +8,5 @@ buzz.patches.migrate_to_multi_payment_gateway
 [post_model_sync]
 # Patches added in this section will be executed after doctypes are migrated
 buzz.patches.populate_slug_in_event_category
-buzz.patches.set_applies_to_for_existing_coupons
+buzz.patches.set_applies_to_for_existing_coupons
+buzz.patches.set_payment_status_for_existing_bookings

buzz/patches/set_payment_status_for_existing_bookings.py

@@ -0,0 +1,13 @@
+import frappe
+
+
+def execute():
+	EventBooking = frappe.qb.DocType("Event Booking")
+
+	# Set payment_status to "Paid" and status to "Confirmed" for all submitted bookings
+	(
+		frappe.qb.update(EventBooking)
+		.set(EventBooking.payment_status, "Paid")
+		.set(EventBooking.status, "Confirmed")
+		.where(EventBooking.docstatus == 1)
+	).run()

buzz/ticketing/doctype/event_booking/event_booking.js

@@ -10,5 +10,24 @@ frappe.ui.form.on("Event Booking", {
 				},
 			};
 		});
+
+		// Add Approve/Reject buttons for pending bookings
+		if (frappe.user.has_role("Event Manager") && frm.doc.status === "Approval Pending") {
+			frm.add_custom_button(__("Approve and Submit"), function () {
+				frappe.confirm("Are you sure you want to approve this booking?", function () {
+					frm.call("approve_booking").then(() => {
+						frm.refresh();
+					});
+				});
+			});
+
+			frm.add_custom_button(__("Reject"), function () {
+				frappe.confirm("Are you sure you want to reject this booking?", function () {
+					frm.call("reject_booking").then(() => {
+						frm.refresh();
+					});
+				});
+			});
+		}
 	},
 });

buzz/ticketing/doctype/event_booking/event_booking.json

@@ -10,6 +10,10 @@
   "column_break_cjxu",
   "user",
   "naming_series",
+  "section_break_status",
+  "payment_status",
+  "column_break_status",
+  "status",
   "section_break_xvkp",
   "attendees",
   "section_break_suav",
@@ -167,6 +171,33 @@
    "label": "Discount Amount",
    "options": "currency",
    "read_only": 1
+  },
+  {
+   "fieldname": "section_break_status",
+   "fieldtype": "Section Break",
+   "label": "Status"
+  },
+  {
+   "default": "Unpaid",
+   "fieldname": "payment_status",
+   "fieldtype": "Select",
+   "in_list_view": 1,
+   "label": "Payment Status",
+   "options": "Unpaid\nPaid\nVerification Pending",
+   "read_only": 1
+  },
+  {
+   "fieldname": "column_break_status",
+   "fieldtype": "Column Break"
+  },
+  {
+   "default": "Approval Pending",
+   "fieldname": "status",
+   "fieldtype": "Select",
+   "in_list_view": 1,
+   "label": "Status",
+   "options": "Confirmed\nApproval Pending\nApproved\nRejected",
+   "read_only": 1
   }
  ],
  "grid_page_length": 50,
@@ -182,7 +213,7 @@
    "link_fieldname": "reference_docname"
   }
  ],
- "modified": "2026-01-03 17:29:18.102192",
+ "modified": "2026-02-05 09:10:22.542973",
  "modified_by": "Administrator",
  "module": "Ticketing",
  "name": "Event Booking",