PluginProbe
Yatra – Travel Booking & Tour Operator Software / 3.0.13
Yatra – Travel Booking & Tour Operator Software v3.0.13
3.0.14 3.0.14.1 3.0.14.2 3.0.12 3.0.13 3.0.11 3.0.10 3.0.9 3.0.8 3.0.7 3.0.6 3.0.5 3.0.5.1 3.0.4 3.0.3 3.0.2.9 3.0.2.7 3.0.2.8 3.0.2.6 trunk 1.0.0 2.0.0 2.0.1 2.0.10 2.0.11 All 82 releases
yatra / app / Controllers / BookingSessionController.php

BookingSessionController.php in Yatra – Travel Booking & Tour Operator Software 3.0.13, at app/Controllers/BookingSessionController.php

4,904 lines 228.8 KB
No matching file
Up and down to move Enter to open Esc to close
Raw Download Zip
1 <?php
2
3 declare(strict_types=1);
4
5 namespace Yatra\Controllers;
6
7 use WP_REST_Request;
8 use WP_REST_Response;
9 use WP_Error;
10 use Yatra\Repositories\TravellerRepository;
11 use Yatra\Repositories\CustomerRepository;
12 use Yatra\Repositories\TripRepository;
13 use Yatra\Repositories\BookingRepository;
14 use Yatra\Services\SettingsService;
15 use Yatra\Services\TransactionalEmailTemplateService;
16 use Yatra\Services\EmailService;
17 use Yatra\Services\DepartureService;
18 use Yatra\Services\AvailabilityService;
19 use Yatra\Services\CalculationService;
20 use Yatra\Repositories\DepartureRepository;
21 use Yatra\Repositories\BookingDepartureRepository;
22 use Yatra\PaymentGateways\GatewayUserMessages;
23 use Yatra\PaymentGateways\PaymentGatewayRegistry;
24 use Yatra\Utils\Logger;
25
26 /**
27 * Booking Session REST API Controller
28 * Manages booking session data via REST API
29 */
30 class BookingSessionController extends BaseController
31 {
32 /**
33 * @var TravellerRepository
34 */
35 private TravellerRepository $travellerRepository;
36
37 /**
38 * @var CustomerRepository
39 */
40 private CustomerRepository $customerRepository;
41
42 /**
43 * @var TripRepository
44 */
45 private TripRepository $tripRepository;
46
47 /**
48 * @var BookingRepository
49 */
50 private BookingRepository $bookingRepository;
51
52 /**
53 * @var DepartureService
54 */
55 private DepartureService $departureService;
56
57 /**
58 * @var AvailabilityService
59 */
60 private AvailabilityService $availabilityService;
61
62 /**
63 * @var \Yatra\Repositories\DiscountRepository
64 */
65 private $discountRepository;
66
67 /**
68 * Constructor
69 */
70 public function __construct()
71 {
72 $this->travellerRepository = new TravellerRepository();
73 $this->customerRepository = new CustomerRepository();
74 $this->tripRepository = new TripRepository();
75 $this->bookingRepository = new BookingRepository();
76 $this->departureService = new DepartureService(
77 new DepartureRepository(),
78 new \Yatra\Repositories\BookingDepartureRepository(),
79 $this->bookingRepository,
80 $this->tripRepository
81 );
82 $this->availabilityService = new AvailabilityService(
83 new \Yatra\Repositories\AvailabilityRepository()
84 );
85 $this->discountRepository = new \Yatra\Repositories\DiscountRepository();
86 }
87
88 /**
89 * Public permission callback for REST API routes
90 * Allows public access to booking endpoints
91 *
92 * Removes cookie validation to prevent "Cookie check failed" errors for logged-out users
93 */
94 public function public_permission_callback(?WP_REST_Request $request = null): bool
95 {
96 // Remove cookie validation requirement for this endpoint
97 // This allows guest users to access the endpoint without nonce validation
98 remove_filter('rest_authentication_errors', 'rest_cookie_check_errors', 100);
99 return true;
100 }
101
102 /**
103 * REST API namespace
104 */
105 protected string $namespace = 'yatra/v1';
106
107 /**
108 * Register REST API routes
109 */
110 public function register_routes(): void
111 {
112 // Set booking session
113 register_rest_route($this->namespace, '/booking/session', [
114 'methods' => 'POST',
115 'callback' => [$this, 'set_session'],
116 'permission_callback' => [$this, 'public_permission_callback'],
117 ]);
118
119 // Get booking session
120 register_rest_route($this->namespace, '/booking/session', [
121 'methods' => 'GET',
122 'callback' => [$this, 'get_session'],
123 'permission_callback' => [$this, 'public_permission_callback'],
124 ]);
125
126 // Clear booking session
127 register_rest_route($this->namespace, '/booking/session', [
128 'methods' => 'DELETE',
129 'callback' => [$this, 'clear_session'],
130 'permission_callback' => [$this, 'public_permission_callback'],
131 ]);
132
133 // Get trip data for booking
134 register_rest_route($this->namespace, '/booking/trip/(?P<id>\d+)', [
135 'methods' => 'GET',
136 'callback' => [$this, 'get_trip_for_booking'],
137 'permission_callback' => [$this, 'public_permission_callback'],
138 'args' => [
139 'id' => [
140 'required' => true,
141 'type' => 'integer',
142 'sanitize_callback' => 'absint',
143 ],
144 ],
145 ]);
146
147 // Create booking
148 register_rest_route($this->namespace, '/booking/create', [
149 'methods' => 'POST',
150 'callback' => [$this, 'create_booking'],
151 'permission_callback' => [$this, 'public_permission_callback'],
152 ]);
153
154 // Verify a guest's booking email via magic-link token.
155 // Public + GET so the customer's browser can hit it from a
156 // plain email-client link. The token itself carries the
157 // authorisation (HMAC-signed); permission_callback is
158 // intentionally open. On success the booking transitions to
159 // 'pending' and the browser is redirected to the continuation
160 // URL (where the customer completes payment as normal).
161 register_rest_route($this->namespace, '/booking/verify-email', [
162 'methods' => 'GET',
163 'callback' => [$this, 'verify_email'],
164 'permission_callback' => '__return_true',
165 'args' => [
166 'token' => [
167 'required' => true,
168 'type' => 'string',
169 'sanitize_callback' => 'sanitize_text_field',
170 ],
171 ],
172 ]);
173
174 // Apply coupon code
175 register_rest_route($this->namespace, '/booking/coupon/apply', [
176 'methods' => 'POST',
177 'callback' => [$this, 'apply_coupon'],
178 'permission_callback' => [$this, 'public_permission_callback'],
179 ]);
180
181 // Remove coupon code
182 register_rest_route($this->namespace, '/booking/coupon/remove', [
183 'methods' => 'POST',
184 'callback' => [$this, 'remove_coupon'],
185 'permission_callback' => [$this, 'public_permission_callback'],
186 ]);
187
188 // Calculate booking summary (AJAX endpoint for dynamic updates)
189 register_rest_route($this->namespace, '/booking/summary', [
190 'methods' => 'POST',
191 'callback' => [$this, 'calculate_summary'],
192 'permission_callback' => [$this, 'public_permission_callback'],
193 ]);
194
195 // Complete payment for client-side gateways (Square, etc.)
196 register_rest_route($this->namespace, '/payment/(?P<gateway>[a-z_]+)/complete', [
197 'methods' => 'POST',
198 'callback' => [$this, 'complete_gateway_payment'],
199 'permission_callback' => [$this, 'public_permission_callback'],
200 ]);
201 }
202
203 /**
204 * Complete payment for client-side payment gateways
205 * Used by Square, and other gateways that tokenize on client
206 */
207 public function complete_gateway_payment(WP_REST_Request $request): WP_REST_Response
208 {
209 $gateway_id = sanitize_key((string) $request->get_param('gateway'));
210 $data = $request->get_json_params();
211 if (!is_array($data)) {
212 $data = [];
213 }
214
215 $booking_id = (int) ($data['booking_id'] ?? 0);
216 $source_id = sanitize_text_field((string) ($data['source_id'] ?? ''));
217 $client_amount = (float) ($data['amount'] ?? 0);
218 $client_currency = sanitize_text_field((string) ($data['currency'] ?? 'USD'));
219
220 if ($booking_id <= 0 || $source_id === '') {
221 return new WP_REST_Response([
222 'success' => false,
223 'message' => __('Missing required payment data.', 'yatra'),
224 ], 400);
225 }
226
227 $bookingRepository = new \Yatra\Repositories\BookingRepository();
228 $booking = $bookingRepository->find($booking_id);
229
230 // Resolve the guest booking-session token (body first, then ?booking_token=),
231 // exactly as the other booking-session endpoints do.
232 $booking_token = '';
233 if (!empty($data['booking_token']) && is_string($data['booking_token'])) {
234 $booking_token = sanitize_text_field((string) $data['booking_token']);
235 } elseif (isset($_GET['booking_token']) && is_string($_GET['booking_token'])) {
236 $booking_token = sanitize_text_field((string) wp_unslash($_GET['booking_token']));
237 }
238
239 // H-1: ownership gate (monitor-first). An honest caller either owns the
240 // booking (logged-in user / admin) or carries the booking_token bound to
241 // it; only a stranger targeting someone else's booking_id is rejected.
242 // In monitor mode this just logs and proceeds (zero behaviour change).
243 if (!$this->requesterOwnsBooking($booking_id, $booking, $booking_token)) {
244 if (\Yatra\Security\Guard::denied('payment_complete_ownership', [
245 'booking_id' => $booking_id,
246 'user' => get_current_user_id(),
247 'gateway' => $gateway_id,
248 ])) {
249 return new WP_REST_Response([
250 'success' => false,
251 'message' => __('You are not allowed to complete this payment.', 'yatra'),
252 ], 403);
253 }
254 }
255
256 // H-1: server-authoritative amount/currency. Honest clients already send
257 // the booking's due amount, so this is invisible to them; it removes the
258 // ability to tamper the charged amount. Override only when enforcing.
259 $amount = $client_amount;
260 $currency = $client_currency;
261 if ($booking) {
262 $server_amount = (float) ($booking->amount_due ?? 0);
263 if ($server_amount <= 0) {
264 $server_amount = (float) ($booking->total_amount ?? 0);
265 }
266 $server_currency = (string) ($booking->currency ?? $client_currency);
267
268 if ($server_amount > 0) {
269 $mismatch = abs($server_amount - $client_amount) > 0.001
270 || ($client_currency !== '' && $server_currency !== ''
271 && strcasecmp($client_currency, $server_currency) !== 0);
272
273 if ($mismatch) {
274 \Yatra\Security\Guard::flag('payment_complete_amount_mismatch', [
275 'booking_id' => $booking_id,
276 'client_amount' => $client_amount,
277 'server_amount' => $server_amount,
278 ]);
279 }
280
281 if (\Yatra\Security\Guard::enforcing()) {
282 $amount = $server_amount;
283 $currency = $server_currency;
284 }
285 }
286 }
287
288 // Get the gateway
289 $registry = \Yatra\PaymentGateways\PaymentGatewayRegistry::getInstance();
290 $gateway = $registry->get($gateway_id);
291
292 if (!$gateway) {
293 return new WP_REST_Response([
294 'success' => false,
295 'message' => __('Invalid payment gateway.', 'yatra'),
296 ], 400);
297 }
298
299 // Check if gateway has createPayment method
300 if (!method_exists($gateway, 'createPayment')) {
301 return new WP_REST_Response([
302 'success' => false,
303 'message' => __('Gateway does not support this payment method.', 'yatra'),
304 ], 400);
305 }
306
307 // Create the payment
308 $result = $gateway->createPayment([
309 'source_id' => $source_id,
310 'booking_id' => $booking_id,
311 'amount' => $amount,
312 'currency' => $currency,
313 ]);
314
315 if (!$result['success']) {
316 return new WP_REST_Response([
317 'success' => false,
318 'message' => $result['error'] ?? __('Payment failed.', 'yatra'),
319 ], 400);
320 }
321
322 $transaction_id = (string) ($result['transaction_id'] ?? '');
323
324 // Update booking payment status
325 if ($booking) {
326 $paymentRepository = new \Yatra\Repositories\PaymentRepository();
327
328 // Idempotency guard: never double-record the same gateway transaction
329 // for the same booking (e.g. a retried submit or a webhook racing this
330 // call). Safe always-on — only blocks a duplicate, never a first payment.
331 $alreadyRecorded = false;
332 if ($transaction_id !== '' && method_exists($paymentRepository, 'findByTransactionId')) {
333 $existing = $paymentRepository->findByTransactionId($transaction_id);
334 $alreadyRecorded = $existing && (int) ($existing->booking_id ?? 0) === $booking_id;
335 }
336
337 if (!$alreadyRecorded) {
338 // Record the payment using PaymentRepository
339 $paymentRepository->create([
340 'booking_id' => $booking_id,
341 'amount' => $amount,
342 'currency' => $currency,
343 'gateway' => $gateway_id,
344 'transaction_id' => $transaction_id,
345 'status' => ($result['status'] ?? 'completed') === 'completed' ? 'completed' : 'pending',
346 ]);
347
348 // Update booking status if payment is complete
349 if (($result['status'] ?? 'completed') === 'completed') {
350 // Get total paid amount
351 $total_paid = $paymentRepository->getTotalPaidForBooking($booking_id);
352 $total_amount = (float) $booking->total_amount;
353
354 if ($total_paid >= $total_amount) {
355 $prevStatus = (string) ($booking->status ?? 'pending');
356 $bookingRepository->update($booking_id, ['status' => 'confirmed', 'payment_status' => 'paid']);
357 \yatra_trigger_booking_confirmed((int) $booking_id, $prevStatus);
358 } else {
359 $bookingRepository->update($booking_id, ['payment_status' => 'partial']);
360 }
361 }
362 }
363 }
364
365 return new WP_REST_Response([
366 'success' => true,
367 'message' => __('Payment completed successfully.', 'yatra'),
368 'data' => [
369 'transaction_id' => $transaction_id,
370 'status' => $result['status'] ?? 'completed',
371 ],
372 ]);
373 }
374
375 /**
376 * Ownership check for booking-session mutations (H-1 / M-2).
377 *
378 * Mirrors {@see \Yatra\Controllers\PaymentGatewayController::get_payment_status()}:
379 * - admins always pass;
380 * - a registered-user booking requires the owning user;
381 * - a guest booking (user_id NULL/0) requires the short-lived booking_token
382 * transient whose stored `booking_id` matches — i.e. the same browser that
383 * started this checkout. Honest guests always carry that token in the URL.
384 *
385 * @param object|null $booking Booking row, or null when not found.
386 */
387 private function requesterOwnsBooking(int $bookingId, $booking, string $bookingToken): bool
388 {
389 if (current_user_can('manage_options')) {
390 return true;
391 }
392
393 if (!$booking) {
394 return false;
395 }
396
397 $bookingUserId = (int) ($booking->user_id ?? 0);
398 $currentUserId = (int) get_current_user_id();
399
400 if ($bookingUserId > 0) {
401 return $currentUserId === $bookingUserId;
402 }
403
404 // Guest booking: prove possession of the booking-session token bound to it.
405 if ($bookingToken !== '') {
406 $session = get_transient($bookingToken);
407 if (is_array($session) && (int) ($session['booking_id'] ?? 0) === $bookingId) {
408 return true;
409 }
410 }
411
412 return false;
413 }
414
415 /**
416 * Set booking session data
417 * Supports full creation (requires trip_id) or partial updates (travelers, traveler_counts)
418 */
419 public function set_session(WP_REST_Request $request): WP_REST_Response
420 {
421 // Ensure session is started for REST API requests
422 yatra_start_session();
423
424 $data = $request->get_json_params();
425
426 // M-2: restore CSRF protection stripped by public_permission_callback.
427 if (($blocked = $this->guardPublicBookingMutation($request, $data)) !== null) {
428 return $blocked;
429 }
430
431 // Check if this is a partial update (updating travelers or services in existing session)
432 $existing_session = yatra_get_booking_session();
433
434 // REST requests don't always carry PHPSESSID into the WP session scope,
435 // so for partial updates (where the JS only sends e.g.
436 // `additional_services: [1]`) we may end up with an empty
437 // `$existing_session` here and incorrectly bounce to the "trip_id
438 // required" guard below. Same fix as create_booking: when the page
439 // URL has a `?booking_token=…` (or the body carries it), look up the
440 // matching transient and treat it as the session. Without this, every
441 // service-toggle returns 400.
442 if (empty($existing_session) || empty($existing_session['trip_id'])) {
443 $token = null;
444 if (!empty($data['booking_token']) && is_string($data['booking_token'])) {
445 $token = sanitize_text_field((string) $data['booking_token']);
446 } elseif (isset($_GET['booking_token']) && is_string($_GET['booking_token'])) {
447 $token = sanitize_text_field((string) wp_unslash($_GET['booking_token']));
448 }
449 if ($token) {
450 $transient_data = get_transient($token);
451 if (is_array($transient_data) && !empty($transient_data['trip_id'])) {
452 $existing_session = $transient_data;
453 // CRITICAL: also seed $_SESSION with the rehydrated data
454 // AND the original token so yatra_set_booking_session()
455 // (called below in the partial-update branch) writes the
456 // updated session BACK into the same transient. Without
457 // this, the helper generates a fresh random token and
458 // writes to a different transient — the user's URL token
459 // never gets the new selection persisted, and the next
460 // refresh shows stale data.
461 $_SESSION['yatra_booking'] = $existing_session;
462 $_SESSION['yatra_booking_token'] = $token;
463 }
464 }
465 }
466
467 $is_partial_update = empty($data['trip_id']) && !empty($existing_session['trip_id']) &&
468 (isset($data['travelers']) || isset($data['traveler_counts']) || isset($data['additional_services']));
469
470 if ($is_partial_update) {
471 // Partial update: merge new data with existing session
472 if (isset($data['travelers'])) {
473 $existing_session['travelers'] = max(1, (int) $data['travelers']);
474 }
475 if (isset($data['traveler_counts']) && is_array($data['traveler_counts'])) {
476 $existing_session['traveler_counts'] = $data['traveler_counts'];
477 // Recalculate total travelers from counts
478 $existing_session['travelers'] = max(1, array_sum(array_map('intval', $data['traveler_counts'])));
479 }
480 // Handle additional services selection
481 if (isset($data['additional_services']) && is_array($data['additional_services'])) {
482 $existing_session['additional_services'] = array_map('intval', $data['additional_services']);
483 }
484
485 // Recalculate taxes for partial updates
486 $trip_id = (int) ($existing_session['trip_id'] ?? 0);
487 $trip_price = (float) ($existing_session['trip_price'] ?? $existing_session['base_price'] ?? 0);
488 $travelers_count = (int) ($existing_session['travelers'] ?? 1);
489 $additional_services = $existing_session['additional_services'] ?? [];
490 $travel_date = (string) ($existing_session['travel_date'] ?? '');
491 $departure_time = (string) ($existing_session['departure_time'] ?? '');
492
493 // Calculate base amount - handle traveler-based pricing
494 $base_amount = 0;
495 $pricing_type = $existing_session['pricing_type'] ?? 'regular';
496 $price_types = $existing_session['price_types'] ?? [];
497 $traveler_counts = $existing_session['traveler_counts'] ?? [];
498
499 if ($pricing_type === 'traveler_based' && !empty($price_types)) {
500 // Calculate for traveler-based pricing
501 foreach ($price_types as $pt) {
502 $pt = (array) $pt;
503 $category_id = $pt['category_id'] ?? 0;
504 $pricing_mode = $pt['pricing_mode'] ?? 'per_person';
505 $category_price = isset($pt['effective_price']) ? (float) $pt['effective_price'] : \Yatra\Services\TripPricingService::resolveCategoryEffectivePrice($pt);
506 $count = isset($traveler_counts[$category_id]) ? (int) $traveler_counts[$category_id] : 0;
507
508 if ($pricing_mode === 'per_group') {
509 // Per group: charge flat price once if any travelers in this category
510 if ($count > 0) {
511 $base_amount += $category_price;
512 }
513 } else {
514 // Per person: charge per traveler
515 $base_amount += $category_price * $count;
516 }
517 }
518 } else {
519 // Regular pricing
520 $base_amount = $trip_price * $travelers_count;
521 }
522
523 // Use CalculationService for pricing (fetches trip data from database)
524 $calculationService = new CalculationService();
525 $pricing = $calculationService->calculatePricing([
526 'trip_id' => $trip_id,
527 'travelers_count' => $travelers_count,
528 'traveler_counts' => $traveler_counts,
529 'travel_date' => $travel_date,
530 'departure_time' => $departure_time,
531 'selected_services' => $additional_services,
532 'coupon_code' => '',
533 'payment_method' => 'full',
534 ]);
535 $subtotal = (float) ($pricing['subtotal'] ?? $base_amount);
536 $total_with_tax = (float) ($pricing['final_total'] ?? $subtotal);
537 $tax_calculation = (array) ($pricing['tax_calculation'] ?? []);
538 $services_cost = (float) ($pricing['services_cost'] ?? $pricing['services_total'] ?? 0);
539
540 // Note: Pricing is calculated on-demand via CalculationService, not stored in session
541
542 $existing_session['timestamp'] = time();
543
544 // Save updated session
545 yatra_set_booking_session($existing_session);
546
547 return new WP_REST_Response([
548 'success' => true,
549 'message' => __('Booking session updated.', 'yatra'),
550 'data' => $existing_session,
551 ]);
552 }
553
554 if (empty($data['trip_id'])) {
555 return new WP_REST_Response([
556 'success' => false,
557 'message' => __('Trip ID is required.', 'yatra'),
558 ], 400);
559 }
560
561 // Validate trip exists
562 $trip = $this->tripRepository->findPublished((int) $data['trip_id']);
563
564 if (!$trip) {
565 return new WP_REST_Response([
566 'success' => false,
567 'message' => __('Trip not found.', 'yatra'),
568 ], 404);
569 }
570
571 global $wpdb;
572
573 // Get availability-specific data if date provided
574 $availability = null;
575 // availability_id may be numeric (manual date row) or a synthetic string (rule/default).
576 // Keep it as string in session and only cast to int when it is numeric.
577 $availability_id = !empty($data['availability_id']) ? sanitize_text_field((string) $data['availability_id']) : null;
578 $travel_date = !empty($data['travel_date']) ? sanitize_text_field($data['travel_date']) : '';
579 $departure_time = !empty($data['departure_time']) ? sanitize_text_field($data['departure_time']) : '';
580
581 // Use centralized AvailabilityResolutionService to get resolved availability
582 // Priority: Availability Dates → Recurring Rules → Trip Default (specific rows override patterns)
583 // Pass departure_time for day tours with multiple time slots on the same date
584 $availability = null;
585 if ($travel_date) {
586 try {
587 $resolutionService = new \Yatra\Services\AvailabilityResolutionService();
588 $availability = $resolutionService->resolveAvailabilityForDate(
589 (int) $data['trip_id'],
590 $travel_date,
591 $departure_time ?: null
592 );
593
594 if ($availability) {
595 $data['availability_id'] = $availability->id;
596 $data['seats_available'] = $availability->seats_available;
597 $data['seats_total'] = $availability->seats_total;
598 }
599 } catch (\Exception $e) {
600 $availability = null;
601 }
602 }
603
604 // Resolve pricing_type and price_types via centralized TripPricingService
605 // Priority: frontend data → availability → trip defaults
606 $pricing_type = !empty($data['pricing_type'])
607 ? sanitize_text_field($data['pricing_type'])
608 : \Yatra\Services\TripPricingService::resolvePricingType($trip);
609
610 $price_types = [];
611
612 // First priority: price_types sent from frontend (from availability card)
613 if (!empty($data['price_types']) && is_array($data['price_types'])) {
614 $price_types = $data['price_types'];
615 }
616 // Second priority: availability price_types (already includes trip fallback from AvailabilityResolutionService)
617 elseif ($availability && !empty($availability->price_types)) {
618 $price_types = is_array($availability->price_types) ? $availability->price_types : [];
619 }
620 // Third priority: trip's price_types via centralized normalizer
621 if (empty($price_types)) {
622 $price_types = \Yatra\Services\TripPricingService::resolvePriceTypes($trip);
623 }
624 // Auto-detect traveler_based if price_types are present
625 if (!empty($price_types) && $pricing_type === 'regular') {
626 $pricing_type = 'traveler_based';
627 }
628 // NOTE: Actual pricing calculation is handled entirely by CalculationService below
629
630 // Enrich price_types with category labels if needed (some might already have them from frontend)
631 if (!empty($price_types)) {
632 $needsEnrichment = false;
633 foreach ($price_types as $pt) {
634 $pt = (array) $pt;
635 if (empty($pt['category_label']) && !empty($pt['category_id'])) {
636 $needsEnrichment = true;
637 break;
638 }
639 }
640
641 if ($needsEnrichment) {
642 $categoryIds = array_filter(array_map(function($p) {
643 $p = (array) $p;
644 return isset($p['category_id']) ? (int) $p['category_id'] : null;
645 }, $price_types));
646
647 if (!empty($categoryIds)) {
648 // Use AvailabilityService to get traveler categories
649 $cats = $this->availabilityService->getTravelerCategories($categoryIds);
650
651 $catIndex = [];
652 foreach ($cats as $cat) {
653 $catIndex[(int) $cat->id] = $cat;
654 }
655
656 foreach ($price_types as &$pt) {
657 $pt = (array) $pt;
658 $catId = isset($pt['category_id']) ? (int) $pt['category_id'] : null;
659 if ($catId && isset($catIndex[$catId]) && empty($pt['category_label'])) {
660 $cat = $catIndex[$catId];
661 $pt['category_label'] = $cat->label;
662 $pt['category_slug'] = $cat->slug;
663 $pt['age_min'] = $cat->age_min ? (int) $cat->age_min : null;
664 $pt['age_max'] = $cat->age_max ? (int) $cat->age_max : null;
665 }
666 // Ensure effective price is set via centralized resolver
667 if (!isset($pt['effective_price'])) {
668 $pt['effective_price'] = \Yatra\Services\TripPricingService::resolveCategoryEffectivePrice($pt);
669 }
670 }
671 }
672 }
673 }
674
675 // Parse traveler_counts if provided (for traveler-based pricing)
676 $traveler_counts = [];
677 if (!empty($data['traveler_counts']) && is_array($data['traveler_counts'])) {
678 $traveler_counts = $data['traveler_counts'];
679 }
680
681 // Calculate total travelers
682 $travelers_count = isset($data['travelers']) ? (int) $data['travelers'] : 0;
683 if (!empty($traveler_counts)) {
684 $travelers_count = array_sum(array_map('intval', $traveler_counts));
685 }
686
687 if ($travelers_count < 1) {
688 return new WP_REST_Response([
689 'success' => false,
690 'message' => __('Please select at least 1 traveler to continue.', 'yatra'),
691 ], 400);
692 }
693
694 // Determine if day trip - prefer frontend value, fallback to trip duration
695 $is_day_trip = isset($data['is_day_trip']) ? (bool) $data['is_day_trip'] : (($trip->duration_days ?? 1) <= 1);
696
697 // Get additional services from request (selected in popup)
698 $additional_services = [];
699 if (!empty($data['additional_services']) && is_array($data['additional_services'])) {
700 $additional_services = array_map('intval', $data['additional_services']);
701 }
702
703 // Resolve enabled gateways for this session (use registry to respect availability)
704 $gatewayRegistry = PaymentGatewayRegistry::getInstance();
705 $availableGateways = $gatewayRegistry->getForCheckout();
706 $enabled_gateways = [];
707 foreach ($availableGateways as $gateway) {
708 if (!empty($gateway['id'])) {
709 $enabled_gateways[$gateway['id']] = $gateway;
710 }
711 }
712 // Fallback: if registry returned nothing, use saved settings gateways
713 if (empty($enabled_gateways)) {
714 $settings_gateways = SettingsService::get('payment_gateways', []);
715 if (is_array($settings_gateways)) {
716 $enabled_gateways = $settings_gateways;
717 }
718 }
719
720 // Use CalculationService as single source of truth for all pricing
721 $calculationService = new CalculationService();
722 $pricing = $calculationService->calculatePricing([
723 'trip_id' => (int) $trip->id,
724 'travelers_count' => $travelers_count,
725 'traveler_counts' => $traveler_counts,
726 'travel_date' => $travel_date,
727 'departure_time' => $departure_time,
728 'selected_services' => $additional_services,
729 'availability_id' => $availability_id ? (int) $availability_id : null,
730 'coupon_code' => '',
731 'payment_method' => 'full',
732 ]);
733
734 // Resolve pricing_mode / group-size limits authoritatively from the
735 // TravelerCategory before persisting, so the checkout breakdown (which
736 // reads these session price_types) renders a per-group category as a
737 // flat charge. Per-person categories are unchanged.
738 $price_types = \Yatra\Services\TripPricingService::applyCategoryPricingMeta($price_types);
739
740 // Prepare session data - essential trip data (pricing fetched from database on-demand)
741 $session_data = [
742 'trip_id' => (int) $trip->id,
743 'trip_title' => $trip->title,
744 'trip_slug' => $trip->slug,
745 'currency' => $pricing['currency'] ?? \Yatra\Services\SettingsService::getCurrency(),
746 'min_travelers' => (int) ($trip->min_travelers ?: 1),
747 'max_travelers' => (int) ($trip->max_travelers ?: 20),
748 'duration_days' => (int) ($trip->duration_days ?: 1),
749 'travelers' => $travelers_count,
750 'travel_date' => $travel_date,
751 'departure_time' => $departure_time,
752 'timestamp' => time(),
753 // Availability-specific data
754 'availability_id' => $availability_id,
755 'pricing_type' => $pricing['pricing_type'] ?? $pricing_type,
756 'price_types' => $price_types,
757 'traveler_counts' => $traveler_counts,
758 'is_day_trip' => $is_day_trip,
759 // Additional services (selected in popup)
760 'additional_services' => $additional_services,
761 // Payment gateways available for checkout UI
762 'enabled_gateways' => $enabled_gateways,
763 // Note: NO pricing data stored - fetched from database on-demand via CalculationService
764 ];
765
766 if (!empty($data['is_remaining_payment'])) {
767 $session_data['is_remaining_payment'] = true;
768 $session_data['existing_booking_id'] = (int) ($data['existing_booking_id'] ?? 0);
769 $session_data['booking_reference'] = $data['booking_reference'] ?? '';
770 $session_data['remaining_amount'] = isset($data['remaining_amount']) ? (float) $data['remaining_amount'] : null;
771 $session_data['amount_paid'] = isset($data['amount_paid']) ? (float) $data['amount_paid'] : null;
772 $session_data['total_amount'] = isset($data['total_amount']) ? (float) $data['total_amount'] : null;
773 }
774
775 // Reset any previous session to avoid stale flags
776 yatra_clear_booking_session();
777
778 // Set session
779 yatra_set_booking_session($session_data);
780
781 // Get the booking token directly from session (it's added by yatra_set_booking_session)
782 yatra_start_session();
783 $booking_token = $_SESSION['yatra_booking_token'] ?? null;
784
785
786 // Fire hook when trip is added to booking session (for Pro modules)
787 do_action('yatra_trip_added_to_session', $session_data['trip_id'], $session_data);
788
789 // Get redirect URL
790 $redirect_url = yatra_get_checkout_url();
791
792 // Add booking token to URL for REST API → page load session restoration
793 if ($booking_token) {
794 $redirect_url = add_query_arg('booking_token', $booking_token, $redirect_url);
795 }
796
797 // Add booking_token to response data for debugging
798 $session_data['booking_token'] = $booking_token;
799
800 return new WP_REST_Response([
801 'success' => true,
802 'message' => __('Booking session created.', 'yatra'),
803 'data' => $session_data,
804 'redirect_url' => $redirect_url,
805 ]);
806 }
807
808 /**
809 * Get booking session data
810 */
811 public function get_session(WP_REST_Request $request): WP_REST_Response
812 {
813 $session_data = yatra_get_booking_session();
814
815 // Recover from transient when PHPSESSID didn't propagate to REST.
816 // The JS appends `?booking_token=…` to the GET URL specifically so
817 // this branch can rehydrate after a page refresh — without it the
818 // sidebar's applied-coupon UI would never re-show and the remove
819 // button stayed hidden.
820 if (empty($session_data) || empty($session_data['trip_id'])) {
821 $token_raw = $request->get_param('booking_token');
822 if (empty($token_raw) && isset($_GET['booking_token']) && is_string($_GET['booking_token'])) {
823 $token_raw = wp_unslash((string) $_GET['booking_token']);
824 }
825 if (!empty($token_raw) && is_string($token_raw)) {
826 $token = sanitize_text_field($token_raw);
827 $transient_data = get_transient($token);
828 if (is_array($transient_data) && !empty($transient_data['trip_id'])) {
829 $session_data = $transient_data;
830 $_SESSION['yatra_booking'] = $session_data;
831 $_SESSION['yatra_booking_token'] = $token;
832 }
833 }
834 }
835
836 if (empty($session_data) || empty($session_data['trip_id'])) {
837 return new WP_REST_Response([
838 'success' => false,
839 'message' => __('No active booking session.', 'yatra'),
840 'data' => null,
841 ]);
842 }
843
844 return new WP_REST_Response([
845 'success' => true,
846 'data' => $session_data,
847 ]);
848 }
849
850 /**
851 * Clear booking session
852 */
853 public function clear_session(WP_REST_Request $request): WP_REST_Response
854 {
855 // M-2: restore CSRF protection stripped by public_permission_callback.
856 if (($blocked = $this->guardPublicBookingMutation($request)) !== null) {
857 return $blocked;
858 }
859
860 yatra_clear_booking_session();
861
862 return new WP_REST_Response([
863 'success' => true,
864 'message' => __('Booking session cleared.', 'yatra'),
865 ]);
866 }
867
868 /**
869 * Get trip data for booking page
870 */
871 public function get_trip_for_booking(WP_REST_Request $request): WP_REST_Response
872 {
873 $trip_id = (int) $request->get_param('id');
874
875 $trip = $this->tripRepository->findPublished($trip_id);
876
877 if (!$trip) {
878 return new WP_REST_Response([
879 'success' => false,
880 'message' => __('Trip not found.', 'yatra'),
881 ], 404);
882 }
883
884 // Format trip data for booking
885 $trip_data = [
886 'id' => (int) $trip->id,
887 'title' => $trip->title,
888 'slug' => $trip->slug,
889 'featured_image' => $trip->featured_image,
890 'duration_days' => (int) $trip->duration_days,
891 'duration_nights' => (int) $trip->duration_nights,
892 'difficulty_level' => $trip->difficulty_level,
893 'min_travelers' => (int) ($trip->min_travelers ?: 1),
894 'max_travelers' => (int) ($trip->max_travelers ?: 20),
895 'original_price' => (float) $trip->original_price,
896 'sale_price' => (float) $trip->sale_price,
897 'price' => !empty($trip->discounted_price) ? (float) $trip->discounted_price : (float) $trip->original_price,
898 'currency' => \Yatra\Services\SettingsService::getCurrency(),
899 'starting_location' => $trip->starting_location,
900 'ending_location' => $trip->ending_location,
901 ];
902
903 return new WP_REST_Response([
904 'success' => true,
905 'data' => $trip_data,
906 ]);
907 }
908
909 /**
910 * Create a new booking OR process remaining payment (same REST route).
911 *
912 * Regular checkout: persists the booking first (BookingService::createBooking), then starts
913 * online payment if needed; payment rows are written when the gateway confirms success
914 * (confirm endpoint, webhooks, IPN, or recordGatewayPayment for immediate captures).
915 *
916 * Remaining / balance payment: does not create a booking — only charges the existing row
917 * and records a payment on success via the same gateway completion paths.
918 */
919 /**
920 * Validate the booking-scoped CSRF nonce.
921 *
922 * Looks first in the `X-Yatra-Booking-Nonce` request header
923 * (the JS frontend's path), then in JSON body keys used by
924 * older or non-JS fallback flows. Returns true on a valid
925 * nonce, false otherwise.
926 *
927 * @param WP_REST_Request $request
928 * @param array<string, mixed>|null $data decoded JSON body
929 */
930 private function verifyBookingNonce(WP_REST_Request $request, $data): bool
931 {
932 $nonce = (string) $request->get_header('X-Yatra-Booking-Nonce');
933 if ($nonce === '' && \is_array($data)) {
934 $nonce = (string) (
935 $data['_yatra_booking_nonce']
936 ?? $data['yatra_booking_nonce']
937 ?? $data['booking_nonce']
938 ?? ''
939 );
940 }
941 if ($nonce === '') {
942 return false;
943 }
944 return (bool) wp_verify_nonce($nonce, 'yatra_booking_action');
945 }
946
947 /**
948 * CSRF guard for the public booking-session mutations (M-2).
949 *
950 * `public_permission_callback` strips WP's REST cookie-nonce so guests can
951 * reach these routes, which would otherwise leave them open to cross-site
952 * forgery of a visitor's session. This restores protection by requiring at
953 * least one signal that an honest same-origin checkout always carries:
954 * - the booking-scoped nonce (`X-Yatra-Booking-Nonce`), or
955 * - a valid WP REST nonce (`X-WP-Nonce`, the one that was stripped), or
956 * - a booking_token transient, or
957 * - an active PHP booking session.
958 * A blind cross-site POST has none of these.
959 *
960 * Monitor-first: returns a 403 response ONLY when the guard is enforcing;
961 * in monitor mode it logs and returns null so behaviour is unchanged.
962 *
963 * @param array<string, mixed>|null $data decoded JSON body (decoded here if null)
964 * @return WP_REST_Response|null 403 response to short-circuit with, or null to proceed
965 */
966 private function guardPublicBookingMutation(WP_REST_Request $request, $data = null): ?WP_REST_Response
967 {
968 if ($data === null) {
969 $data = $request->get_json_params();
970 }
971
972 // 1) booking-scoped nonce, or 2) the stripped WP REST nonce.
973 if ($this->verifyBookingNonce($request, $data)) {
974 return null;
975 }
976 $restNonce = (string) $request->get_header('X-WP-Nonce');
977 if ($restNonce !== '' && wp_verify_nonce($restNonce, 'wp_rest')) {
978 return null;
979 }
980
981 // 3) a booking-session token (body first, then ?booking_token=).
982 $token = '';
983 if (is_array($data) && !empty($data['booking_token']) && is_string($data['booking_token'])) {
984 $token = sanitize_text_field((string) $data['booking_token']);
985 } elseif (isset($_GET['booking_token']) && is_string($_GET['booking_token'])) {
986 $token = sanitize_text_field((string) wp_unslash($_GET['booking_token']));
987 }
988 if ($token !== '' && is_array(get_transient($token))) {
989 return null;
990 }
991
992 // 4) an active server-side booking session.
993 if (function_exists('yatra_get_booking_session')) {
994 $session = yatra_get_booking_session();
995 if (!empty($session) && !empty($session['trip_id'])) {
996 return null;
997 }
998 }
999
1000 if (\Yatra\Security\Guard::denied('public_booking_csrf', [
1001 'route' => $request->get_route(),
1002 ])) {
1003 return new WP_REST_Response([
1004 'success' => false,
1005 'message' => __('Your session could not be verified. Please refresh the page and try again.', 'yatra'),
1006 ], 403);
1007 }
1008
1009 return null;
1010 }
1011
1012 /**
1013 * IDs of enabled email-type fields in a single form section.
1014 *
1015 * "Email type" follows the same rule as the admin form-builder's
1016 * "form captures email" notice: a field with type === 'email' OR the
1017 * conventional id === 'email'. Used so the booking email can be resolved
1018 * from a CUSTOM email field (e.g. id 'work_email') and not only the locked
1019 * core `email` field. On a default/un-customised form this returns
1020 * ['email'] for the contact section and [] for the traveler section, so
1021 * the downstream resolution collapses to the original behaviour.
1022 *
1023 * @param array<string,mixed> $section
1024 * @return array<int,string>
1025 */
1026 private function emailFieldIds(array $section): array
1027 {
1028 if (empty($section['fields']) || !is_array($section['fields'])) {
1029 return [];
1030 }
1031 $ids = [];
1032 foreach ($section['fields'] as $field) {
1033 if (!is_array($field)) {
1034 continue;
1035 }
1036 $enabled = !isset($field['enabled']) || (bool) $field['enabled'];
1037 $is_email = (($field['type'] ?? '') === 'email') || (($field['id'] ?? '') === 'email');
1038 if ($enabled && $is_email && !empty($field['id'])) {
1039 $ids[] = (string) $field['id'];
1040 }
1041 }
1042 return $ids;
1043 }
1044
1045 /**
1046 * Enforce required booking-form fields server-side (Dynamic Form module).
1047 *
1048 * Mirrors the frontend's required rules so a crafted request can't omit a
1049 * required field (built-in or CUSTOM). Only enabled+required fields in
1050 * enabled sections are checked, honouring the operator's saved config.
1051 * `email` and contact `phone` are skipped — they have dedicated handling
1052 * (email resolution + the contact-phone check). Returns an error message,
1053 * or null when everything required is present.
1054 *
1055 * @param array<string,mixed> $form_config
1056 * @param array<string,mixed> $data
1057 * @param array<int,mixed> $travelers
1058 */
1059 private function validateRequiredFormFields(
1060 array $form_config,
1061 array $data,
1062 array $travelers,
1063 bool $contact_enabled,
1064 bool $traveler_enabled
1065 ): ?string {
1066 $is_missing = static function ($value): bool {
1067 return !is_scalar($value) || trim((string) $value) === '';
1068 };
1069
1070 // --- Contact section (flat contact_<id> keys) ---
1071 if ($contact_enabled && !empty($form_config['contact_form']['fields']) && is_array($form_config['contact_form']['fields'])) {
1072 foreach ($form_config['contact_form']['fields'] as $field) {
1073 if (!is_array($field) || empty($field['enabled']) || empty($field['required']) || empty($field['id']) || ($field['type'] ?? '') === 'text_block') {
1074 continue;
1075 }
1076 $id = (string) $field['id'];
1077 if ($id === 'email' || $id === 'phone') {
1078 continue; // handled by the email resolution + contact-phone check
1079 }
1080 if ($is_missing($data['contact_' . $id] ?? null)) {
1081 /* translators: %s: form field label. */
1082 return sprintf(__('%s is required.', 'yatra'), (string) ($field['label'] ?? $id));
1083 }
1084 }
1085 }
1086
1087 // --- Emergency section (flat emergency_<id> keys) ---
1088 $emergency = $form_config['emergency_contact_form'] ?? null;
1089 $emergency_enabled = is_array($emergency) && (!isset($emergency['enabled']) || (bool) $emergency['enabled']);
1090 if ($emergency_enabled && !empty($emergency['fields']) && is_array($emergency['fields'])) {
1091 foreach ($emergency['fields'] as $field) {
1092 if (!is_array($field) || empty($field['enabled']) || empty($field['required']) || empty($field['id']) || ($field['type'] ?? '') === 'text_block') {
1093 continue;
1094 }
1095 $id = (string) $field['id'];
1096 if ($is_missing($data['emergency_' . $id] ?? null)) {
1097 /* translators: %s: emergency contact field label. */
1098 return sprintf(__('Emergency contact: %s is required.', 'yatra'), (string) ($field['label'] ?? $id));
1099 }
1100 }
1101 }
1102
1103 // --- Traveler section (per-traveler travelers[i][<id>]) ---
1104 // Skipped when the section is off (book-by-count synthesises travelers).
1105 if ($traveler_enabled && !empty($form_config['traveler_form']['fields']) && is_array($form_config['traveler_form']['fields'])) {
1106 $required_traveler_fields = [];
1107 foreach ($form_config['traveler_form']['fields'] as $field) {
1108 if (is_array($field) && !empty($field['enabled']) && !empty($field['required']) && !empty($field['id']) && ($field['type'] ?? '') !== 'text_block') {
1109 $required_traveler_fields[(string) $field['id']] = [
1110 'label' => (string) ($field['label'] ?? $field['id']),
1111 // "lead" fields are only required on the lead traveler;
1112 // absent/"all" is required on every traveler (legacy).
1113 'applies_to' => ($field['applies_to'] ?? 'all'),
1114 ];
1115 }
1116 }
1117 if (!empty($required_traveler_fields)) {
1118 $traveler_index = 0;
1119 foreach ($travelers as $traveler) {
1120 if (!is_array($traveler)) {
1121 continue;
1122 }
1123 // Only real travelers; skip any contact/emergency pseudo-entries.
1124 if (isset($traveler['type']) && $traveler['type'] !== 'traveler') {
1125 continue;
1126 }
1127 $traveler_index++;
1128 foreach ($required_traveler_fields as $fid => $meta) {
1129 // Lead-only required fields apply to Traveler 1 only.
1130 if (($meta['applies_to'] ?? 'all') === 'lead' && $traveler_index !== 1) {
1131 continue;
1132 }
1133 if ($is_missing($traveler[$fid] ?? null)) {
1134 /* translators: 1: traveler number, 2: field label. */
1135 return sprintf(__('Traveler %1$d: %2$s is required.', 'yatra'), $traveler_index, $meta['label']);
1136 }
1137 }
1138 }
1139 }
1140 }
1141
1142 return null;
1143 }
1144
1145 /**
1146 * Enforce per-group category size limits at booking time.
1147 *
1148 * A traveler category priced "per group" (pricing_mode === 'per_group')
1149 * charges one flat price for the whole group, bounded by an optional group
1150 * size range (min_pax / max_pax) configured on the category. This validates
1151 * the selected headcount for each such category against that range.
1152 *
1153 * It is a strict no-op for per-person categories and for per-group
1154 * categories that have no limit configured, so existing trips are
1155 * unaffected. Categories that aren't selected (count 0) are skipped.
1156 *
1157 * @param array<int, mixed> $price_types Resolved price types (carry pricing_mode/min_pax/max_pax).
1158 * @param array<int|string, mixed> $traveler_counts Selected count keyed by category id.
1159 * @return string|null Error message when a limit is violated, otherwise null.
1160 */
1161 private function validateGroupSizeLimits(array $price_types, array $traveler_counts): ?string
1162 {
1163 foreach ($price_types as $pt) {
1164 $pt = (array) $pt;
1165
1166 if (($pt['pricing_mode'] ?? 'per_person') !== 'per_group') {
1167 continue;
1168 }
1169
1170 $cid = $pt['category_id'] ?? null;
1171 if ($cid === null) {
1172 continue;
1173 }
1174
1175 // traveler_counts may be keyed by int or string category id.
1176 $count = (int) ($traveler_counts[(int) $cid]
1177 ?? $traveler_counts[(string) $cid]
1178 ?? 0);
1179 if ($count <= 0) {
1180 continue; // category not selected — nothing to validate
1181 }
1182
1183 $label = $pt['category_label'] ?? ($pt['label'] ?? __('group', 'yatra'));
1184 $min = (isset($pt['min_pax']) && $pt['min_pax'] !== null && $pt['min_pax'] !== '') ? (int) $pt['min_pax'] : null;
1185 $max = (isset($pt['max_pax']) && $pt['max_pax'] !== null && $pt['max_pax'] !== '') ? (int) $pt['max_pax'] : null;
1186 $overflow = ($pt['group_overflow'] ?? 'block') === 'per_block' ? 'per_block' : 'block';
1187
1188 if ($min !== null && $min > 0 && $count < $min) {
1189 /* translators: 1: category label, 2: minimum group size. */
1190 return sprintf(__('%1$s requires at least %2$d people.', 'yatra'), $label, $min);
1191 }
1192 // In "per_block" mode a party may exceed the max group size — it just
1193 // buys additional group blocks — so only enforce the max for "block".
1194 if ($overflow !== 'per_block' && $max !== null && $max > 0 && $count > $max) {
1195 /* translators: 1: category label, 2: maximum group size. */
1196 return sprintf(__('%1$s allows a maximum of %2$d people.', 'yatra'), $label, $max);
1197 }
1198 }
1199
1200 return null;
1201 }
1202
1203 public function create_booking(WP_REST_Request $request): WP_REST_Response
1204 {
1205 global $wpdb;
1206
1207 $data = $request->get_json_params();
1208
1209 // reCAPTCHA v3 — no-op unless the booking form is explicitly protected in
1210 // settings (off by default so payment flows are never gated unless the
1211 // operator opts in).
1212 $recaptcha = \Yatra\Services\RecaptchaService::verifyForm(
1213 'booking',
1214 (string) (($data['recaptcha_token'] ?? '') ?: ''),
1215 $_SERVER['REMOTE_ADDR'] ?? null
1216 );
1217 if (empty($recaptcha['success'])) {
1218 return new WP_REST_Response([
1219 'success' => false,
1220 'message' => $recaptcha['message'] ?? __('reCAPTCHA verification failed.', 'yatra'),
1221 ], 400);
1222 }
1223
1224 // ========================================
1225 // CSRF — booking-scoped action nonce
1226 // ========================================
1227 // The public_permission_callback on this route intentionally
1228 // bypasses WP's default cookie/nonce check so guests can hit it
1229 // at all. That bypass would otherwise leave the endpoint open
1230 // to cross-site forgery (any third-party page could POST a
1231 // booking using the visitor's session).
1232 //
1233 // We validate a booking-scoped action nonce here instead. The
1234 // token is minted at page-render time (FrontendAssetsProvider
1235 // injects it into `yatraBookingData.bookingNonce`) and the JS
1236 // forwards it in `X-Yatra-Booking-Nonce`. We also accept it in
1237 // the JSON body for any non-JS fallback flow.
1238 //
1239 // Returns 403 on failure — distinct from the 401 used by the
1240 // login/guest-checkout gates so frontends can distinguish
1241 // "security check failed" from "auth required".
1242 if (!$this->verifyBookingNonce($request, $data)) {
1243 return new WP_REST_Response([
1244 'success' => false,
1245 'message' => __('Security check failed. Please refresh the page and try again.', 'yatra'),
1246 'code' => 'invalid_nonce',
1247 ], 403);
1248 }
1249
1250 // ========================================
1251 // REMAINING PAYMENT vs NEW BOOKING
1252 // ========================================
1253 // A leftover PHP session from "pay remaining balance" must not hijack a normal
1254 // checkout POST (full traveler payload). Only treat as remaining-payment when the
1255 // client is actually on that flow (hidden field) or sends no new-booking travelers.
1256 // Early return: process_remaining_payment() — no createBooking().
1257 if (yatra_has_remaining_session()) {
1258 $is_remaining_checkout = !empty($data['is_remaining_payment']);
1259 $travelers_payload = $data['travelers'] ?? null;
1260 $has_new_booking_travelers = is_array($travelers_payload) && count($travelers_payload) > 0;
1261
1262 if ($is_remaining_checkout) {
1263 return $this->process_remaining_payment($request);
1264 }
1265
1266 if ($has_new_booking_travelers) {
1267 yatra_clear_remaining_session();
1268 } else {
1269 return $this->process_remaining_payment($request);
1270 }
1271 }
1272
1273 // ========================================
1274 // NEW BOOKING CHECKOUT (not pay-remaining)
1275 // ========================================
1276 // Below: createBooking() runs once; payment is initiated afterward if amount_due > 0.
1277
1278 // ========================================
1279 // GET BOOKING SETTINGS
1280 // ========================================
1281 $settings = [
1282 'booking_confirmation' => \Yatra\Services\SettingsService::get('booking_confirmation', true),
1283 'auto_confirm_bookings' => \Yatra\Services\SettingsService::get('auto_confirm_bookings', false),
1284 'require_login' => \Yatra\Services\SettingsService::get('require_login', false),
1285 'allow_guest_checkout' => \Yatra\Services\SettingsService::get('allow_guest_checkout', true),
1286 'booking_expiry_hours' => (int) \Yatra\Services\SettingsService::get('booking_expiry_hours', 24),
1287 'auto_confirm_pay_later' => \Yatra\Services\SettingsService::get('auto_confirm_pay_later', true),
1288 ];
1289
1290 // ========================================
1291 // CHECK LOGIN REQUIREMENT
1292 // ========================================
1293 if ($settings['require_login'] && !is_user_logged_in()) {
1294 return new WP_REST_Response([
1295 'success' => false,
1296 'message' => __('You must be logged in to make a booking.', 'yatra'),
1297 'code' => 'login_required',
1298 'login_url' => wp_login_url(home_url($_SERVER['REQUEST_URI'] ?? '')),
1299 ], 401);
1300 }
1301
1302 // Check guest checkout
1303 if (!$settings['allow_guest_checkout'] && !is_user_logged_in()) {
1304 return new WP_REST_Response([
1305 'success' => false,
1306 'message' => __('Guest checkout is not allowed. Please log in or create an account.', 'yatra'),
1307 'code' => 'guest_not_allowed',
1308 'login_url' => wp_login_url(home_url($_SERVER['REQUEST_URI'] ?? '')),
1309 ], 401);
1310 }
1311
1312 // ========================================
1313 // GUEST EMAIL VERIFICATION GATE
1314 // ========================================
1315 // When `require_guest_email_verification` is on AND the
1316 // customer is not logged in, the booking goes through a
1317 // two-step flow:
1318 // 1. Booking row is created with status='pending_verification'
1319 // so the operator sees the intent in the admin and the
1320 // cron can purge unverified rows after N days.
1321 // 2. A magic-link email is sent. Payment is NOT initiated
1322 // until the customer clicks the link.
1323 // 3. On click, /yatra/v1/booking/verify-email validates the
1324 // HMAC token, flips status to 'pending', and redirects
1325 // to the payment continuation URL.
1326 // Logged-in users skip this entirely — their email is already
1327 // verified by WordPress on registration.
1328 $needs_email_verification = !is_user_logged_in()
1329 && (bool) \Yatra\Services\SettingsService::get('require_guest_email_verification', false);
1330
1331 // Get session data
1332 $session = yatra_get_booking_session();
1333
1334 // REST requests don't always carry PHPSESSID in the same scope as the
1335 // page that rendered the booking form (cookie path mismatches, output
1336 // buffering before session_start, server-side caching, etc). When
1337 // `$session` is empty we try to rehydrate from the transient backup that
1338 // BookingPageHandler writes when the form is rendered — the JS submit
1339 // now carries `booking_token` in the request body for exactly this
1340 // recovery path. Without this, `traveler_counts` / `pricing_type` /
1341 // `price_types` are lost and a `traveler_based` trip's
1342 // calculatePricing() collapses to 0, then BookingService rejects with
1343 // "Total amount must be greater than zero."
1344 if ((empty($session) || empty($session['trip_id'])) && !empty($data['booking_token'])) {
1345 $tokenFromBody = sanitize_text_field((string) $data['booking_token']);
1346 if ($tokenFromBody !== '') {
1347 $transient_data = get_transient($tokenFromBody);
1348 if (is_array($transient_data) && !empty($transient_data['trip_id'])) {
1349 $session = $transient_data;
1350 }
1351 }
1352 }
1353
1354 // Validate we have session data or direct booking data
1355 $trip_id = !empty($data['trip_id']) ? (int) $data['trip_id'] : ($session['trip_id'] ?? 0);
1356
1357 if (!$trip_id) {
1358 return new WP_REST_Response([
1359 'success' => false,
1360 'message' => __('No trip selected for booking.', 'yatra'),
1361 ], 400);
1362 }
1363
1364 // Which booking-form sections are enabled (Pro Dynamic Form module).
1365 // The default config has every section enabled, so on existing/un-customised
1366 // sites $contact_enabled and $traveler_enabled are both true and the logic
1367 // below behaves exactly as before — only disabled sections change anything.
1368 $form_config = function_exists('yatra_get_booking_form_config') ? yatra_get_booking_form_config() : [];
1369 $contact_enabled = !isset($form_config['contact_form']['enabled']) || (bool) $form_config['contact_form']['enabled'];
1370 $traveler_enabled = !isset($form_config['traveler_form']['enabled']) || (bool) $form_config['traveler_form']['enabled'];
1371
1372 // Get contact email - handle both flat and nested formats
1373 $contact_email = trim((string) ($data['contact_email'] ?? ''));
1374 $contact_phone = $data['contact_phone'] ?? '';
1375 // International phone widget: fold the chosen country (companion
1376 // *_country field carrying the ISO) into the number as "+<dial><digits>".
1377 // A no-op for legacy submissions with no companion field, an already
1378 // "+"-prefixed value, or an unknown ISO — so existing data is never
1379 // altered and nothing is invented.
1380 $contact_phone = \Yatra\Helpers\FormatHelper::combineInternationalPhone(
1381 (string) $contact_phone,
1382 (string) ($data['contact_phone_country'] ?? '')
1383 );
1384 $contact_first_name = $data['contact_first_name'] ?? '';
1385 $contact_last_name = $data['contact_last_name'] ?? '';
1386 $contact_country = $data['contact_country'] ?? '';
1387
1388 $contact_nationality = $data['contact_nationality'] ?? '';
1389 $contact_address = $data['contact_address'] ?? '';
1390
1391 // Emergency contact
1392 $emergency_name = $data['emergency_name'] ?? '';
1393 $emergency_phone = \Yatra\Helpers\FormatHelper::combineInternationalPhone(
1394 (string) ($data['emergency_phone'] ?? ''),
1395 (string) ($data['emergency_phone_country'] ?? '')
1396 );
1397 $emergency_relationship = $data['emergency_relationship'] ?? '';
1398
1399 // Travel details
1400 $travel_date = $data['travel_date'] ?? ($session['travel_date'] ?? '');
1401 $travelers = $data['travelers'] ?? [];
1402
1403 // EMAIL RESOLUTION: prefer the Contact email. When it's missing — the
1404 // Contact section is off, or the operator collects email through a
1405 // CUSTOM email-type field rather than the locked core `email` field —
1406 // resolve it from the form config instead, mirroring the admin
1407 // "form captures email" notice (contact + traveler sections). At least
1408 // one enabled form must capture an email; the form builder warns the
1409 // operator about this too. On a default form the core `email` field
1410 // already populated $contact_email, so none of the fallbacks run.
1411
1412 // (a) Custom email-type field in the Contact section (submitted as
1413 // contact_<id>). The core `email` field is already read above, so skip
1414 // it here.
1415 if ($contact_email === '' && $contact_enabled) {
1416 foreach ($this->emailFieldIds($form_config['contact_form'] ?? []) as $fid) {
1417 if ($fid === 'email') {
1418 continue;
1419 }
1420 $val = trim((string) ($data['contact_' . $fid] ?? ''));
1421 if ($val !== '' && is_email($val)) {
1422 $contact_email = $val;
1423 break;
1424 }
1425 }
1426 }
1427
1428 // (b) Fall back to a traveler email — the conventional `email` key OR
1429 // any traveler email-type field — adopting the lead traveler's
1430 // name/phone as the contact when the Contact section is off, so the
1431 // booking/customer isn't nameless. On a default form this checks only
1432 // $t['email'], identical to the original behaviour.
1433 if ($contact_email === '' && is_array($travelers)) {
1434 $traveler_email_ids = $traveler_enabled
1435 ? $this->emailFieldIds($form_config['traveler_form'] ?? [])
1436 : [];
1437 if (!in_array('email', $traveler_email_ids, true)) {
1438 $traveler_email_ids[] = 'email';
1439 }
1440 foreach ($travelers as $t) {
1441 if (!is_array($t)) {
1442 continue;
1443 }
1444 $found = '';
1445 foreach ($traveler_email_ids as $fid) {
1446 if (!empty($t[$fid]) && is_email((string) $t[$fid])) {
1447 $found = trim((string) $t[$fid]);
1448 break;
1449 }
1450 }
1451 if ($found !== '') {
1452 $contact_email = $found;
1453 if ($contact_first_name === '') { $contact_first_name = (string) ($t['first_name'] ?? ''); }
1454 if ($contact_last_name === '') { $contact_last_name = (string) ($t['last_name'] ?? ''); }
1455 if (empty($contact_phone) && !empty($t['phone'])) { $contact_phone = (string) $t['phone']; }
1456 break;
1457 }
1458 }
1459 }
1460
1461 // When the Traveler form is disabled there are no per-traveler fields, so
1462 // build traveler rows from the selected count and use the lead contact as
1463 // traveler 1 (book-by-count). Only runs when the section is off.
1464 if (!$traveler_enabled && (empty($travelers) || !is_array($travelers))) {
1465 $synth_count = (int) ($data['travelers_count']
1466 ?? $session['travelers']
1467 ?? (is_array($session['traveler_counts'] ?? null) ? array_sum(array_map('intval', $session['traveler_counts'])) : 0));
1468 $synth_count = max(1, $synth_count);
1469 $travelers = [];
1470 for ($i = 1; $i <= $synth_count; $i++) {
1471 $travelers[] = [
1472 'type' => 'traveler',
1473 'first_name' => $i === 1 ? $contact_first_name : '',
1474 'last_name' => $i === 1 ? $contact_last_name : '',
1475 'email' => $i === 1 ? $contact_email : '',
1476 ];
1477 }
1478 }
1479
1480 // Validate required fields — email is always required (resolved above).
1481 if ($contact_email === '' || !is_email($contact_email)) {
1482 return new WP_REST_Response([
1483 'success' => false,
1484 'message' => __('A valid email address is required to complete this booking.', 'yatra'),
1485 ], 400);
1486 }
1487
1488 // Phone belongs to the Contact section. Require it only when that section
1489 // is enabled AND the phone field is itself enabled+required in the config,
1490 // so an operator who made phone optional (or disabled it) via the Dynamic
1491 // Form module isn't blocked on a field the customer never saw. On a
1492 // default form phone is locked+required, so this is unchanged for
1493 // existing Free/Pro users.
1494 $contact_phone_required = false;
1495 if ($contact_enabled && !empty($form_config['contact_form']['fields']) && is_array($form_config['contact_form']['fields'])) {
1496 foreach ($form_config['contact_form']['fields'] as $cf) {
1497 if (is_array($cf) && ($cf['id'] ?? '') === 'phone') {
1498 $cf_enabled = !isset($cf['enabled']) || (bool) $cf['enabled'];
1499 $contact_phone_required = $cf_enabled && !empty($cf['required']);
1500 break;
1501 }
1502 }
1503 } elseif ($contact_enabled) {
1504 // No field metadata available (legacy/edge): preserve the original
1505 // "require phone when contact is on" behaviour.
1506 $contact_phone_required = true;
1507 }
1508 if ($contact_phone_required && empty($contact_phone)) {
1509 return new WP_REST_Response([
1510 'success' => false,
1511 'message' => __('Phone number is required.', 'yatra'),
1512 ], 400);
1513 }
1514
1515 if (empty($travel_date)) {
1516 return new WP_REST_Response([
1517 'success' => false,
1518 'message' => __('Travel date is required.', 'yatra'),
1519 ], 400);
1520 }
1521
1522 if (empty($travelers) || !is_array($travelers)) {
1523 return new WP_REST_Response([
1524 'success' => false,
1525 'message' => __('At least one traveler is required.', 'yatra'),
1526 ], 400);
1527 }
1528
1529 // Server-side enforcement of required form fields (incl. CUSTOM fields).
1530 // Gated on the Dynamic Form Field module: free/default installs keep their
1531 // existing validation untouched. Mirrors the frontend's required rules so
1532 // a crafted request can't bypass them; respects the operator's config
1533 // (only enabled+required fields in enabled sections are checked).
1534 if (function_exists('apply_filters') && apply_filters('yatra_dynamic_form_field_enabled', false)) {
1535 $required_error = $this->validateRequiredFormFields(
1536 is_array($form_config) ? $form_config : [],
1537 $data,
1538 $travelers,
1539 $contact_enabled,
1540 $traveler_enabled
1541 );
1542 if ($required_error !== null) {
1543 return new WP_REST_Response([
1544 'success' => false,
1545 'message' => $required_error,
1546 ], 400);
1547 }
1548 }
1549
1550 // Get trip data
1551 $trip = $this->tripRepository->findPublished($trip_id);
1552
1553 if (!$trip) {
1554 return new WP_REST_Response([
1555 'success' => false,
1556 'message' => __('Trip not found.', 'yatra'),
1557 ], 404);
1558 }
1559
1560 // ========================================
1561 // PRICING via CalculationService (single source of truth)
1562 // ========================================
1563 // Count only actual travelers (exclude contact and emergency contact)
1564 $travelers_count = 0;
1565 foreach ($travelers as $traveler) {
1566 if (isset($traveler['type']) && $traveler['type'] === 'traveler') {
1567 $travelers_count++;
1568 }
1569 }
1570 // Fallback if no type is set (legacy data)
1571 if ($travelers_count === 0) {
1572 $travelers_count = count($travelers);
1573 }
1574
1575 $payment_method = strtolower(trim(sanitize_text_field($data['payment_method'] ?? ($session['payment_method'] ?? 'full'))));
1576 if ($payment_method === '') {
1577 $payment_method = 'full';
1578 }
1579 $payment_gateway = strtolower(trim(sanitize_text_field($data['payment_gateway'] ?? 'pay_later')));
1580
1581 // Get coupon code from request OR session
1582 $coupon_code = sanitize_text_field($data['coupon_code'] ?? '');
1583 if (empty($coupon_code) && !empty($session['coupon']['code'])) {
1584 $coupon_code = sanitize_text_field($session['coupon']['code']);
1585 }
1586
1587 $departure_time = $data['departure_time'] ?? ($session['departure_time'] ?? '');
1588 $additional_services = $data['additional_services'] ?? ($session['additional_services'] ?? []);
1589 $availability_id = $data['availability_id'] ?? ($session['availability_id'] ?? null);
1590
1591 // Build traveler_counts from travelers array or session
1592 $traveler_counts = [];
1593 if (!empty($data['traveler_counts']) && is_array($data['traveler_counts'])) {
1594 $traveler_counts = $data['traveler_counts'];
1595 } elseif (!empty($session['traveler_counts']) && is_array($session['traveler_counts'])) {
1596 $traveler_counts = $session['traveler_counts'];
1597 } else {
1598 // Build from travelers array if category_id is present
1599 foreach ($travelers as $traveler) {
1600 $categoryId = $traveler['category_id'] ?? null;
1601 if ($categoryId) {
1602 if (!isset($traveler_counts[$categoryId])) {
1603 $traveler_counts[$categoryId] = 0;
1604 }
1605 $traveler_counts[$categoryId]++;
1606 }
1607 }
1608 if (empty($traveler_counts) && $travelers_count > 0) {
1609 $traveler_counts['default'] = $travelers_count;
1610 }
1611 }
1612
1613 // Pricing single source of truth: ALWAYS use calculateFromSession.
1614 //
1615 // The booking session is kept in sync by the JS layer — every
1616 // service toggle, traveler-count change, and coupon apply/remove
1617 // POSTs to /booking/session, which updates the transient. The
1618 // sidebar's `/booking/summary` then renders from
1619 // `calculateFromSession($session, …)`. If we built a second pricing
1620 // path here from form fields, any subtle drift (form missing a
1621 // category_id, traveler_counts aggregated as 'default', etc) would
1622 // produce a different total than the customer saw — they'd be
1623 // charged something they didn't agree to. So we merge the latest
1624 // session with any form-submitted overrides (services list,
1625 // travel_date, availability_id) and let calculateFromSession do
1626 // the math the same way the sidebar did.
1627 $calculationService = new CalculationService();
1628 $session_for_pricing = is_array($session) ? $session : [];
1629 $session_for_pricing['trip_id'] = $trip_id;
1630 $session_for_pricing['travelers'] = $travelers_count;
1631 // Prefer per-category counts when we have them — otherwise let
1632 // calculateFromSession fall back to its internal handling.
1633 if (!empty($traveler_counts) && is_array($traveler_counts)) {
1634 $session_for_pricing['traveler_counts'] = $traveler_counts;
1635 }
1636 if (!empty($travel_date)) {
1637 $session_for_pricing['travel_date'] = $travel_date;
1638 }
1639 if (!empty($departure_time)) {
1640 $session_for_pricing['departure_time'] = $departure_time;
1641 }
1642 if (!empty($availability_id) && is_numeric($availability_id)) {
1643 $session_for_pricing['availability_id'] = (int) $availability_id;
1644 }
1645 if (is_array($additional_services)) {
1646 $session_for_pricing['additional_services'] = array_values(array_map('intval', $additional_services));
1647 }
1648
1649 try {
1650 $pricing = $calculationService->calculateFromSession(
1651 $session_for_pricing,
1652 $coupon_code,
1653 $payment_method
1654 );
1655 } catch (\Throwable $e) {
1656 $pricing = [];
1657 }
1658
1659 // If the session is so degenerate that even calculateFromSession
1660 // couldn't make a positive total (e.g. no traveler_counts at all),
1661 // surface that cleanly so the booking is rejected with a friendly
1662 // error rather than silently charging $0.
1663 if (((float) ($pricing['final_total'] ?? 0)) <= 0) {
1664 try {
1665 $sessionPricing = $calculationService->calculatePricing([
1666 'trip_id' => $trip_id,
1667 'travelers_count' => $travelers_count,
1668 'traveler_counts' => $traveler_counts,
1669 'travel_date' => $travel_date,
1670 'departure_time' => $departure_time,
1671 'selected_services' => $additional_services,
1672 'availability_id' => (!empty($availability_id) && is_numeric($availability_id)) ? (int) $availability_id : null,
1673 'coupon_code' => $coupon_code,
1674 'payment_method' => $payment_method,
1675 ]);
1676 if (((float) ($sessionPricing['final_total'] ?? 0)) > 0) {
1677 $pricing = $sessionPricing;
1678 }
1679 } catch (\Throwable $e) {
1680 // Keep $pricing as-is; downstream guard will surface a clean error.
1681 }
1682 }
1683
1684 // Enforce per-group category size limits (min_pax / max_pax). A per-group
1685 // category charges one flat price for a group within the configured
1686 // range, so a selection outside that range must be rejected before we
1687 // charge. No-op for per-person categories and categories with no limits.
1688 $group_size_error = $this->validateGroupSizeLimits($pricing['price_types'] ?? [], $traveler_counts);
1689 if ($group_size_error !== null) {
1690 return new WP_REST_Response([
1691 'success' => false,
1692 'message' => $group_size_error,
1693 ], 400);
1694 }
1695
1696 // Extract pricing results
1697 $total_amount = $pricing['final_total'];
1698 $amount_due = $pricing['amount_due'];
1699 $amount_paid = $pricing['amount_paid'];
1700 $tax_calculation = $pricing['tax_calculation'];
1701 $tax_breakdown = $tax_calculation['tax_breakdown'];
1702 $total_tax_amount = $tax_calculation['total_tax_amount'];
1703
1704 $tax_inclusive = $tax_calculation['tax_inclusive'];
1705 $tax_rate = $tax_calculation['tax_rate'];
1706 $subtotal_before_discount = $pricing['subtotal'];
1707 $discount_amount = $pricing['total_discount_amount'];
1708 $discount_code = $pricing['group_discount']['code'] ?? ($pricing['coupon_discount']['code'] ?? null);
1709
1710 // ========================================
1711 // CAPACITY / WAITLIST
1712 // ========================================
1713 $resolvedAvailabilityForWaitlist = null;
1714 if ($travel_date !== '') {
1715 try {
1716 $availResolutionSvc = new \Yatra\Services\AvailabilityResolutionService();
1717 $resolvedAvailabilityForWaitlist = $availResolutionSvc->resolveAvailabilityForDate(
1718 $trip_id,
1719 $travel_date,
1720 $departure_time !== '' ? $departure_time : null
1721 );
1722 } catch (\Throwable $e) {
1723 // Leave null; legacy checkout without strict availability still works
1724 }
1725 }
1726
1727 $isWaitlistCheckout = false;
1728
1729 if ($resolvedAvailabilityForWaitlist !== null) {
1730 $availStatus = (string) ($resolvedAvailabilityForWaitlist->status ?? 'available');
1731 if (in_array($availStatus, ['blocked', 'closed', 'cancelled', 'unavailable'], true)) {
1732 return new WP_REST_Response([
1733 'success' => false,
1734 'message' => __('This departure is not open for booking.', 'yatra'),
1735 'code' => 'date_blocked',
1736 ], 400);
1737 }
1738 // Respect explicit sold_out even if seats_available is stale — waitlist only if allowed
1739 if ($availStatus === 'sold_out') {
1740 if (\Yatra\Services\WaitlistService::canJoinWaitlist($trip, $resolvedAvailabilityForWaitlist, $travelers_count)) {
1741 $isWaitlistCheckout = true;
1742 } else {
1743 return new WP_REST_Response([
1744 'success' => false,
1745 'message' => __('This departure is sold out.', 'yatra'),
1746 'code' => 'sold_out',
1747 ], 400);
1748 }
1749 }
1750 }
1751
1752 if (
1753 !$isWaitlistCheckout
1754 && \Yatra\Services\WaitlistService::isInsufficientSeats($resolvedAvailabilityForWaitlist, $travelers_count)
1755 ) {
1756 if (\Yatra\Services\WaitlistService::canJoinWaitlist($trip, $resolvedAvailabilityForWaitlist, $travelers_count)) {
1757 $isWaitlistCheckout = true;
1758 } else {
1759 return new WP_REST_Response([
1760 'success' => false,
1761 'message' => __('This departure is full. Waitlist is not available for this trip or date.', 'yatra'),
1762 'code' => 'sold_out',
1763 ], 400);
1764 }
1765 }
1766
1767 // Generate booking reference using the same method as BookingService
1768 $bookingRepository = new \Yatra\Repositories\BookingRepository();
1769 $booking_reference = $bookingRepository->generateReference();
1770
1771 Logger::debug('Yatra booking create: pricing and payment selection', [
1772 'context' => 'booking_create_rest',
1773 'trip_id' => $trip_id,
1774 'booking_reference' => $booking_reference,
1775 'flexible_payments_enabled' => (bool) apply_filters('yatra_flexible_payments_enabled', false),
1776 'payment_method' => $payment_method,
1777 'payment_gateway' => $payment_gateway,
1778 'total_amount' => round((float) $total_amount, 4),
1779 'amount_due' => round((float) $amount_due, 4),
1780 'deposit_percentage' => (int) apply_filters('yatra_deposit_percentage', 20, ['trip_id' => $trip_id]),
1781 'partial_percentage' => (int) apply_filters('yatra_partial_payment_percentage', 30, ['trip_id' => $trip_id]),
1782 ]);
1783
1784 // Prepare contact data
1785 $contact_data = [
1786 'first_name' => sanitize_text_field($contact_first_name),
1787 'last_name' => sanitize_text_field($contact_last_name),
1788 'email' => sanitize_email($contact_email),
1789 'phone' => sanitize_text_field($contact_phone),
1790 'country' => sanitize_text_field($contact_country),
1791 'nationality' => sanitize_text_field($contact_nationality),
1792 'address' => sanitize_text_field($contact_address),
1793 ];
1794 // Persist every submitted contact_* field (incl. CUSTOM fields the
1795 // operator added to the form) so the data isn't lost and is usable as
1796 // {{contact_<id>}} email variables. Built-in keys above are not overwritten.
1797 foreach ($data as $field_key => $field_value) {
1798 if (is_string($field_key) && strpos($field_key, 'contact_') === 0 && is_scalar($field_value)) {
1799 $field_id = substr($field_key, strlen('contact_'));
1800 if ($field_id === '' || $field_id === 'data') {
1801 continue;
1802 }
1803 // A phone widget's `<field>_country` companion is folded into the
1804 // phone value below, not stored as its own field.
1805 if (substr($field_id, -8) === '_country' && isset($data[substr($field_key, 0, -8)])) {
1806 continue;
1807 }
1808 if (isset($contact_data[$field_id])) {
1809 continue;
1810 }
1811 $field_string = (string) $field_value;
1812 // Custom phone field: combine national number + country companion.
1813 if (isset($data[$field_key . '_country'])) {
1814 $field_string = \Yatra\Helpers\FormatHelper::combineInternationalPhone(
1815 $field_string,
1816 (string) $data[$field_key . '_country']
1817 );
1818 }
1819 $contact_data[$field_id] = sanitize_text_field($field_string);
1820 }
1821 }
1822
1823 // Prepare emergency contact data
1824 $emergency_data = [
1825 'name' => sanitize_text_field($emergency_name),
1826 'phone' => sanitize_text_field($emergency_phone),
1827 'relationship' => sanitize_text_field($emergency_relationship),
1828 ];
1829 // Same dynamic capture for emergency_* custom fields.
1830 foreach ($data as $field_key => $field_value) {
1831 if (is_string($field_key) && strpos($field_key, 'emergency_') === 0 && is_scalar($field_value)) {
1832 $field_id = substr($field_key, strlen('emergency_'));
1833 if ($field_id === '' || $field_id === 'contact') {
1834 continue;
1835 }
1836 if (substr($field_id, -8) === '_country' && isset($data[substr($field_key, 0, -8)])) {
1837 continue;
1838 }
1839 if (isset($emergency_data[$field_id])) {
1840 continue;
1841 }
1842 $field_string = (string) $field_value;
1843 if (isset($data[$field_key . '_country'])) {
1844 $field_string = \Yatra\Helpers\FormatHelper::combineInternationalPhone(
1845 $field_string,
1846 (string) $data[$field_key . '_country']
1847 );
1848 }
1849 $emergency_data[$field_id] = sanitize_text_field($field_string);
1850 }
1851 }
1852
1853 // Sanitize travelers data
1854 $sanitized_travelers = [];
1855 foreach ($travelers as $traveler) {
1856 if (is_array($traveler)) {
1857 $sanitized_traveler = [];
1858 foreach ($traveler as $key => $value) {
1859 $sk = sanitize_key((string) $key);
1860 // Skip a phone widget's `<field>_country` companion; it is
1861 // folded into the phone value in the pass below.
1862 if (substr($sk, -8) === '_country' && isset($traveler[substr((string) $key, 0, -8)])) {
1863 continue;
1864 }
1865 if (is_array($value)) {
1866 $sanitized_traveler[$sk] = array_map(static function ($v) {
1867 return sanitize_text_field(is_scalar($v) ? (string) $v : '');
1868 }, $value);
1869 } else {
1870 $sanitized_traveler[$sk] = sanitize_text_field((string) $value);
1871 }
1872 }
1873 // Combine each phone field with its country companion (national
1874 // number + dial code → "+<dial><digits>").
1875 foreach (array_keys($sanitized_traveler) as $tk) {
1876 $companion = $tk . '_country';
1877 if (isset($traveler[$companion]) && is_string($sanitized_traveler[$tk])) {
1878 $sanitized_traveler[$tk] = \Yatra\Helpers\FormatHelper::combineInternationalPhone(
1879 (string) $sanitized_traveler[$tk],
1880 (string) $traveler[$companion]
1881 );
1882 }
1883 }
1884 $sanitized_travelers[] = $sanitized_traveler;
1885 }
1886 }
1887
1888 // ========================================
1889 // CREATE WORDPRESS USER ACCOUNT (if requested)
1890 // ========================================
1891 $user_id = get_current_user_id();
1892 $create_account = !empty($data['create_account']) && !empty($data['account_password']);
1893
1894 if (!$user_id && $create_account && !empty($data['account_password'])) {
1895 $account_password = sanitize_text_field($data['account_password']);
1896 $account_password_confirm = sanitize_text_field($data['account_password_confirm'] ?? '');
1897
1898 // Validate password
1899 if (strlen($account_password) < 8) {
1900 return new WP_REST_Response([
1901 'success' => false,
1902 'message' => __('Password must be at least 8 characters long.', 'yatra'),
1903 ], 400);
1904 }
1905
1906 if ($account_password !== $account_password_confirm) {
1907 return new WP_REST_Response([
1908 'success' => false,
1909 'message' => __('Passwords do not match.', 'yatra'),
1910 ], 400);
1911 }
1912
1913 // Check if user already exists
1914 if (email_exists($contact_email)) {
1915 return new WP_REST_Response([
1916 'success' => false,
1917 'message' => __('An account with this email already exists. Please log in.', 'yatra'),
1918 ], 400);
1919 }
1920
1921 // Create WordPress user
1922 $username = sanitize_user(current(explode('@', $contact_email)));
1923 $original_username = $username;
1924 $counter = 1;
1925
1926 while (username_exists($username)) {
1927 $username = $original_username . $counter;
1928 $counter++;
1929 }
1930
1931 $user_id = wp_create_user($username, $account_password, $contact_email);
1932
1933 if (is_wp_error($user_id)) {
1934 return new WP_REST_Response([
1935 'success' => false,
1936 'message' => wp_strip_all_tags($user_id->get_error_message()),
1937 ], 400);
1938 }
1939
1940 // Assign Yatra Customer role
1941 $user = new \WP_User($user_id);
1942 $user->set_role('yatra_customer');
1943
1944 // Update user meta with contact information
1945 wp_update_user([
1946 'ID' => $user_id,
1947 'first_name' => $contact_data['first_name'],
1948 'last_name' => $contact_data['last_name'],
1949 'display_name' => $contact_data['first_name'] . ' ' . $contact_data['last_name'],
1950 ]);
1951
1952 if (!empty($contact_phone)) {
1953 update_user_meta($user_id, 'billing_phone', $contact_phone);
1954 update_user_meta($user_id, 'phone', $contact_phone);
1955 }
1956
1957 if (!empty($contact_country)) {
1958 update_user_meta($user_id, 'billing_country', $contact_country);
1959 }
1960
1961 if (!empty($contact_address)) {
1962 update_user_meta($user_id, 'billing_address_1', $contact_address);
1963 }
1964
1965 // Auto-login the user
1966 wp_set_current_user($user_id);
1967 wp_set_auth_cookie($user_id);
1968 }
1969
1970 // ========================================
1971 // CREATE OR UPDATE CUSTOMER
1972 // ========================================
1973 // Customers are separate from WordPress users - this is for CRM purposes
1974 $customer_id = null;
1975 try {
1976 $customer_id = $this->customerRepository->findOrCreate([
1977 'user_id' => $user_id ?: null,
1978 'first_name' => $contact_data['first_name'],
1979 'last_name' => $contact_data['last_name'],
1980 'email' => $contact_data['email'],
1981 'phone' => $contact_data['phone'],
1982 'address' => $contact_data['address'],
1983 'country' => $contact_data['country'],
1984 'nationality' => $contact_data['nationality'],
1985 'emergency_name' => $emergency_data['name'],
1986 'emergency_phone' => $emergency_data['phone'],
1987 'emergency_relationship' => $emergency_data['relationship'],
1988 'newsletter_optin' => !empty($data['subscribe_newsletter']),
1989 'total_spent' => $total_amount,
1990 'source' => 'booking',
1991 ]);
1992 } catch (\Exception $e) {
1993 // Log error but continue - customer creation is not critical
1994 }
1995
1996 // Create booking using BookingService
1997 $booking_service = new \Yatra\Services\BookingService();
1998
1999 $is_offline_gateway = $this->isOfflineGateway($payment_gateway);
2000
2001 // Ensure DB availability row is linked so inventory sync can subtract seats after booking.
2002 if (!$isWaitlistCheckout && empty($availability_id) && $trip_id > 0 && $travel_date !== '') {
2003 try {
2004 $dtForResolve = is_string($departure_time) ? trim($departure_time) : '';
2005 $dtForResolve = $dtForResolve !== '' ? $dtForResolve : null;
2006 $resolvedCheckout = (new \Yatra\Services\AvailabilityResolutionService())->resolveAvailabilityForDate(
2007 $trip_id,
2008 sanitize_text_field($travel_date),
2009 $dtForResolve
2010 );
2011 if (is_object($resolvedCheckout)
2012 && ($resolvedCheckout->source ?? '') === 'availability_date'
2013 && isset($resolvedCheckout->id)
2014 && is_numeric($resolvedCheckout->id)
2015 && (int) $resolvedCheckout->id > 0) {
2016 $availability_id = (int) $resolvedCheckout->id;
2017 }
2018 } catch (\Throwable $e) {
2019 // Recurring / trip-default checkout: no single availability_dates row
2020 }
2021 }
2022
2023 // Always defer createBooking's copy: session sends one rich confirmation at the end, or
2024 // transactional confirmation before payment redirect (see processPaymentGateway returns).
2025 $booking_data = [
2026 'reference' => $booking_reference,
2027 'trip_id' => $trip_id,
2028 'customer_id' => $customer_id,
2029 'user_id' => $user_id ?: null,
2030 'contact_first_name' => $contact_data['first_name'],
2031 'contact_last_name' => $contact_data['last_name'],
2032 'contact_email' => $contact_data['email'],
2033 'contact_phone' => $contact_data['phone'],
2034 'contact_country' => $contact_data['country'],
2035 'contact_data' => wp_json_encode($contact_data),
2036 'emergency_contact' => wp_json_encode($emergency_data),
2037 'travel_date' => sanitize_text_field($travel_date),
2038 'availability_id' => !empty($availability_id) ? (int) $availability_id : null,
2039 'departure_time' => is_string($departure_time) ? trim($departure_time) : '',
2040 'travelers_count' => $travelers_count,
2041 'total_amount' => $total_amount,
2042 'amount_paid' => 0,
2043 'amount_due' => $amount_due,
2044 'currency' => $pricing['currency'] ?? \Yatra\Services\SettingsService::getCurrency(),
2045 'discount_amount' => $discount_amount,
2046 'discount_code' => $discount_code,
2047 'payment_method' => $payment_method,
2048 'payment_gateway' => $payment_gateway,
2049 'status' => 'pending',
2050 'special_requests' => sanitize_textarea_field($data['special_requests'] ?? ''),
2051 'newsletter_optin' => !empty($data['subscribe_newsletter']) ? 1 : 0,
2052 'ip_address' => $this->getClientIp(),
2053 'created_at' => current_time('mysql'),
2054 'updated_at' => current_time('mysql'),
2055 // Tax fields
2056 'subtotal' => $subtotal_before_discount,
2057 'tax_amount' => $total_tax_amount,
2058 'tax_rate' => $tax_rate,
2059 'tax_inclusive' => $tax_inclusive,
2060 'tax_details' => wp_json_encode($tax_breakdown),
2061 // Itinerary costs
2062 'itinerary_costs' => wp_json_encode($pricing['itinerary_costs'] ?? []),
2063 'itinerary_costs_total' => ($pricing['itinerary_costs_total'] ?? 0),
2064 'skip_initial_customer_confirmation' => true,
2065 ];
2066
2067 if ($isWaitlistCheckout && $resolvedAvailabilityForWaitlist) {
2068 $booking_data['availability_id'] = (int) $resolvedAvailabilityForWaitlist->id;
2069 $booking_data['status'] = 'waitlist';
2070 // Preserve the customer's real OFFLINE gateway + deposit/partial
2071 // choice (Bank Transfer / Pay Later). No charge is taken for a
2072 // waitlisted slot regardless, and waitlist promotion only flips the
2073 // status — it never restores the selection — so pinning to
2074 // pay_later/full here would permanently drop the chosen gateway AND
2075 // wipe the deposit (BookingService recomputes amount_due from
2076 // payment_method). Online gateways stay deferred to pay_later/full
2077 // since a card can't be charged for a non-guaranteed slot.
2078 if (!$is_offline_gateway) {
2079 $booking_data['payment_gateway'] = 'pay_later';
2080 $booking_data['payment_method'] = 'full';
2081 }
2082 }
2083
2084 // Hold the booking in `pending_verification` until the guest
2085 // clicks the magic link. Payment is initiated only after the
2086 // status flips to 'pending' (in the verify-email endpoint).
2087 // We also pin the gateway to `pay_later` here because the
2088 // payment selection at this point would otherwise lock the
2089 // operator into a specific gateway before the customer has
2090 // even confirmed their email — better to defer that choice
2091 // until verification completes and the regular checkout
2092 // resumes.
2093 if ($needs_email_verification && !$isWaitlistCheckout) {
2094 $booking_data['status'] = 'pending_verification';
2095 // Defer the gateway choice ONLY for online gateways: a real charge
2096 // would otherwise lock the customer into a gateway before they have
2097 // confirmed their email. For OFFLINE gateways (Bank Transfer / Pay
2098 // Later) there is no charge to defer, and the verify-email endpoint
2099 // does not restore the selection afterwards — so pinning to
2100 // pay_later/full here would permanently drop the customer's chosen
2101 // gateway AND their deposit/partial amount (BookingService recomputes
2102 // amount_due from payment_method, so 'full' wipes the deposit).
2103 // Preserve the real selection for offline gateways.
2104 if (!$is_offline_gateway) {
2105 $booking_data['payment_gateway'] = 'pay_later';
2106 $booking_data['payment_method'] = 'full';
2107 }
2108 }
2109
2110 try {
2111 $booking = $booking_service->createBooking($booking_data);
2112 // BookingService returns ['success'=>bool, 'booking_id'=>int, ...]
2113 $booking_id = $booking['booking_id'] ?? $booking['id'] ?? null;
2114 if (empty($booking['success'])) {
2115 return new WP_REST_Response([
2116 'success' => false,
2117 'message' => $booking['message'] ?? __('Failed to create booking. Please try again.', 'yatra'),
2118 'error' => $booking['message'] ?? '',
2119 'errors' => $booking['errors'] ?? null,
2120 ], 500);
2121 }
2122 } catch (\Exception $e) {
2123 return new WP_REST_Response([
2124 'success' => false,
2125 'message' => __('Failed to create booking. Please try again.', 'yatra'),
2126 'error' => $e->getMessage(),
2127 ], 500);
2128 }
2129
2130 if (empty($booking_id)) {
2131 return new WP_REST_Response([
2132 'success' => false,
2133 'message' => __('Failed to create booking. Please try again.', 'yatra'),
2134 'error' => __('Booking ID was not generated.', 'yatra'),
2135 ], 500);
2136 }
2137
2138 if ($isWaitlistCheckout && $resolvedAvailabilityForWaitlist) {
2139 \Yatra\Services\WaitlistService::incrementAvailabilityWaitlistCount(
2140 (int) $resolvedAvailabilityForWaitlist->id,
2141 $travelers_count
2142 );
2143 }
2144
2145 // Get the actual booking reference from database
2146 $bookingRepository = new \Yatra\Repositories\BookingRepository();
2147 $saved_booking = $bookingRepository->find($booking_id);
2148 if ($saved_booking && !empty($saved_booking->reference)) {
2149 $booking_reference = $saved_booking->reference;
2150 }
2151
2152 // ========================================
2153 // SAVE ADDITIONAL SERVICES (Premium Feature)
2154 // ========================================
2155 /**
2156 * Action: Save additional services for the booking
2157 * Allows premium modules to save selected services with the booking
2158 *
2159 * @param int $booking_id The booking ID
2160 * @param int $trip_id The trip ID
2161 * @param array $data The booking request data (contains selected_services)
2162 * @param int $travelers_count Total number of travelers
2163 * @param int $duration_days Trip duration in days
2164 * @param float $base_amount Trip base price (pre-services, pre-discount) —
2165 * the authoritative base used by the pricing engine for this
2166 * booking. Listeners persisting percentage-type services price
2167 * them against this exact value so the saved line-items reconcile
2168 * with the charged total. Added in a backward-compatible way:
2169 * existing 5-arg listeners simply ignore it.
2170 * @since 3.0.0
2171 */
2172 // Normalise: Pro module reads $data['selected_services'], frontend sends $data['additional_services']
2173 if (!isset($data['selected_services'])) {
2174 $data['selected_services'] = $data['additional_services']
2175 ?? $session['additional_services']
2176 ?? [];
2177 }
2178 if (!is_array($data['selected_services'])) {
2179 $data['selected_services'] = [];
2180 }
2181 $data['selected_services'] = array_map('intval', $data['selected_services']);
2182 do_action('yatra_booking_save_services', $booking_id, $trip_id, $data, $travelers_count, (int) ($trip->duration_days ?? 1), (float) ($pricing['base_amount'] ?? 0));
2183
2184 // ========================================
2185 // SAVE TRAVELLERS TO NORMALIZED TABLES
2186 // ========================================
2187 // Each traveller is saved to yatra_booking_travellers table
2188 // Their dynamic fields are saved to yatra_booking_traveller_meta table
2189 foreach ($sanitized_travelers as $index => $traveler_fields) {
2190 // First traveller (index 0) is always the lead traveller
2191 $is_lead = ($index === 0);
2192
2193 // Create traveller record with all their fields stored in meta
2194 $this->travellerRepository->create(
2195 $booking_id,
2196 $index,
2197 $is_lead,
2198 $traveler_fields
2199 );
2200 }
2201
2202 if ($isWaitlistCheckout && $resolvedAvailabilityForWaitlist) {
2203 yatra_clear_booking_session();
2204 if ($settings['booking_confirmation']) {
2205 $booking_service->sendNewBookingTransactionalConfirmation((int) $booking_id);
2206 }
2207
2208 return new WP_REST_Response([
2209 'success' => true,
2210 'message' => __('You are on the waitlist. We will contact you if a space opens up.', 'yatra'),
2211 'data' => [
2212 'booking_id' => $booking_id,
2213 'reference' => $booking_reference,
2214 'status' => 'waitlist',
2215 'waitlist' => true,
2216 'redirect_url' => $this->getConfirmationUrl($booking_reference),
2217 'customer_email' => $contact_data['email'],
2218 'customer_name' => trim($contact_data['first_name'] . ' ' . $contact_data['last_name']),
2219 'trip_id' => $trip_id,
2220 'trip_date' => $travel_date,
2221 'currency' => $pricing['currency'] ?? \Yatra\Services\SettingsService::getCurrency(),
2222 'total_amount' => $total_amount,
2223 'amount_due' => $amount_due,
2224 ],
2225 ]);
2226 }
2227
2228 // Departure link + booked_count: handled inside BookingService::createBooking (and inventory sync hooks).
2229 // Persist travel window on the booking row for reporting (optional columns).
2230 if (!empty($travel_date)) {
2231 try {
2232 $start_date = $travel_date;
2233 $duration_days = !empty($trip->duration_days) ? (int) $trip->duration_days : 1;
2234 $end_date = date('Y-m-d', strtotime($start_date . ' + ' . ($duration_days - 1) . ' days'));
2235 $bookingColumns = $this->bookingRepository->getTableColumns();
2236 $bookingUpdateData = [];
2237 if (in_array('start_date', $bookingColumns, true)) {
2238 $bookingUpdateData['start_date'] = $start_date;
2239 }
2240 if (in_array('end_date', $bookingColumns, true)) {
2241 $bookingUpdateData['end_date'] = $end_date;
2242 }
2243 if ($bookingUpdateData !== []) {
2244 $this->bookingRepository->update($booking_id, $bookingUpdateData);
2245 }
2246 } catch (\Exception $e) {
2247 // Non-fatal
2248 }
2249 }
2250
2251 // Clear booking session
2252 yatra_clear_booking_session();
2253
2254 // ========================================
2255 // GUEST EMAIL VERIFICATION — INTERCEPT
2256 // ========================================
2257 // Booking row + travelers + services are already saved at
2258 // this point with status='pending_verification'. Send the
2259 // magic-link email, return a structured "check your email"
2260 // response, and DO NOT initiate payment. The customer's
2261 // click on the verify-email endpoint transitions the booking
2262 // to 'pending' and emits the payment-continuation URL.
2263 if ($needs_email_verification) {
2264 $verify_url = \Yatra\Services\GuestVerificationTokenService::buildVerifyUrl(
2265 (int) $booking_id,
2266 (string) $contact_data['email']
2267 );
2268
2269 // Variables piped into the template email. All standard
2270 // booking merge tags resolve normally (the row exists);
2271 // we also pass intro_paragraph + footer_note + the
2272 // expiry banner so operators that haven't customised
2273 // the template still get good defaults.
2274 $email_vars = [];
2275 if ($saved_booking !== null) {
2276 $email_vars = \Yatra\Services\TransactionalEmailTemplateService::variablesFromBooking($saved_booking);
2277 }
2278 // Belt-and-braces: ensure customer name + email are
2279 // populated even when variablesFromBooking returned an
2280 // empty shell (which shouldn't happen, but if it does
2281 // we don't want the email to render "Hi ,").
2282 $email_vars['customer_email'] = (string) ($email_vars['customer_email'] ?? $contact_data['email']);
2283 $email_vars['customer_name'] = (string) ($email_vars['customer_name']
2284 ?? trim(($contact_data['first_name'] ?? '') . ' ' . ($contact_data['last_name'] ?? '')));
2285 $email_vars['customer_first_name'] = (string) ($email_vars['customer_first_name']
2286 ?? ($contact_data['first_name'] ?? ''));
2287 $email_vars['verification_link'] = $verify_url;
2288 $email_vars['intro_paragraph'] = __(
2289 "Thanks for booking with us! To confirm this is really your email, please click the button below. Your booking is held for you in the meantime — payment isn't taken until you verify.",
2290 'yatra'
2291 );
2292 $email_vars['footer_note'] = __(
2293 "If you didn't make this booking, you can safely ignore this email — no charges have been made.",
2294 'yatra'
2295 );
2296 $email_vars['expiry_notice_html'] = '<strong>'
2297 . esc_html__('This link expires in 48 hours.', 'yatra')
2298 . '</strong>';
2299
2300 // Guest-checkout verification prefers the operator's CONFIGURED
2301 // customer verification template so their customisation is honoured
2302 // (the guest system template was consolidated away — using the guest
2303 // type always fell back to the built-in default and ignored the
2304 // configured one). This email MUST still carry the verification link
2305 // — a guest can't complete the booking without it — so we only fall
2306 // back to the built-in GUEST default when the effective customer
2307 // template would omit {{verification_link}} (an operator can, and on
2308 // real sites does, customise that template and drop the tag). The
2309 // check respects Pro-owned DB templates too. Booking copy is injected
2310 // above via intro_paragraph / footer_note / expiry merge vars.
2311 //
2312 // Keep the booking-specific SUBJECT line ("Verify your email to
2313 // complete your booking") that guests saw before the guest template
2314 // was consolidated away — reusing the customer template body must not
2315 // drag along the account-oriented "Verify your email address"
2316 // subject. This is honoured additively by the renderer / Pro sender
2317 // via the reserved `_subject_override` var, so only this guest send
2318 // is affected. Computed before it is stored, so the render below
2319 // resolves the clean guest subject (no self-reference).
2320 $email_vars['_subject_override'] = \Yatra\Services\TransactionalEmailTemplateService::render(
2321 \Yatra\Services\TransactionalEmailTemplateService::TYPE_GUEST_EMAIL_VERIFICATION,
2322 $email_vars
2323 )['subject'];
2324 $verificationEmailSent = false;
2325 if (\Yatra\Services\TransactionalEmailTemplateService::templateRendersVerificationLink(
2326 \Yatra\Services\TransactionalEmailTemplateService::TYPE_CUSTOMER_EMAIL_VERIFICATION
2327 )) {
2328 $verificationEmailSent = \Yatra\Services\TransactionalEmailTemplateService::sendIfEnabled(
2329 \Yatra\Services\TransactionalEmailTemplateService::TYPE_CUSTOMER_EMAIL_VERIFICATION,
2330 (string) $contact_data['email'],
2331 $email_vars
2332 );
2333 }
2334 // Guarantee a verification email even if the customer template would
2335 // drop the link OR its per-type toggle is disabled — a guest can't
2336 // complete checkout without it. The built-in GUEST default always
2337 // carries the link. sendIfEnabled() returns whether it actually sent,
2338 // so this only fires when the preferred send did not (no double send).
2339 if (!$verificationEmailSent) {
2340 \Yatra\Services\TransactionalEmailTemplateService::sendIfEnabled(
2341 \Yatra\Services\TransactionalEmailTemplateService::TYPE_GUEST_EMAIL_VERIFICATION,
2342 (string) $contact_data['email'],
2343 $email_vars
2344 );
2345 }
2346
2347 return new WP_REST_Response([
2348 'success' => true,
2349 'code' => 'email_verification_required',
2350 'message' => __(
2351 "We've sent a verification email to your address. Click the link in that email to complete your booking — your spot is being held while you verify.",
2352 'yatra'
2353 ),
2354 'data' => [
2355 'booking_id' => $booking_id,
2356 'reference' => $booking_reference,
2357 'email' => $contact_data['email'],
2358 'expires_in_seconds' => (int) apply_filters('yatra_guest_verification_ttl_seconds', 48 * 3600),
2359 ],
2360 ]);
2361 }
2362
2363 // Check if this is an offline gateway
2364 $is_offline = $is_offline_gateway;
2365
2366 // For online gateways, create payment intent and return redirect URL
2367 if (!$is_offline && $amount_due > 0) {
2368 // Build payment params - merge with request data so gateways can access their own tokens
2369 $payment_params = array_merge($data, [
2370 'booking_id' => $booking_id,
2371 'reference' => $booking_reference,
2372 'amount' => $amount_due,
2373 'currency' => $pricing['currency'] ?? \Yatra\Services\SettingsService::getCurrency(),
2374 'customer_email' => $contact_data['email'],
2375 'customer_name' => $contact_data['first_name'] . ' ' . $contact_data['last_name'],
2376 'trip_title' => $trip->title,
2377 ]);
2378
2379 // Process payment based on gateway
2380 $payment_result = $this->processPaymentGateway($payment_gateway, $payment_params);
2381
2382 if ($payment_result['success']) {
2383 // Handle redirect-based gateways (PayPal, eSewa, Khalti, etc.)
2384 if (!empty($payment_result['payment_url'])) {
2385 if ($settings['booking_confirmation']) {
2386 $booking_service->sendNewBookingTransactionalConfirmation((int) $booking_id);
2387 }
2388 return new WP_REST_Response([
2389 'success' => true,
2390 'message' => __('Booking created. Redirecting to payment...', 'yatra'),
2391 'data' => [
2392 'booking_id' => $booking_id,
2393 'reference' => $booking_reference,
2394 'payment_url' => $payment_result['payment_url'],
2395 ],
2396 ]);
2397 }
2398
2399 // Handle client-side payment gateways (Stripe, Razorpay, Square, etc.)
2400 if (!empty($payment_result['requires_action'])) {
2401 if ($settings['booking_confirmation']) {
2402 $booking_service->sendNewBookingTransactionalConfirmation((int) $booking_id);
2403 }
2404 return new WP_REST_Response([
2405 'success' => true,
2406 'message' => __('Booking created. Complete payment...', 'yatra'),
2407 'data' => array_merge([
2408 'booking_id' => $booking_id,
2409 'reference' => $booking_reference,
2410 ], $payment_result),
2411 ]);
2412 }
2413 }
2414
2415 // If payment processing failed, return error so user can fix the issue
2416 if (!$payment_result['success']) {
2417 $errorMessage = $payment_result['error'] ?? $payment_result['message'] ?? __('Payment processing failed. Please try again.', 'yatra');
2418 return new WP_REST_Response([
2419 'success' => false,
2420 'message' => $errorMessage,
2421 'data' => [
2422 'booking_id' => $booking_id,
2423 'reference' => $booking_reference,
2424 'payment_error' => true,
2425 ],
2426 ]);
2427 }
2428 }
2429
2430 // ========================================
2431 // DETERMINE BOOKING STATUS
2432 // ========================================
2433 // Priority:
2434 // 1. auto_confirm_bookings setting (confirms ALL bookings automatically)
2435 // 2. For pay_later: auto_confirm_pay_later setting
2436 // 3. For bank_transfer: always pending until verified
2437
2438 $booking_status = 'pending';
2439 $status_message = __('Booking received!', 'yatra');
2440
2441 // Check if auto-confirm all bookings is enabled
2442 if ($settings['auto_confirm_bookings']) {
2443 // Auto-confirm is enabled - confirm immediately regardless of payment
2444 $booking_status = 'confirmed';
2445 $status_message = __('Booking confirmed!', 'yatra');
2446 } elseif ($payment_gateway === 'pay_later') {
2447 // Pay Later: Check the specific pay_later auto-confirm setting
2448 if ($settings['auto_confirm_pay_later']) {
2449 $booking_status = 'confirmed';
2450 $status_message = __('Booking confirmed! Payment will be collected later.', 'yatra');
2451 } else {
2452 $booking_status = 'pending';
2453 $status_message = __('Booking received! We will contact you to arrange payment.', 'yatra');
2454 }
2455 } elseif ($payment_gateway === 'bank_transfer') {
2456 // Bank Transfer: Always pending until payment is verified by admin
2457 $booking_status = 'pending';
2458 $status_message = __('Booking received! Please complete the bank transfer. We will confirm once payment is verified.', 'yatra');
2459 }
2460
2461 // Calculate booking expiry time for pending bookings
2462 $expiry_datetime = null;
2463 if ($booking_status === 'pending' && $settings['booking_expiry_hours'] > 0) {
2464 $expiry_datetime = date('Y-m-d H:i:s', strtotime('+' . $settings['booking_expiry_hours'] . ' hours'));
2465 }
2466
2467 // Set confirmed_at if auto-confirmed
2468 $confirmed_at = ($booking_status === 'confirmed') ? current_time('mysql') : null;
2469
2470 // Update booking status with additional metadata
2471 $update_data = [
2472 'status' => $booking_status,
2473 'payment_status' => 'pending', // No payment made yet for offline gateways
2474 ];
2475
2476 if ($confirmed_at) {
2477 $update_data['confirmed_at'] = $confirmed_at;
2478 }
2479
2480 if ($expiry_datetime) {
2481 $update_data['expires_at'] = $expiry_datetime;
2482 }
2483
2484 // Use repository to update booking
2485 $this->bookingRepository->update($booking_id, $update_data);
2486
2487 /**
2488 * yatra_booking_created already fired from BookingService::createBooking — do not fire again here
2489 * (duplicate admin + Pro automation).
2490 *
2491 * Synthetic pending→confirmed on the same request duplicates Pro "booking.confirmed" sequences with the
2492 * checkout confirmation email. Skip by default; restore with:
2493 * add_filter('yatra_skip_checkout_autoconfirm_status_changed_event', '__return_false');
2494 */
2495 if ($booking_status === 'confirmed') {
2496 if (!apply_filters('yatra_skip_checkout_autoconfirm_status_changed_event', true, (int) $booking_id, 'pending', 'confirmed')) {
2497 do_action('yatra_booking_status_changed', (int) $booking_id, 'pending', 'confirmed');
2498 }
2499 // Trip Consent / Google Calendar listen on `yatra_booking_confirmed` (not fired by status_changed skip above).
2500 \yatra_trigger_booking_confirmed((int) $booking_id, 'pending');
2501 }
2502
2503 // ========================================
2504 // SEND CONFIRMATION EMAIL
2505 // ========================================
2506 if ($settings['booking_confirmation']) {
2507 $this->sendBookingConfirmationEmail($booking_id, $booking_reference, $trip, [
2508 'contact' => $contact_data,
2509 'emergency' => $emergency_data,
2510 'travelers' => $sanitized_travelers,
2511 'travel_date' => $travel_date,
2512 'payment_method' => $payment_method,
2513 'payment_gateway' => $payment_gateway,
2514 'total_amount' => $total_amount,
2515 'amount_due' => $amount_due,
2516 'booking_status' => $booking_status,
2517 'expiry_datetime' => $expiry_datetime,
2518 ]);
2519 }
2520
2521 return new WP_REST_Response([
2522 'success' => true,
2523 'message' => $status_message,
2524 'data' => [
2525 'booking_id' => $booking_id,
2526 'reference' => $booking_reference,
2527 'status' => $booking_status,
2528 'payment_status' => 'pending',
2529 'redirect_url' => $this->getConfirmationUrl($booking_reference),
2530 'customer_email' => $contact_data['email'],
2531 'customer_name' => trim($contact_data['first_name'] . ' ' . $contact_data['last_name']),
2532 'trip_id' => $trip_id,
2533 'trip_date' => $travel_date,
2534 'currency' => $pricing['currency'] ?? \Yatra\Services\SettingsService::getCurrency(),
2535 'amount' => $amount_due,
2536 'subtotal' => $subtotal_before_discount,
2537 'discount_amount' => $discount_amount,
2538 'discount_code' => $discount_code,
2539 'total_amount' => $total_amount,
2540 ],
2541 ]);
2542 }
2543
2544
2545 /**
2546 * Get confirmation page URL (see yatra_get_booking_confirmation_url()).
2547 */
2548 private function getConfirmationUrl(string $reference): string
2549 {
2550 return yatra_get_booking_confirmation_url($reference);
2551 }
2552
2553 /**
2554 * Whether the gateway completes without an external payment step (registry flag + fallback).
2555 */
2556 private function isOfflineGateway(string $gatewayId): bool
2557 {
2558 try {
2559 $registry = \Yatra\PaymentGateways\PaymentGatewayRegistry::getInstance();
2560 $gateway = $registry->get($gatewayId);
2561 if ($gateway) {
2562 return $gateway->isOffline();
2563 }
2564 } catch (\Throwable $e) {
2565 // Fall through to legacy IDs
2566 }
2567
2568 return in_array($gatewayId, ['pay_later', 'bank_transfer'], true);
2569 }
2570
2571 /**
2572 * Pay balance due on an existing booking only.
2573 *
2574 * Does not call BookingService::createBooking() or insert a second booking row.
2575 * Initiates gateway flow with the stored booking_id; on success, payment is recorded
2576 * via PaymentGatewayController::handle_successful_payment, webhooks, or recordGatewayPayment
2577 * — same completion paths as initial checkout.
2578 */
2579 private function process_remaining_payment(WP_REST_Request $request): WP_REST_Response
2580 {
2581 $data = $request->get_json_params();
2582 if (!is_array($data)) {
2583 $data = [];
2584 }
2585 $payment_gateway = strtolower(trim(sanitize_text_field($data['payment_gateway'] ?? 'pay_later')));
2586
2587 $session = yatra_get_remaining_session();
2588
2589 $booking_id = (int) ($session['booking_id'] ?? 0);
2590 $booking_reference = (string) ($session['booking_reference'] ?? '');
2591 $currency = (string) ($session['currency'] ?? '');
2592 $contact_email = (string) ($session['contact_email'] ?? '');
2593 $contact_first_name = (string) ($session['contact_first_name'] ?? '');
2594 $contact_last_name = (string) ($session['contact_last_name'] ?? '');
2595 $trip_id = (int) ($session['trip_id'] ?? 0);
2596 $trip_title = (string) ($session['trip_title'] ?? '');
2597 $travel_date = (string) ($session['travel_date'] ?? '');
2598
2599 if ($booking_id <= 0) {
2600 return new WP_REST_Response([
2601 'success' => false,
2602 'message' => __('Invalid booking for remaining payment.', 'yatra'),
2603 ], 400);
2604 }
2605
2606 $booking = $this->bookingRepository->find($booking_id);
2607 if (!$booking) {
2608 yatra_clear_remaining_session();
2609 return new WP_REST_Response([
2610 'success' => false,
2611 'message' => __('Booking not found.', 'yatra'),
2612 ], 404);
2613 }
2614
2615 if ($booking_reference === '' && !empty($booking->reference)) {
2616 $booking_reference = (string) $booking->reference;
2617 }
2618
2619 // Authoritative balance from DB (do not rely on session alone)
2620 $remaining_amount = (float) ($booking->amount_due ?? 0);
2621 if ($remaining_amount <= 0 && isset($booking->total_amount)) {
2622 $remaining_amount = max(
2623 0,
2624 (float) $booking->total_amount - (float) ($booking->amount_paid ?? 0)
2625 );
2626 }
2627
2628 if ($remaining_amount <= 0) {
2629 yatra_clear_remaining_session();
2630 return new WP_REST_Response([
2631 'success' => false,
2632 'message' => __('This booking is already fully paid.', 'yatra'),
2633 ], 400);
2634 }
2635
2636 // Verify user owns this booking
2637 $current_user = get_current_user_id();
2638 if ($current_user && (int) $booking->user_id !== $current_user) {
2639 yatra_clear_remaining_session();
2640 return new WP_REST_Response([
2641 'success' => false,
2642 'message' => __('You do not have permission to pay for this booking.', 'yatra'),
2643 ], 403);
2644 }
2645
2646 if ($currency === '') {
2647 $currency = (string) ($booking->currency ?? SettingsService::getCurrency());
2648 }
2649
2650 // Use contact info from session or booking
2651 $customer_email = $contact_email !== '' ? $contact_email : (string) ($booking->contact_email ?? $booking->customer_email ?? '');
2652 $customer_name = trim($contact_first_name . ' ' . $contact_last_name);
2653 if ($customer_name === '') {
2654 $customer_name = trim(($booking->contact_first_name ?? '') . ' ' . ($booking->contact_last_name ?? ''));
2655 }
2656
2657 if ($customer_email === '') {
2658 return new WP_REST_Response([
2659 'success' => false,
2660 'message' => __('Email address is required.', 'yatra'),
2661 ], 400);
2662 }
2663
2664 $is_offline_gateway = $this->isOfflineGateway($payment_gateway);
2665
2666 // Server-side guard: offline gateways (Pay Later, Bank Transfer, etc.) don't
2667 // actually collect money. Letting them be selected for a remaining-balance
2668 // payment leaves the booking unpaid while the customer thinks they finished
2669 // the flow. The frontend already filters them out for this checkout — this
2670 // catches a tampered client. Filterable so a custom Pay Later that does
2671 // settle can opt back in.
2672 $allow_offline_for_remaining = (bool) apply_filters(
2673 'yatra_remaining_payment_allow_offline_gateway',
2674 false,
2675 $payment_gateway,
2676 $booking
2677 );
2678 if ($is_offline_gateway && !$allow_offline_for_remaining) {
2679 return new WP_REST_Response([
2680 'success' => false,
2681 'message' => __('This payment method cannot be used to settle a remaining balance. Please choose a card-based gateway.', 'yatra'),
2682 'data' => [
2683 'rejected_gateway' => $payment_gateway,
2684 'reason' => 'offline_not_allowed_for_remaining_payment',
2685 ],
2686 ], 400);
2687 }
2688
2689 // Online gateways: delegate to the same flow as new-booking checkout (PayPal redirect, Stripe intent, etc.).
2690 // Do not put confirmation URL in redirect_url here — that caused the browser to skip payment entirely.
2691 if (!$is_offline_gateway && $remaining_amount > 0) {
2692 // The gateway needs an explicit return URL with the `balance=paid` flag so the
2693 // confirmation page can show "balance just paid" content. Without setting it
2694 // here, processPaymentWithGateway() would fall back to a plain confirmation URL
2695 // and the customer would land on the generic post-booking template.
2696 $remaining_return_url = add_query_arg(
2697 'balance',
2698 'paid',
2699 $this->getConfirmationUrl($booking_reference)
2700 );
2701
2702 $payment_params = array_merge($data, [
2703 'booking_id' => $booking_id,
2704 'reference' => $booking_reference,
2705 'amount' => $remaining_amount,
2706 'currency' => $currency,
2707 'customer_email' => $customer_email,
2708 'customer_name' => $customer_name !== '' ? $customer_name : $customer_email,
2709 'trip_title' => $trip_title,
2710 'return_url' => $remaining_return_url,
2711 ]);
2712
2713 $payment_result = $this->processPaymentGateway($payment_gateway, $payment_params);
2714
2715 if (!empty($payment_result['success'])) {
2716 // Common identity fields the Stripe.js / PayPal SDK frontend expects on
2717 // the response. process_remaining_payment is reached without going through
2718 // the new-booking checkout, so the gateway result alone is missing
2719 // customer_email / customer_name — re-attach them from the booking we
2720 // already loaded above. Also overwrite confirmation_url AND redirect_url
2721 // with the balance-tagged version so the post-payment landing page knows
2722 // this was a remaining-balance flow.
2723 //
2724 // Why both fields: the Stripe.js helper buildConfirmationUrlFromBookingInfo()
2725 // prefers bookingInfo.redirect_url and only falls back to rebuilding the URL
2726 // from scratch (without query params) when redirect_url is absent. Without
2727 // redirect_url being explicitly set here the `?balance=paid` flag would be
2728 // lost on the final navigation after Stripe success.
2729 $remaining_identity_fields = [
2730 'customer_email' => $customer_email,
2731 'customer_name' => $customer_name,
2732 'confirmation_url' => $remaining_return_url,
2733 'redirect_url' => $remaining_return_url,
2734 ];
2735
2736 if (!empty($payment_result['payment_url'])) {
2737 return new WP_REST_Response([
2738 'success' => true,
2739 'message' => __('Redirecting to payment...', 'yatra'),
2740 'data' => array_merge([
2741 'booking_id' => $booking_id,
2742 'reference' => $booking_reference,
2743 'payment_url' => $payment_result['payment_url'],
2744 'is_remaining_payment' => true,
2745 ], $remaining_identity_fields),
2746 ]);
2747 }
2748
2749 if (!empty($payment_result['requires_action'])) {
2750 return new WP_REST_Response([
2751 'success' => true,
2752 'message' => __('Complete payment...', 'yatra'),
2753 'data' => array_merge(
2754 [
2755 'booking_id' => $booking_id,
2756 'reference' => $booking_reference,
2757 'is_remaining_payment' => true,
2758 ],
2759 $payment_result,
2760 $remaining_identity_fields
2761 ),
2762 ]);
2763 }
2764
2765 if (!empty($payment_result['redirect_url'])) {
2766 return new WP_REST_Response([
2767 'success' => true,
2768 'message' => __('Payment processed.', 'yatra'),
2769 'data' => array_merge([
2770 'booking_id' => $booking_id,
2771 'reference' => $booking_reference,
2772 'redirect_url' => $payment_result['redirect_url'],
2773 'is_remaining_payment' => true,
2774 ], $remaining_identity_fields),
2775 ]);
2776 }
2777 }
2778
2779 $err = $payment_result['message'] ?? $payment_result['error'] ?? __('Payment processing failed. Please try again.', 'yatra');
2780
2781 return new WP_REST_Response([
2782 'success' => false,
2783 'message' => $err,
2784 'data' => [
2785 'payment_error' => true,
2786 'booking_id' => $booking_id,
2787 ],
2788 ], 400);
2789 }
2790
2791 // Offline gateways: no external redirect — confirmation page only.
2792 // Append `balance=paid` so the confirmation template renders the
2793 // remaining-payment-specific banner ("balance received, fully paid")
2794 // instead of the generic "booking confirmed" copy.
2795 yatra_clear_remaining_session();
2796
2797 $offline_redirect = add_query_arg(
2798 'balance',
2799 'paid',
2800 $this->getConfirmationUrl($booking_reference)
2801 );
2802
2803 return new WP_REST_Response([
2804 'success' => true,
2805 'message' => __('Continue to confirmation.', 'yatra'),
2806 'data' => [
2807 'booking_id' => $booking_id,
2808 'reference' => $booking_reference,
2809 'trip_id' => $trip_id,
2810 'trip_title' => $trip_title,
2811 'trip_date' => $travel_date,
2812 'currency' => $currency,
2813 'amount' => $remaining_amount,
2814 'customer_email' => $customer_email,
2815 'customer_name' => $customer_name,
2816 'redirect_url' => $offline_redirect,
2817 'is_remaining_payment' => true,
2818 ],
2819 ]);
2820 }
2821
2822 /**
2823 * Process payment through the selected gateway
2824 */
2825 private function processPaymentGateway(string $gateway, array $params): array
2826 {
2827 // Debug logging
2828 if (defined('WP_DEBUG') && WP_DEBUG) {
2829 }
2830
2831 // All gateways use the unified gateway system
2832 return $this->processPaymentWithGateway($gateway, $params);
2833 }
2834
2835 /**
2836 * Process payment using the proper gateway system
2837 */
2838 private function processPaymentWithGateway(string $gatewayId, array $params): array
2839 {
2840 try {
2841 $registry = \Yatra\PaymentGateways\PaymentGatewayRegistry::getInstance();
2842 $gateway = $registry->get($gatewayId);
2843
2844 if (!$gateway) {
2845 return ['success' => false, 'message' => "Payment gateway '{$gatewayId}' not found"];
2846 }
2847
2848 if (!$gateway->isEnabled()) {
2849 return [
2850 'success' => false,
2851 'message' => __('This payment method is not available.', 'yatra'),
2852 ];
2853 }
2854
2855 if (!$gateway->isProperlyConfigured()) {
2856 return [
2857 'success' => false,
2858 'message' => GatewayUserMessages::gatewayNotConfigured($gateway),
2859 ];
2860 }
2861
2862 // Prepare payment data - pass all params, gateways extract what they need.
2863 // Default return_url to the configured booking confirmation URL so redirect gateways
2864 // (e.g. PayPal Advanced, Mollie, Paystack) do not fall back to wrong paths; gateways
2865 // may still append their own query args on top of this URL.
2866 $ref = isset($params['reference']) ? trim((string) $params['reference']) : '';
2867 $paymentData = array_merge($params, [
2868 'description' => $params['trip_title'] ?? '',
2869 'cancel_url' => home_url('/book/?payment=cancelled&ref=' . ($params['reference'] ?? '')),
2870 'metadata' => [
2871 'booking_id' => $params['booking_id'],
2872 'reference' => $params['reference'] ?? ''
2873 ]
2874 ]);
2875 if ($ref !== '' && empty($paymentData['return_url'])) {
2876 $paymentData['return_url'] = $this->getConfirmationUrl($ref);
2877 }
2878
2879 // Process the payment through the gateway
2880 $result = $gateway->processPayment($paymentData);
2881
2882 // Debug logging
2883 if (defined('WP_DEBUG') && WP_DEBUG) {
2884 }
2885
2886 if ($result['success']) {
2887 // Save transaction ID for tracking
2888 if (!empty($result['transaction_id'])) {
2889 $this->bookingRepository->updatePaymentSessionId(
2890 (int) $params['booking_id'],
2891 $result['transaction_id']
2892 );
2893 }
2894
2895 // For gateways that require client-side action (Stripe, Razorpay, etc.)
2896 // Payment will be recorded after client completes the action
2897 if (!empty($result['requires_action'])) {
2898 return array_merge(['success' => true], $result);
2899 }
2900
2901 // For gateways that return a redirect URL for external payment (PayPal, eSewa, Khalti)
2902 // Payment will be recorded on callback/return
2903 if (!empty($result['redirect_url']) || !empty($result['payment_url'])) {
2904 // Check if this is a completed payment with redirect (like Square)
2905 // vs pending external payment (like PayPal)
2906 $isCompletedPayment = !empty($result['transaction_id']) &&
2907 (($result['status'] ?? '') === 'completed' || ($result['status'] ?? '') === 'succeeded');
2908
2909 if ($isCompletedPayment) {
2910 $this->recordGatewayPayment($params, $result, $gatewayId);
2911 }
2912
2913 return [
2914 'success' => true,
2915 'payment_url' => $result['redirect_url'] ?? $result['payment_url']
2916 ];
2917 }
2918
2919 // For offline gateways or successful direct payments without redirect
2920 $this->recordOfflinePendingPayment($params, $result, $gatewayId);
2921
2922 return [
2923 'success' => true,
2924 'redirect_url' => $this->getConfirmationUrl($params['reference'] ?? '')
2925 ];
2926 }
2927
2928 // Log the payment failure for debugging
2929 if (defined('WP_DEBUG') && WP_DEBUG) {
2930 }
2931
2932 return [
2933 'success' => false,
2934 'message' => $result['message'] ?? $result['error'] ?? 'Payment processing failed. Please try again.'
2935 ];
2936
2937 } catch (\Exception $e) {
2938 // Log the exception for debugging
2939 return [
2940 'success' => false,
2941 'message' => 'An unexpected error occurred. Please try again or contact support.'
2942 ];
2943 }
2944 }
2945
2946 /**
2947 * Record payment from gateway result
2948 * Matches Stripe's completePayment behavior
2949 */
2950 /**
2951 * Record the awaited payment for an offline gateway (bank transfer, cash on
2952 * arrival, pay later) as a PENDING ledger row.
2953 *
2954 * These gateways take no money at checkout, and previously wrote no payment
2955 * row at all — so when the transfer finally landed there was nothing in the
2956 * Payments screen for the operator to mark as received. The booking's own
2957 * fields were the only record, and marking those by hand left the invoice
2958 * reporting "Payment Pending" with nothing paid.
2959 *
2960 * The row is deliberately `pending`: no money has arrived yet, and
2961 * getTotalPaidForBooking() counts only `completed`, so booking financials and
2962 * every report are untouched until the operator confirms it.
2963 */
2964 private function recordOfflinePendingPayment(array $params, array $result, string $gatewayId): void
2965 {
2966 try {
2967 $bookingId = (int) ($params['booking_id'] ?? 0);
2968 $amount = (float) ($params['amount'] ?? 0);
2969
2970 if ($bookingId <= 0 || $amount <= 0) {
2971 return;
2972 }
2973
2974 // Only for gateways that settle out of band. Anything reporting a
2975 // completed/succeeded status already records its own row.
2976 $status = strtolower((string) ($result['status'] ?? ''));
2977 if (!in_array($status, ['', 'pending', 'pending_verification'], true)) {
2978 return;
2979 }
2980
2981 $booking = $this->bookingRepository->find($bookingId);
2982 if (!$booking || ($booking->payment_status ?? '') === 'paid') {
2983 return;
2984 }
2985
2986 $paymentRepository = new \Yatra\Repositories\PaymentRepository();
2987
2988 // Idempotency: a retried checkout must not stack up duplicate rows.
2989 foreach ($paymentRepository->findByBookingId($bookingId) as $existing) {
2990 if ((string) ($existing->gateway ?? '') === $gatewayId
2991 && in_array((string) ($existing->status ?? ''), ['pending', 'completed'], true)
2992 ) {
2993 return;
2994 }
2995 }
2996
2997 $paymentRepository->create([
2998 'booking_id' => $bookingId,
2999 'amount' => $amount,
3000 'currency' => $params['currency'] ?? \Yatra\Services\SettingsService::getCurrency(),
3001 'gateway' => $gatewayId,
3002 'status' => 'pending',
3003 'customer_id' => !empty($booking->customer_id) ? (int) $booking->customer_id : null,
3004 'notes' => __('Awaiting payment — mark as completed once received.', 'yatra'),
3005 'created_at' => current_time('mysql'),
3006 ]);
3007 } catch (\Throwable $e) {
3008 // Never break a successful checkout over a bookkeeping row.
3009 \Yatra\Utils\Logger::warning('Could not record pending offline payment', [
3010 'booking_id' => $params['booking_id'] ?? 0,
3011 'gateway' => $gatewayId,
3012 'error' => $e->getMessage(),
3013 ]);
3014 }
3015 }
3016
3017 private function recordGatewayPayment(array $params, array $result, string $gatewayId): void
3018 {
3019 global $wpdb;
3020
3021 try {
3022 $bookingId = (int) $params['booking_id'];
3023 $amount = (float) ($params['amount'] ?? 0);
3024 $currency = $params['currency'] ?? 'USD';
3025 $transactionId = $result['transaction_id'] ?? '';
3026
3027 // Get booking
3028 $booking = $this->bookingRepository->find($bookingId);
3029 if (!$booking) {
3030 return;
3031 }
3032
3033 // Already settled in full — never apply another charge to it. A fresh
3034 // booking is never already paid, so in practice this only guards a
3035 // stray/duplicate completion call (with a different transaction id)
3036 // against over-applying the ledger.
3037 if (($booking->payment_status ?? '') === 'paid') {
3038 return;
3039 }
3040
3041 $paymentRepository = new \Yatra\Repositories\PaymentRepository();
3042
3043 // Idempotency guard: skip if this gateway transaction is already
3044 // recorded for this booking. Prevents duplicate ledger rows when a
3045 // payment is submitted twice (the gateway uses a fresh idempotency
3046 // key per call, so it won't dedupe a true retry). Mirrors
3047 // PaymentGatewayController::handle_successful_payment().
3048 if ($transactionId !== '') {
3049 $existing = $paymentRepository->findByTransactionId($transactionId);
3050 if ($existing && (int) ($existing->booking_id ?? 0) === $bookingId) {
3051 return;
3052 }
3053 }
3054
3055 // Record the payment
3056 $paymentRepository->create([
3057 'booking_id' => $bookingId,
3058 'amount' => $amount,
3059 'currency' => $currency,
3060 'gateway' => $gatewayId,
3061 'transaction_id' => $transactionId,
3062 'status' => 'completed',
3063 'customer_id' => $booking->customer_id ? (int) $booking->customer_id : null,
3064 'created_at' => current_time('mysql'),
3065 ]);
3066
3067 // Update the booking ledger + status. The synchronous gateways
3068 // (Square, Authorize.Net) reach this generic path but previously left
3069 // the booking at pending/pending — only the payment row was written.
3070 // This now matches handle_successful_payment(): accumulate amount_paid,
3071 // recompute amount_due, set payment_status (paid vs partial), and
3072 // confirm the booking (a deposit confirms too, consistent with Stripe).
3073 $newAmountPaid = (float) ($booking->amount_paid ?? 0) + $amount;
3074 $newAmountDue = max(0.0, (float) ($booking->total_amount ?? 0) - $newAmountPaid);
3075 $paymentStatus = $newAmountDue > 0.0 ? 'partial' : 'paid';
3076 $previousStatus = (string) ($booking->status ?? 'pending');
3077
3078 // Only auto-confirm when the operator allows it (or fully paid). A
3079 // deposit / partial payment must not confirm when "Auto-Confirm
3080 // Bookings" is off.
3081 $shouldConfirm = \yatra_should_confirm_booking_on_payment($newAmountDue <= 0.0, $bookingId);
3082
3083 $bookingUpdate = [
3084 'amount_paid' => $newAmountPaid,
3085 'amount_due' => $newAmountDue,
3086 'payment_status' => $paymentStatus,
3087 ];
3088 if ($shouldConfirm) {
3089 $bookingUpdate['status'] = 'confirmed';
3090 }
3091 $this->bookingRepository->update($bookingId, $bookingUpdate);
3092
3093 if ($shouldConfirm && function_exists('yatra_trigger_booking_confirmed')) {
3094 \yatra_trigger_booking_confirmed($bookingId, $previousStatus);
3095 }
3096
3097 // Fire payment completed action
3098 do_action('yatra_payment_completed', [
3099 'booking_id' => $bookingId,
3100 'transaction_id' => $transactionId,
3101 'amount' => $amount,
3102 'currency' => $currency,
3103 'gateway' => $gatewayId,
3104 ]);
3105 } catch (\Throwable $e) {
3106 // Best-effort: the charge is already recorded; a confirmation-page
3107 // reload / status reconciliation can recover if this update fails.
3108 }
3109 }
3110
3111 /**
3112 * Process PayPal payment
3113 */
3114 private function processPayPalPayment(array $params, array $config, bool $is_test): array
3115 {
3116 $client_id = $config['client_id'] ?? '';
3117 $client_secret = $config['client_secret'] ?? '';
3118
3119 if (empty($client_id) || empty($client_secret)) {
3120 return ['success' => false, 'message' => 'PayPal credentials not configured'];
3121 }
3122
3123 $base_url = $is_test ? 'https://api-m.sandbox.paypal.com' : 'https://api-m.paypal.com';
3124
3125 try {
3126 // Get access token
3127 $auth_response = wp_remote_post($base_url . '/v1/oauth2/token', [
3128 'headers' => [
3129 'Authorization' => 'Basic ' . base64_encode($client_id . ':' . $client_secret),
3130 'Content-Type' => 'application/x-www-form-urlencoded',
3131 ],
3132 'body' => 'grant_type=client_credentials',
3133 ]);
3134
3135 if (is_wp_error($auth_response)) {
3136 return ['success' => false, 'message' => $auth_response->get_error_message()];
3137 }
3138
3139 $auth_body = json_decode(wp_remote_retrieve_body($auth_response), true);
3140 $access_token = $auth_body['access_token'] ?? '';
3141
3142 if (empty($access_token)) {
3143 return ['success' => false, 'message' => 'Failed to get PayPal access token'];
3144 }
3145
3146 // Create order
3147 $order_response = wp_remote_post($base_url . '/v2/checkout/orders', [
3148 'headers' => [
3149 'Authorization' => 'Bearer ' . $access_token,
3150 'Content-Type' => 'application/json',
3151 ],
3152 'body' => wp_json_encode([
3153 'intent' => 'CAPTURE',
3154 'purchase_units' => [[
3155 'reference_id' => $params['reference'],
3156 'amount' => [
3157 'currency_code' => $params['currency'],
3158 'value' => number_format($params['amount'], 2, '.', ''),
3159 ],
3160 'description' => $params['trip_title'],
3161 ]],
3162 'application_context' => [
3163 'return_url' => add_query_arg('payment', 'success', $this->getConfirmationUrl($params['reference'])),
3164 'cancel_url' => home_url('/book/?payment=cancelled&ref=' . $params['reference']),
3165 ],
3166 ]),
3167 ]);
3168
3169 if (is_wp_error($order_response)) {
3170 return ['success' => false, 'message' => $order_response->get_error_message()];
3171 }
3172
3173 $order_body = json_decode(wp_remote_retrieve_body($order_response), true);
3174
3175 // Find approval link
3176 foreach ($order_body['links'] ?? [] as $link) {
3177 if ($link['rel'] === 'approve') {
3178 // Save order ID for capture later
3179 $this->bookingRepository->updatePaymentSessionId(
3180 (int) $params['booking_id'],
3181 $order_body['id'] ?? ''
3182 );
3183
3184 return ['success' => true, 'payment_url' => $link['href']];
3185 }
3186 }
3187
3188 return ['success' => false, 'message' => 'Failed to create PayPal order'];
3189 } catch (\Exception $e) {
3190 return ['success' => false, 'message' => $e->getMessage()];
3191 }
3192 }
3193
3194 /**
3195 * Process Razorpay payment
3196 */
3197 private function processRazorpayPayment(array $params, array $config, bool $is_test): array
3198 {
3199 $key_id = $config['api_key'] ?? '';
3200 $key_secret = $config['api_secret'] ?? '';
3201
3202 if (empty($key_id) || empty($key_secret)) {
3203 return ['success' => false, 'message' => 'Razorpay credentials not configured'];
3204 }
3205
3206 try {
3207 // Create Razorpay order
3208 $response = wp_remote_post('https://api.razorpay.com/v1/orders', [
3209 'headers' => [
3210 'Authorization' => 'Basic ' . base64_encode($key_id . ':' . $key_secret),
3211 'Content-Type' => 'application/json',
3212 ],
3213 'body' => wp_json_encode([
3214 'amount' => (int) ($params['amount'] * 100), // Amount in paise
3215 'currency' => $params['currency'],
3216 'receipt' => $params['reference'],
3217 'notes' => [
3218 'booking_id' => $params['booking_id'],
3219 'trip' => $params['trip_title'],
3220 ],
3221 ]),
3222 ]);
3223
3224 if (is_wp_error($response)) {
3225 return ['success' => false, 'message' => $response->get_error_message()];
3226 }
3227
3228 $body = json_decode(wp_remote_retrieve_body($response), true);
3229
3230 if (!empty($body['id'])) {
3231 // Save order ID
3232 $this->bookingRepository->updatePaymentSessionId(
3233 (int) $params['booking_id'],
3234 $body['id']
3235 );
3236
3237 // Razorpay requires client-side integration, return data for JS
3238 // Store order details and redirect to a payment page
3239 $payment_url = add_query_arg([
3240 'razorpay_order' => $body['id'],
3241 'booking_ref' => $params['reference'],
3242 'key' => $key_id,
3243 'amount' => (int) ($params['amount'] * 100),
3244 'currency' => $params['currency'],
3245 'name' => get_bloginfo('name'),
3246 'description' => $params['trip_title'],
3247 'email' => $params['customer_email'],
3248 ], home_url('/yatra-payment/razorpay/'));
3249
3250 return ['success' => true, 'payment_url' => $payment_url];
3251 }
3252
3253 return ['success' => false, 'message' => $body['error']['description'] ?? 'Failed to create Razorpay order'];
3254 } catch (\Exception $e) {
3255 return ['success' => false, 'message' => $e->getMessage()];
3256 }
3257 }
3258
3259 /**
3260 * Process eSewa payment
3261 */
3262 private function processEsewaPayment(array $params, array $config, bool $is_test): array
3263 {
3264 $merchant_id = $config['merchant_id'] ?? '';
3265
3266 if (empty($merchant_id)) {
3267 return ['success' => false, 'message' => 'eSewa merchant ID not configured'];
3268 }
3269
3270 $base_url = $is_test ? 'https://uat.esewa.com.np/epay/main' : 'https://esewa.com.np/epay/main';
3271
3272 // eSewa uses form redirect, build URL with parameters
3273 $payment_url = add_query_arg([
3274 'amt' => $params['amount'],
3275 'psc' => 0,
3276 'pdc' => 0,
3277 'txAmt' => 0,
3278 'tAmt' => $params['amount'],
3279 'pid' => $params['reference'],
3280 'scd' => $merchant_id,
3281 'su' => add_query_arg(
3282 ['payment' => 'success', 'gateway' => 'esewa'],
3283 $this->getConfirmationUrl($params['reference'])
3284 ),
3285 'fu' => home_url('/book/?payment=failed&ref=' . $params['reference']),
3286 ], $base_url);
3287
3288 return ['success' => true, 'payment_url' => $payment_url];
3289 }
3290
3291 /**
3292 * Process Khalti payment
3293 */
3294 private function processKhaltiPayment(array $params, array $config, bool $is_test): array
3295 {
3296 $secret_key = $config['api_secret'] ?? '';
3297
3298 if (empty($secret_key)) {
3299 return ['success' => false, 'message' => 'Khalti secret key not configured'];
3300 }
3301
3302 $base_url = $is_test ? 'https://a.khalti.com/api/v2/epayment/initiate/' : 'https://khalti.com/api/v2/epayment/initiate/';
3303
3304 try {
3305 $response = wp_remote_post($base_url, [
3306 'headers' => [
3307 'Authorization' => 'Key ' . $secret_key,
3308 'Content-Type' => 'application/json',
3309 ],
3310 'body' => wp_json_encode([
3311 'return_url' => add_query_arg(
3312 ['payment' => 'success', 'gateway' => 'khalti'],
3313 $this->getConfirmationUrl($params['reference'])
3314 ),
3315 'website_url' => home_url(),
3316 'amount' => (int) ($params['amount'] * 100), // Amount in paisa
3317 'purchase_order_id' => $params['reference'],
3318 'purchase_order_name' => $params['trip_title'],
3319 'customer_info' => [
3320 'name' => $params['customer_name'],
3321 'email' => $params['customer_email'],
3322 ],
3323 ]),
3324 ]);
3325
3326 if (is_wp_error($response)) {
3327 return ['success' => false, 'message' => $response->get_error_message()];
3328 }
3329
3330 $body = json_decode(wp_remote_retrieve_body($response), true);
3331
3332 if (!empty($body['payment_url'])) {
3333 // Save pidx for verification
3334 $this->bookingRepository->updatePaymentSessionId(
3335 (int) $params['booking_id'],
3336 $body['pidx'] ?? ''
3337 );
3338
3339 return ['success' => true, 'payment_url' => $body['payment_url']];
3340 }
3341
3342 return ['success' => false, 'message' => $body['detail'] ?? 'Failed to initiate Khalti payment'];
3343 } catch (\Exception $e) {
3344 return ['success' => false, 'message' => $e->getMessage()];
3345 }
3346 }
3347
3348 /**
3349 * Process Authorize.net payment
3350 */
3351 private function processAuthorizeNetPayment(array $params, array $config, bool $is_test): array
3352 {
3353 // Authorize.net typically requires hosted payment page or client-side integration
3354 // Return URL for hosted payment page setup
3355 return [
3356 'success' => true,
3357 'payment_url' => add_query_arg([
3358 'booking_ref' => $params['reference'],
3359 'amount' => $params['amount'],
3360 'gateway' => 'authorize_net',
3361 ], home_url('/yatra-payment/authorize-net/'))
3362 ];
3363 }
3364
3365 /**
3366 * Get client IP address
3367 */
3368 private function getClientIp(): string
3369 {
3370 $ip_keys = ['HTTP_CLIENT_IP', 'HTTP_X_FORWARDED_FOR', 'HTTP_X_FORWARDED', 'HTTP_FORWARDED_FOR', 'HTTP_FORWARDED', 'REMOTE_ADDR'];
3371
3372 foreach ($ip_keys as $key) {
3373 if (!empty($_SERVER[$key])) {
3374 $ip = sanitize_text_field($_SERVER[$key]);
3375 if (strpos($ip, ',') !== false) {
3376 $ip = trim(explode(',', $ip)[0]);
3377 }
3378 if (filter_var($ip, FILTER_VALIDATE_IP)) {
3379 return $ip;
3380 }
3381 }
3382 }
3383
3384 return '0.0.0.0';
3385 }
3386
3387 /**
3388 * Send booking confirmation email
3389 */
3390 private function sendBookingConfirmationEmail(int $booking_id, string $reference, object $trip, array $data): void
3391 {
3392 $contact = $data['contact'] ?? [];
3393 $travelers = $data['travelers'] ?? [];
3394 $travel_date = $data['travel_date'] ?? '';
3395 $total_amount = $data['total_amount'] ?? 0;
3396 $amount_due = $data['amount_due'] ?? 0;
3397 $payment_method = $data['payment_method'] ?? 'full';
3398 $payment_gateway = $data['payment_gateway'] ?? 'pay_later';
3399 $booking_status = $data['booking_status'] ?? 'pending';
3400 // Cancellation copy in the email now comes from the trip's
3401 // own cancellation_policy field (set per-trip on the Trip
3402 // editor), not from removed global settings. Falls back to
3403 // empty so the paragraph is silently omitted when the trip
3404 // doesn't have a policy set.
3405 $trip_cancellation_policy = isset($trip->cancellation_policy)
3406 ? wp_strip_all_tags((string) $trip->cancellation_policy)
3407 : '';
3408 $expiry_datetime = $data['expiry_datetime'] ?? null;
3409
3410 $customer_email = $contact['email'] ?? '';
3411 $customer_name = trim(($contact['first_name'] ?? '') . ' ' . ($contact['last_name'] ?? ''));
3412
3413 if (empty($customer_email)) {
3414 return;
3415 }
3416
3417 // Format prices using global currency settings
3418 $formatted_total = yatra_format_price($total_amount);
3419 $formatted_due = yatra_format_price($amount_due);
3420
3421 $intro_paragraph = $booking_status === 'confirmed'
3422 ? __('Thank you for your booking! Your reservation has been confirmed.', 'yatra')
3423 : __('Thank you for your booking! Your reservation has been received and is pending confirmation.', 'yatra');
3424 if ($booking_status === 'pending' && $expiry_datetime) {
3425 $intro_paragraph .= ' ' . sprintf(
3426 /* translators: %s: payment expiry date and time (formatted). */
3427 __('Please complete your payment before %s to avoid automatic cancellation.', 'yatra'),
3428 date_i18n(get_option('date_format') . ' ' . get_option('time_format'), strtotime($expiry_datetime))
3429 );
3430 }
3431
3432 ob_start();
3433 ?>
3434 <div style="background:#f3f4f6;padding:20px;border-radius:8px;margin:16px 0;">
3435 <p style="margin:0 0 8px;"><strong><?php esc_html_e('Booking reference', 'yatra'); ?>:</strong> <?php echo esc_html($reference); ?></p>
3436 <p style="margin:0 0 8px;"><strong><?php esc_html_e('Trip', 'yatra'); ?>:</strong> <?php echo esc_html($trip->title); ?></p>
3437 <p style="margin:0 0 8px;"><strong><?php esc_html_e('Travel date', 'yatra'); ?>:</strong> <?php echo esc_html(date_i18n(get_option('date_format'), strtotime($travel_date))); ?></p>
3438 <p style="margin:0 0 8px;"><strong><?php esc_html_e('Duration', 'yatra'); ?>:</strong> <?php /* translators: 1: number of days, 2: number of nights. */
3439 echo esc_html(sprintf(__('%1$d days / %2$d nights', 'yatra'), (int) $trip->duration_days, (int) $trip->duration_nights)); ?></p>
3440 <p style="margin:0;"><strong><?php esc_html_e('Travelers', 'yatra'); ?>:</strong> <?php echo esc_html((string) count($travelers)); ?></p>
3441 </div>
3442 <h3 style="font-size:16px;"><?php esc_html_e('Payment details', 'yatra'); ?></h3>
3443 <p><?php /* translators: %s: total amount (formatted). */
3444 echo esc_html(sprintf(__('Total: %s', 'yatra'), $formatted_total)); ?></p>
3445 <?php if ($payment_method === 'deposit') : ?>
3446 <p><?php /* translators: 1: amount due now (formatted), 2: remaining amount (formatted). */
3447 echo esc_html(sprintf(__('Payment type: Deposit — due now %1$s, remaining %2$s', 'yatra'), $formatted_due, yatra_format_price($total_amount - $amount_due))); ?></p>
3448 <?php elseif ($payment_method === 'partial') : ?>
3449 <p><?php /* translators: 1: amount due now (formatted), 2: remaining amount (formatted). */
3450 echo esc_html(sprintf(__('Payment type: Partial — due now %1$s, remaining %2$s', 'yatra'), $formatted_due, yatra_format_price($total_amount - $amount_due))); ?></p>
3451 <?php else : ?>
3452 <p><?php esc_html_e('Payment type: Full payment', 'yatra'); ?></p>
3453 <?php endif; ?>
3454 <?php if ($payment_gateway === 'pay_later') : ?>
3455 <p><?php esc_html_e('Pay later — please contact us to arrange payment.', 'yatra'); ?></p>
3456 <?php elseif ($payment_gateway === 'bank_transfer') : ?>
3457 <p><?php esc_html_e('Bank transfer — you will receive bank details separately.', 'yatra'); ?></p>
3458 <?php endif; ?>
3459 <h3 style="font-size:16px;"><?php esc_html_e('Travelers', 'yatra'); ?></h3>
3460 <ul style="padding-left:20px;">
3461 <?php foreach ($travelers as $i => $traveler) : ?>
3462 <?php
3463 $traveler_name = trim(($traveler['first_name'] ?? '') . ' ' . ($traveler['last_name'] ?? ''));
3464 ?>
3465 <li><?php /* translators: 1: traveler number (1-based), 2: traveler full name. */
3466 echo esc_html(sprintf(__('Traveler %1$d: %2$s', 'yatra'), $i + 1, $traveler_name ?: '')); ?></li>
3467 <?php endforeach; ?>
3468 </ul>
3469 <?php
3470 // Cancellation policy paragraph now sources from the trip's
3471 // per-trip cancellation_policy field (set on the Trip
3472 // editor). The previous version used global cancellation
3473 // settings that were display-only — they appeared here but
3474 // never enforced a real cancellation cutoff. We've removed
3475 // those settings; if the trip itself doesn't define a
3476 // policy, the whole section is silently omitted so the
3477 // email isn't padded with empty headings.
3478 if ($trip_cancellation_policy !== '') {
3479 ?>
3480 <h3 style="font-size:16px;"><?php esc_html_e('Cancellation policy', 'yatra'); ?></h3>
3481 <p><?php echo esc_html($trip_cancellation_policy); ?></p>
3482 <?php
3483 }
3484 ?>
3485 <h3 style="font-size:16px;"><?php esc_html_e('What’s next?', 'yatra'); ?></h3>
3486 <ol style="padding-left:20px;">
3487 <li><?php esc_html_e('You will receive a detailed trip itinerary within 24–48 hours.', 'yatra'); ?></li>
3488 <li><?php esc_html_e('Our team will contact you to confirm any special requirements.', 'yatra'); ?></li>
3489 <li><?php esc_html_e('Please ensure travel documents meet entry requirements for your destination.', 'yatra'); ?></li>
3490 </ol>
3491 <p><?php esc_html_e('If you have any questions, contact us anytime.', 'yatra'); ?></p>
3492 <p><a href="<?php echo esc_url(home_url('/')); ?>"><?php echo esc_html(home_url('/')); ?></a></p>
3493 <?php
3494 $details_html = ob_get_clean();
3495
3496 // Seed from the canonical booking variables FIRST so every dynamic
3497 // merge tag — {{contact_*}} / {{emergency_*}} custom fields,
3498 // {{traveler_custom_fields_html}}, {{balance_due}}, payment/schedule
3499 // tags, etc. — resolves on this offline / pay-later path exactly like
3500 // the online-gateway path (BookingService::sendBookingConfirmationEmail).
3501 // Previously this method hand-built only ~18 core keys, so an operator
3502 // who customised the Booking Confirmation template with a custom-field
3503 // variable saw it render empty on offline bookings. The hand-built keys
3504 // below (the self-rendered details_html, intro, footer) intentionally
3505 // take precedence via array_merge ordering.
3506 $base_vars = [];
3507 $saved_booking = $this->bookingRepository->find($booking_id);
3508 if ($saved_booking) {
3509 $base_vars = TransactionalEmailTemplateService::variablesFromBooking($saved_booking);
3510 }
3511
3512 $vars = array_merge($base_vars, [
3513 'customer_name' => $customer_name,
3514 'customer_first_name' => (string) ($contact['first_name'] ?? ''),
3515 'customer_last_name' => (string) ($contact['last_name'] ?? ''),
3516 'customer_email' => $customer_email,
3517 'customer_phone' => (string) ($contact['phone'] ?? ''),
3518 'booking_reference' => $reference,
3519 'booking_id' => (string) $booking_id,
3520 'trip_name' => (string) $trip->title,
3521 'trip_url' => home_url('/' . SettingsService::getTripBase() . '/' . rawurlencode((string) ($trip->slug ?? '')) . '/'),
3522 'travel_date' => date_i18n(get_option('date_format'), strtotime($travel_date)),
3523 'travelers_count' => (string) count($travelers),
3524 'total_amount_formatted' => $formatted_total,
3525 'amount_due_formatted' => $formatted_due,
3526 'currency' => SettingsService::getCurrency(),
3527 'intro_paragraph' => $intro_paragraph,
3528 'details_html' => $details_html,
3529 'details_html_only' => '1',
3530 /* translators: %s: site name. */
3531 'footer_note' => sprintf(__('— %s', 'yatra'), get_bloginfo('name')),
3532 'transactional_context' => 'booking_created',
3533 ]);
3534
3535 TransactionalEmailTemplateService::sendIfEnabled(
3536 TransactionalEmailTemplateService::TYPE_BOOKING_CONFIRMATION,
3537 $customer_email,
3538 $vars
3539 );
3540
3541 // Admin new-booking email is sent from NotificationService (yatra_booking_created) using
3542 // Email → Templates → Admin: New booking, to avoid duplicate messages.
3543 }
3544
3545 /**
3546 * Apply coupon code to booking session
3547 */
3548 public function apply_coupon(WP_REST_Request $request): WP_REST_Response
3549 {
3550 yatra_start_session();
3551
3552 $data = $request->get_json_params() ?? [];
3553
3554 // M-2: restore CSRF protection stripped by public_permission_callback.
3555 if (($blocked = $this->guardPublicBookingMutation($request, $data)) !== null) {
3556 return $blocked;
3557 }
3558
3559 $code = isset($data['code']) ? strtoupper(sanitize_text_field($data['code'])) : '';
3560
3561 if (empty($code)) {
3562 return new WP_REST_Response([
3563 'success' => false,
3564 'message' => __('Please enter a coupon code.', 'yatra'),
3565 ], 400);
3566 }
3567
3568 // Get current session — with token-rehydration fallback for REST
3569 // contexts where PHPSESSID isn't propagated (same shape as the
3570 // service-toggle / summary endpoints). Also writes back to $_SESSION
3571 // so the subsequent `yatra_set_booking_session()` persists alongside
3572 // the existing transient.
3573 $session = yatra_get_booking_session();
3574 if (empty($session) || empty($session['trip_id'])) {
3575 $token = null;
3576 if (!empty($data['booking_token']) && is_string($data['booking_token'])) {
3577 $token = sanitize_text_field((string) $data['booking_token']);
3578 } elseif (isset($_GET['booking_token']) && is_string($_GET['booking_token'])) {
3579 $token = sanitize_text_field((string) wp_unslash($_GET['booking_token']));
3580 }
3581 if ($token) {
3582 $transient_data = get_transient($token);
3583 if (is_array($transient_data) && !empty($transient_data['trip_id'])) {
3584 $session = $transient_data;
3585 $_SESSION['yatra_booking'] = $session;
3586 $_SESSION['yatra_booking_token'] = $token;
3587 }
3588 }
3589 }
3590 if (empty($session) || empty($session['trip_id'])) {
3591 return new WP_REST_Response([
3592 'success' => false,
3593 'message' => __('No active booking session found.', 'yatra'),
3594 ], 400);
3595 }
3596
3597 // Use DiscountService to calculate coupon discount
3598 $discountService = new \Yatra\Services\DiscountService();
3599 $total_amount = $this->calculateSessionTotal($session);
3600 $trip_id = (int) $session['trip_id'];
3601 $travelers_count = (int) ($session['travelers'] ?? 1);
3602 $traveler_counts = $session['traveler_counts'] ?? [];
3603
3604 $coupon_result = $discountService->calculateCouponDiscount(
3605 $code,
3606 $total_amount,
3607 $trip_id,
3608 $travelers_count,
3609 $traveler_counts
3610 );
3611
3612 // Check if discount was calculated (validation passed)
3613 if ($coupon_result['calculated_amount'] <= 0) {
3614 return new WP_REST_Response([
3615 'success' => false,
3616 'message' => __('This coupon is not valid for your booking.', 'yatra'),
3617 ], 400);
3618 }
3619
3620 $discount_amount = $coupon_result['calculated_amount'];
3621
3622
3623 // Store coupon in session (use the original $code variable, not from result)
3624 $session['coupon'] = [
3625 'code' => $code, // Use the actual code that was validated
3626 'type' => $coupon_result['type'],
3627 'amount' => $coupon_result['amount'],
3628 'discount_amount' => $discount_amount,
3629 'label' => $coupon_result['label'],
3630 ];
3631 $session['timestamp'] = time();
3632
3633 yatra_set_booking_session($session);
3634
3635
3636 return new WP_REST_Response([
3637 'success' => true,
3638 'message' => __('Coupon applied successfully!', 'yatra'),
3639 'data' => [
3640 'code' => $code,
3641 'type' => $coupon_result['type'],
3642 'discount_amount' => $discount_amount,
3643 'discount_formatted' => yatra_format_price($discount_amount),
3644 'new_total' => $total_amount - $discount_amount,
3645 'new_total_formatted' => yatra_format_price($total_amount - $discount_amount),
3646 ],
3647 ]);
3648 }
3649
3650 /**
3651 * Verify a guest's booking email via magic-link token.
3652 *
3653 * Flow:
3654 * 1. Validate the HMAC token (forgery, expiry, email-binding).
3655 * 2. Look up the booking; confirm it's in `pending_verification`.
3656 * 3. Flip status to `pending` (or `confirmed` when auto-confirm
3657 * pay-later is enabled for this site) and fire the standard
3658 * yatra_booking_status_changed action so inventory + email
3659 * automations resume normally.
3660 * 4. 302 redirect the browser to a continuation URL:
3661 * - If amount_due > 0: back to the booking page for the
3662 * payment step the customer skipped earlier.
3663 * - If amount_due == 0 / auto-confirm: to the booking
3664 * confirmation/thank-you page.
3665 * 5. On any failure, render a friendly HTML page (not JSON) so
3666 * the customer sees readable text in their browser tab.
3667 *
3668 * @return WP_REST_Response|WP_Error|void
3669 */
3670 public function verify_email(WP_REST_Request $request)
3671 {
3672 $token = (string) $request->get_param('token');
3673 $bookingRepo = new \Yatra\Repositories\BookingRepository();
3674
3675 // First decode just to extract the booking id (for the
3676 // expectedEmail lookup). Verify() is called again below
3677 // with the actual email so the email-binding check runs.
3678 $partsPreview = explode('.', $token);
3679 $bookingIdGuess = (\count($partsPreview) >= 1 && ctype_digit($partsPreview[0]))
3680 ? (int) $partsPreview[0]
3681 : 0;
3682 $booking = $bookingIdGuess > 0 ? $bookingRepo->find($bookingIdGuess) : null;
3683 $expectedEmail = $booking ? (string) ($booking->contact_email ?? '') : '';
3684
3685 $result = \Yatra\Services\GuestVerificationTokenService::verify($token, $expectedEmail);
3686
3687 if (!$result['ok']) {
3688 $this->renderVerifyEmailErrorPage((string) ($result['reason'] ?? 'invalid'));
3689 }
3690 if ($booking === null) {
3691 $this->renderVerifyEmailErrorPage('booking_not_found');
3692 }
3693
3694 // Re-entrant: if the booking has already been verified, show the
3695 // same success page (idempotent) — pre-3.0.5 silently redirected
3696 // and the customer was left wondering whether anything happened.
3697 $currentStatus = (string) ($booking->status ?? '');
3698 $alreadyVerified = $currentStatus !== 'pending_verification';
3699
3700 if (!$alreadyVerified) {
3701 // Flip status to 'pending' so downstream hooks (inventory /
3702 // notification automations) see fresh data, then fire
3703 // yatra_booking_created so the listeners we deferred at
3704 // creation time (admin "new booking" notification + Pro
3705 // email-automation booking.created fan-out) run now — i.e.
3706 // *after* the customer has proven the email is theirs.
3707 $bookingRepo->updateStatus((int) $booking->id, 'pending');
3708 do_action('yatra_booking_email_verified', (int) $booking->id);
3709
3710 // Re-fetch so the post-verification action receives the
3711 // booking row with the new status, then fire the deferred
3712 // booking-created action. See BookingService::createBooking()
3713 // for the matching skip-on-pending-verification branch.
3714 $verifiedBooking = $bookingRepo->find((int) $booking->id);
3715 if (is_object($verifiedBooking)) {
3716 do_action(
3717 \Yatra\Hooks\TelemetryHookNames::BOOKING_CREATED,
3718 (int) $verifiedBooking->id,
3719 $verifiedBooking
3720 );
3721 }
3722
3723 // Guest email-verification defers the customer booking-confirmation
3724 // email: the checkout flow returns at the verification gate, before
3725 // its send-site (~line 2465), so the confirmation is never sent for a
3726 // verified guest booking. Send it now that the email is proven and the
3727 // booking is live — gated by the same `booking_confirmation` option the
3728 // checkout paths use. Only in this fresh-verify branch, so a re-clicked
3729 // link never re-sends. TYPE_BOOKING_CONFIRMATION is skipped by the Pro
3730 // booking.created fan-out, so this is the single source of the email.
3731 if ((bool) \Yatra\Services\SettingsService::get('booking_confirmation', true)) {
3732 try {
3733 (new \Yatra\Services\BookingService())->sendNewBookingTransactionalConfirmation((int) $booking->id);
3734 } catch (\Throwable $e) {
3735 // A mail failure must never break the customer's "verified" page.
3736 Logger::error('Post-verification booking confirmation email failed', [
3737 'booking_id' => (int) $booking->id,
3738 'error' => $e->getMessage(),
3739 ]);
3740 }
3741 }
3742 }
3743
3744 $this->renderVerifyEmailSuccessPage(
3745 (int) $booking->id,
3746 (string) ($booking->reference ?? ''),
3747 $alreadyVerified
3748 );
3749 }
3750
3751 /**
3752 * Friendly HTML error page rendered when a verification link
3753 * is invalid / expired / tampered with. Avoids JSON in the
3754 * customer's browser tab (terrible UX). Reasons map to clear
3755 * messages so customers know what to do next.
3756 *
3757 * Emits raw HTML and exits. We can't return WP_REST_Response with an
3758 * HTML body because the REST server JSON-encodes the response data
3759 * regardless of the Content-Type header on the response object —
3760 * the customer would see `"<!doctype..."` (a JSON string) in their
3761 * browser tab. Echoing + exiting short-circuits the REST pipeline.
3762 *
3763 * @return never
3764 */
3765 private function renderVerifyEmailErrorPage(string $reason): void
3766 {
3767 $messages = [
3768 'expired' => __('This verification link has expired. Please make a new booking — we keep the link valid for 48 hours.', 'yatra'),
3769 'invalid_signature' => __('This verification link is invalid or has been tampered with. Please make a new booking.', 'yatra'),
3770 'malformed_token' => __('This verification link is malformed. Please make a new booking.', 'yatra'),
3771 'email_changed' => __('The email on this booking has changed since the link was sent. Please contact support.', 'yatra'),
3772 'booking_not_found' => __('We could not find a booking for this verification link. Please make a new booking.', 'yatra'),
3773 ];
3774 $message = $messages[$reason] ?? __('This verification link is no longer valid.', 'yatra');
3775
3776 $brandName = function_exists('yatra_get_brand_name') ? yatra_get_brand_name() : 'Yatra';
3777 $html = sprintf(
3778 '<!doctype html><html lang="%1$s"><head><meta charset="utf-8">'
3779 . '<meta name="viewport" content="width=device-width,initial-scale=1">'
3780 . '<title>%2$s</title>'
3781 . '<style>body{font-family:system-ui,-apple-system,Segoe UI,Roboto,sans-serif;background:#f9fafb;margin:0;padding:40px 20px;color:#111827}'
3782 . '.box{max-width:480px;margin:60px auto;background:#fff;border-radius:12px;padding:32px;box-shadow:0 1px 3px rgba(0,0,0,.1);text-align:center}'
3783 . 'h1{font-size:20px;margin:0 0 12px}p{color:#4b5563;line-height:1.6;margin:0 0 20px}'
3784 . 'a{display:inline-block;background:#2563eb;color:#fff;padding:12px 24px;border-radius:8px;text-decoration:none;font-weight:600}</style></head>'
3785 . '<body><div class="box"><h1>%3$s</h1><p>%4$s</p><a href="%5$s">%6$s</a></div></body></html>',
3786 esc_attr(get_locale()),
3787 esc_html__('Verification link issue', 'yatra'),
3788 esc_html__('Verification link issue', 'yatra'),
3789 esc_html($message),
3790 esc_url(home_url('/')),
3791 esc_html(sprintf(/* translators: %s: brand name */ __('Return to %s', 'yatra'), $brandName))
3792 );
3793
3794 if (!headers_sent()) {
3795 status_header(200);
3796 nocache_headers();
3797 header('Content-Type: text/html; charset=UTF-8');
3798 }
3799 echo $html;
3800 exit;
3801 }
3802
3803 /**
3804 * Build the booking continuation URL (post-verification destination).
3805 *
3806 * If the site has a Yatra Bookings page, route through that with the
3807 * booking reference; otherwise fall back to the trip URL. Filterable
3808 * via `yatra_guest_verification_continuation_url` so integrations can
3809 * route to a custom thank-you page.
3810 */
3811 private function continuationUrl(int $bookingId, string $reference): string
3812 {
3813 return (string) apply_filters(
3814 'yatra_guest_verification_continuation_url',
3815 add_query_arg(
3816 ['booking_id' => $bookingId, 'verified' => '1'],
3817 home_url('/' . \Yatra\Services\SettingsService::getBookingBase() . '/')
3818 ),
3819 $bookingId,
3820 $reference
3821 );
3822 }
3823
3824 /**
3825 * Friendly HTML success page rendered after the guest clicks the
3826 * email-verification magic link.
3827 *
3828 * Pre-3.0.5 this endpoint silently 302-redirected to the booking page,
3829 * which made guests believe nothing had happened — there was no visible
3830 * "verified" feedback before they landed on the next step. This page
3831 * gives them an unambiguous confirmation, the booking reference, and
3832 * three explicit CTAs:
3833 * - Continue to booking (primary, continuation URL)
3834 * - My Account (when logged in) / Sign in (when not)
3835 * - Go to homepage (fallback)
3836 *
3837 * Idempotent: when the booking was already verified (re-click on the
3838 * same link), the heading + copy switch to the "already verified"
3839 * variant but the CTAs stay the same.
3840 *
3841 * Emits raw HTML and exits — same reasoning as
3842 * {@see self::renderVerifyEmailErrorPage()}: WP_REST_Response
3843 * JSON-encodes string bodies, so the customer would see
3844 * `"<!doctype..."` in their tab instead of the rendered page.
3845 *
3846 * @return never
3847 */
3848 private function renderVerifyEmailSuccessPage(int $bookingId, string $reference, bool $alreadyVerified): void
3849 {
3850 // Booking is already persisted at this point and (for a fresh verify)
3851 // the status flip + booking-created fan-out have just fired. The
3852 // verified UI's primary action is therefore "View your booking
3853 // confirmation" — NOT "Continue Booking", which mislabelled the
3854 // booking as still in-progress and confused customers into thinking
3855 // they needed to re-submit the form.
3856 $confirmationUrl = function_exists('yatra_get_booking_confirmation_url')
3857 ? yatra_get_booking_confirmation_url($reference)
3858 : $this->continuationUrl($bookingId, $reference);
3859
3860 // Account / login URL — prefer Yatra's account page when present,
3861 // fall back to wp_login_url() so the page never points nowhere.
3862 $accountBase = \Yatra\Services\SettingsService::getAccountBase();
3863 $accountUrl = $accountBase !== ''
3864 ? home_url('/' . trim($accountBase, '/') . '/')
3865 : home_url('/');
3866 $isLoggedIn = function_exists('is_user_logged_in') && is_user_logged_in();
3867 $secondaryUrl = $isLoggedIn ? $accountUrl : wp_login_url($confirmationUrl);
3868 $secondaryLabel = $isLoggedIn
3869 ? __('Go to My Account', 'yatra')
3870 : __('Sign in', 'yatra');
3871
3872 // Logged-in customers always get "Go to My Account". A guest is only
3873 // offered "Sign in" when an account is genuinely part of the flow —
3874 // registration is enabled AND guest checkout is not the operating mode.
3875 // This is a guest email-verification page (guest checkout is normally
3876 // on), so with guest checkout enabled OR registration disabled there is
3877 // no account to sign into; the CTA is hidden rather than dangling to a
3878 // login the guest can't use.
3879 $registrationEnabled = \Yatra\Services\SettingsService::isEnabled('customer_registration');
3880 $guestCheckoutEnabled = \Yatra\Services\SettingsService::isEnabled('allow_guest_checkout');
3881 $showSecondaryCta = $isLoggedIn || ($registrationEnabled && !$guestCheckoutEnabled);
3882 $secondaryCta = $showSecondaryCta
3883 ? '<a class="btn btn-secondary" href="' . esc_url($secondaryUrl) . '">' . esc_html($secondaryLabel) . '</a>'
3884 : '';
3885
3886 $heading = $alreadyVerified
3887 ? __('Email Already Verified', 'yatra')
3888 : __('Email Verified', 'yatra');
3889 $message = $alreadyVerified
3890 ? __('Your booking email is already verified. You can view your booking confirmation, head to your account, or return to the homepage.', 'yatra')
3891 : __('Thanks! Your booking email has been verified and your booking is confirmed. View the full confirmation below.', 'yatra');
3892
3893 $primaryLabel = __('View Booking Confirmation', 'yatra');
3894 $homeLabel = __('Go to Homepage', 'yatra');
3895 $referenceLabel = __('Booking reference', 'yatra');
3896 $brandName = function_exists('yatra_get_brand_name') ? yatra_get_brand_name() : 'Yatra';
3897
3898 $referenceLine = $reference !== ''
3899 ? sprintf(
3900 '<div class="ref"><span class="ref-label">%s</span><code>%s</code></div>',
3901 esc_html($referenceLabel),
3902 esc_html($reference)
3903 )
3904 : '';
3905
3906 // Inline-only styling so the page renders correctly regardless of
3907 // theme stylesheet load order (REST → wp_die/raw HTML response).
3908 $html = sprintf(
3909 '<!doctype html><html lang="%1$s"><head><meta charset="utf-8">'
3910 . '<meta name="viewport" content="width=device-width,initial-scale=1">'
3911 . '<title>%2$s · %3$s</title>'
3912 . '<style>'
3913 . 'body{font-family:system-ui,-apple-system,Segoe UI,Roboto,sans-serif;background:#f9fafb;margin:0;padding:40px 20px;color:#111827}'
3914 . '.box{max-width:520px;margin:60px auto;background:#fff;border-radius:12px;padding:36px 32px;box-shadow:0 1px 3px rgba(0,0,0,.1);text-align:center}'
3915 . '.tick{display:inline-flex;align-items:center;justify-content:center;width:72px;height:72px;border-radius:50%%;background:#d1fae5;margin:0 auto 20px}'
3916 . 'h1{font-size:24px;margin:0 0 12px;color:#065f46}'
3917 . 'p{color:#4b5563;line-height:1.6;margin:0 0 24px}'
3918 . '.ref{display:inline-flex;align-items:center;gap:8px;background:#f3f4f6;border-radius:6px;padding:8px 12px;margin:0 0 24px}'
3919 . '.ref-label{font-size:12px;color:#6b7280;text-transform:uppercase;letter-spacing:.04em}'
3920 . '.ref code{font-weight:600;color:#111827}'
3921 . '.actions{display:flex;flex-direction:column;gap:10px;margin-top:8px}'
3922 . '.btn{display:inline-block;padding:12px 24px;border-radius:8px;text-decoration:none;font-weight:600;text-align:center}'
3923 . '.btn-primary{background:#059669;color:#fff}'
3924 . '.btn-primary:hover{background:#047857}'
3925 . '.btn-secondary{background:#fff;color:#1f2937;border:1px solid #d1d5db}'
3926 . '.btn-secondary:hover{background:#f9fafb}'
3927 . '.btn-tertiary{color:#4b5563;padding:8px 12px;font-weight:500}'
3928 . '</style></head>'
3929 . '<body><div class="box">'
3930 . '<div class="tick" aria-hidden="true">'
3931 . '<svg width="40" height="40" viewBox="0 0 24 24" fill="none" stroke="#059669" stroke-width="3" stroke-linecap="round" stroke-linejoin="round">'
3932 . '<polyline points="20 6 9 17 4 12"></polyline></svg>'
3933 . '</div>'
3934 . '<h1>%2$s</h1>'
3935 . '<p>%4$s</p>'
3936 . '%5$s'
3937 . '<div class="actions">'
3938 . '<a class="btn btn-primary" href="%6$s">%7$s</a>'
3939 . '%8$s'
3940 . '<a class="btn btn-tertiary" href="%10$s">%11$s</a>'
3941 . '</div>'
3942 . '</div></body></html>',
3943 esc_attr(get_locale()),
3944 esc_html($heading),
3945 esc_html($brandName),
3946 esc_html($message),
3947 $referenceLine,
3948 esc_url($confirmationUrl),
3949 esc_html($primaryLabel),
3950 // %8 is the fully-built secondary CTA (or '' when hidden — see
3951 // $showSecondaryCta above). %9 is intentionally empty to keep the
3952 // positional args aligned with %10/%11.
3953 $secondaryCta,
3954 '',
3955 esc_url(home_url('/')),
3956 esc_html($homeLabel)
3957 );
3958
3959 if (!headers_sent()) {
3960 status_header(200);
3961 nocache_headers();
3962 header('Content-Type: text/html; charset=UTF-8');
3963 }
3964 echo $html;
3965 exit;
3966 }
3967
3968 /**
3969 * Calculate booking summary and return HTML for dynamic updates
3970 * Called via AJAX when traveler count, date, or coupon changes
3971 */
3972 public function calculate_summary(WP_REST_Request $request): WP_REST_Response
3973 {
3974 yatra_start_session();
3975 $session = yatra_get_booking_session();
3976 $data = $request->get_json_params() ?? [];
3977
3978 // M-2: restore CSRF protection stripped by public_permission_callback.
3979 if (($blocked = $this->guardPublicBookingMutation($request, $data)) !== null) {
3980 return $blocked;
3981 }
3982
3983 // Same REST-context session-rehydration fallback as set_session() /
3984 // create_booking(): when PHPSESSID isn't propagated to the REST API
3985 // scope, look up the transient by `booking_token` (from request body
3986 // first, then ?booking_token=) so the partial summary refresh
3987 // doesn't 400. Without this, every service-toggle re-render fails
3988 // because trip_id resolves to 0.
3989 //
3990 // We also write the rehydrated session into $_SESSION so that the
3991 // downstream buildPricingHtml() — which calls yatra_get_booking_session()
3992 // again — sees the same data and doesn't fall back to its
3993 // "Pricing information not available" branch.
3994 if (empty($session) || empty($session['trip_id'])) {
3995 $token = null;
3996 if (!empty($data['booking_token']) && is_string($data['booking_token'])) {
3997 $token = sanitize_text_field((string) $data['booking_token']);
3998 } elseif (isset($_GET['booking_token']) && is_string($_GET['booking_token'])) {
3999 $token = sanitize_text_field((string) wp_unslash($_GET['booking_token']));
4000 }
4001 if ($token) {
4002 $transient_data = get_transient($token);
4003 if (is_array($transient_data) && !empty($transient_data['trip_id'])) {
4004 $session = $transient_data;
4005 $_SESSION['yatra_booking'] = $session;
4006 $_SESSION['yatra_booking_token'] = $token;
4007 }
4008 }
4009 }
4010
4011 // Get trip_id from session (required)
4012 $trip_id = (int) ($session['trip_id'] ?? 0);
4013
4014 // Get traveler_counts from REQUEST (for dynamic updates) or fallback to session
4015 $traveler_counts = $data['traveler_counts'] ?? ($session['traveler_counts'] ?? []);
4016
4017 // Get other data from request or session
4018 $travel_date = sanitize_text_field($data['travel_date'] ?? ($session['travel_date'] ?? ''));
4019 $departure_time = sanitize_text_field($data['departure_time'] ?? ($session['departure_time'] ?? ''));
4020 $availability_id = $data['availability_id'] ?? ($session['availability_id'] ?? null);
4021 $pricing_type_from_request = sanitize_text_field($data['pricing_type'] ?? ($session['pricing_type'] ?? ''));
4022 $payment_method = strtolower(trim(sanitize_text_field($data['payment_method'] ?? ($session['payment_method'] ?? 'full'))));
4023 if ($payment_method === '') {
4024 $payment_method = 'full';
4025 }
4026 $selected_service_ids_from_request = $data['additional_services'] ?? ($session['additional_services'] ?? null);
4027
4028 // IMPORTANT: Always read coupon from SESSION (not request) to maintain applied discount
4029 $coupon_code = isset($session['coupon']['code']) ? sanitize_text_field($session['coupon']['code']) : '';
4030
4031
4032 if (empty($trip_id)) {
4033 return new WP_REST_Response([
4034 'success' => false,
4035 'message' => __('No active booking session found.', 'yatra'),
4036 ], 400);
4037 }
4038
4039 // Get trip data
4040 $trip = $this->tripRepository->findPublished($trip_id);
4041 if (!$trip) {
4042 return new WP_REST_Response([
4043 'success' => false,
4044 'message' => __('Trip not found.', 'yatra'),
4045 ], 404);
4046 }
4047
4048 // Ensure pricing fields are properly set
4049 $trip->original_price = (float) ($trip->original_price ?? 0);
4050 $trip->discounted_price = !empty($trip->discounted_price) ? (float) $trip->discounted_price : 0;
4051 $trip->sale_price = !empty($trip->sale_price) ? (float) $trip->sale_price : 0;
4052
4053 yatra_start_session();
4054 $existing_session = yatra_get_booking_session();
4055
4056 global $wpdb;
4057
4058 $availability = null;
4059 if (!empty($travel_date)) {
4060 // Use the same resolver as the single-trip UI so rule slots, manual dates,
4061 // and flexible defaults all return a consistent object shape.
4062 try {
4063 $resolver = new \Yatra\Services\AvailabilityResolutionService();
4064 $availability = $resolver->resolveAvailabilityForDate(
4065 $trip_id,
4066 $travel_date,
4067 $departure_time !== '' ? $departure_time : null
4068 );
4069 } catch (\Throwable $e) {
4070 $availability = null;
4071 }
4072 } elseif (!empty($availability_id) && is_numeric($availability_id)) {
4073 // Back-compat: allow summary by numeric availability_id only.
4074 $availability = $this->availabilityService->getById((int) $availability_id);
4075 }
4076
4077 // Resolve pricing type and price_types via centralized TripPricingService
4078 $resolved_pricing_type = !empty($pricing_type_from_request)
4079 ? $pricing_type_from_request
4080 : \Yatra\Services\TripPricingService::resolvePricingType($trip);
4081
4082 $price_types = [];
4083
4084 // First priority: availability price_types (already includes trip fallback from AvailabilityResolutionService)
4085 if ($availability && !empty($availability->price_types)) {
4086 $avail_pts = is_string($availability->price_types)
4087 ? (json_decode($availability->price_types, true) ?: [])
4088 : $availability->price_types;
4089 if (!empty($avail_pts) && is_array($avail_pts)) {
4090 $price_types = array_map(function ($pt) { return (object) $pt; }, $avail_pts);
4091 }
4092 }
4093 // Second priority: trip's price_types via centralized normalizer
4094 if (empty($price_types)) {
4095 $normalized = \Yatra\Services\TripPricingService::resolvePriceTypes($trip);
4096 if (!empty($normalized)) {
4097 $price_types = array_map(function ($pt) { return (object) $pt; }, $normalized);
4098 }
4099 }
4100 // Auto-detect traveler_based if price_types are present
4101 if (!empty($price_types)) {
4102 $resolved_pricing_type = 'traveler_based';
4103 }
4104
4105 // Resolve pricing_mode / group-size limits authoritatively from the
4106 // TravelerCategory so the summary breakdown treats a per-group category
4107 // as a flat charge. No-op for per-person categories.
4108 if (!empty($price_types)) {
4109 $price_types = \Yatra\Services\TripPricingService::applyCategoryPricingMeta($price_types);
4110 }
4111
4112 // Enrich availability price_types with category labels if missing
4113 if (!empty($price_types)) {
4114 $missing_label_category_ids = [];
4115 foreach ($price_types as $pt) {
4116 $pt = (object) $pt;
4117 if (empty($pt->category_label) && !empty($pt->category_id)) {
4118 $missing_label_category_ids[] = (int) $pt->category_id;
4119 }
4120 }
4121
4122 $missing_label_category_ids = array_values(array_unique(array_filter($missing_label_category_ids)));
4123 if (!empty($missing_label_category_ids)) {
4124 // Use AvailabilityService to get traveler categories
4125 $cats = $this->availabilityService->getTravelerCategories($missing_label_category_ids);
4126
4127 $catIndex = [];
4128 foreach ($cats as $cat) {
4129 $catIndex[(int) $cat->id] = $cat;
4130 }
4131
4132 foreach ($price_types as &$pt) {
4133 $pt = (object) $pt;
4134 $catId = !empty($pt->category_id) ? (int) $pt->category_id : null;
4135 if ($catId && isset($catIndex[$catId])) {
4136 $cat = $catIndex[$catId];
4137 if (empty($pt->category_label)) {
4138 $pt->category_label = $cat->label;
4139 }
4140 if (empty($pt->category_slug)) {
4141 $pt->category_slug = $cat->slug;
4142 }
4143 if (!isset($pt->age_min)) {
4144 $pt->age_min = $cat->age_min ? (int) $cat->age_min : null;
4145 }
4146 if (!isset($pt->age_max)) {
4147 $pt->age_max = $cat->age_max ? (int) $cat->age_max : null;
4148 }
4149 }
4150 }
4151 unset($pt);
4152 }
4153 }
4154
4155 foreach ($price_types as $pt) {
4156 $pt->effective_price = $pt->effective_price ?? \Yatra\Services\TripPricingService::resolveCategoryEffectivePrice((array) $pt);
4157 }
4158
4159 if (apply_filters('yatra_dynamic_pricing_enabled', false)) {
4160 $spots_remaining = $availability ? (int) ($availability->spots_remaining ?? null) : null;
4161
4162 foreach ($price_types as $pt) {
4163 if (!isset($pt->effective_price)) {
4164 continue;
4165 }
4166 $price_before = $pt->effective_price;
4167 $pt_orig = (float) ($pt->original_price ?? 0);
4168 $pt->effective_price = apply_filters('yatra_trip_display_price', (float) $pt->effective_price, $trip_id, [
4169 'departure_date' => $travel_date ?: null,
4170 'spots_remaining' => $spots_remaining,
4171 'availability_id' => $availability_id,
4172 'price_type_id' => $pt->id ?? ($pt->price_type_id ?? null),
4173 'original_price' => $pt_orig > 0 ? $pt_orig : (float) $price_before,
4174 'discounted_price' => (float) $price_before,
4175 ]);
4176 }
4177 }
4178
4179 $is_traveler_based = $resolved_pricing_type === 'traveler_based' && !empty($price_types);
4180
4181 // Base trip price via centralized TripPricingService (single source of truth)
4182 $base_trip_price = \Yatra\Services\TripPricingService::resolveRegularCurrentPrice($trip);
4183
4184 // Override with availability pricing if available
4185 if ($availability) {
4186 $avail_price = !empty($availability->discounted_price) && (float) $availability->discounted_price > 0
4187 ? (float) $availability->discounted_price
4188 : (!empty($availability->original_price) && (float) $availability->original_price > 0
4189 ? (float) $availability->original_price : 0);
4190 if ($avail_price > 0) {
4191 $base_trip_price = $avail_price;
4192 }
4193 }
4194
4195 // Apply dynamic pricing filter (Pro DynamicPricingModule hooks here)
4196 if (apply_filters('yatra_dynamic_pricing_enabled', false)) {
4197 $list_for_dp = (float) ($trip->original_price ?? 0);
4198 if ($availability) {
4199 $ao = (float) ($availability->original_price ?? 0);
4200 if ($ao > 0) {
4201 $list_for_dp = $ao;
4202 }
4203 }
4204 $pre_dp_effective = (float) $base_trip_price;
4205 $base_trip_price = apply_filters('yatra_booking_trip_price', $base_trip_price, $trip_id, [
4206 'departure_date' => $travel_date,
4207 'spots_remaining' => $availability ? (int) ($availability->spots_remaining ?? null) : null,
4208 'availability_id' => $availability_id,
4209 'original_price' => $list_for_dp > 0 ? $list_for_dp : $pre_dp_effective,
4210 'discounted_price' => $pre_dp_effective,
4211 ]);
4212 }
4213
4214 // Calculate subtotals per category
4215 $category_breakdown = [];
4216 $subtotal = 0;
4217 $total_travelers = 0;
4218 $normalized_traveler_counts = [];
4219 if (!empty($traveler_counts) && is_array($traveler_counts)) {
4220 foreach ($traveler_counts as $k => $v) {
4221 $key = is_numeric($k) ? (int) $k : (string) $k;
4222 $normalized_traveler_counts[$key] = (int) $v;
4223 }
4224 }
4225
4226 if ($is_traveler_based && !empty($normalized_traveler_counts)) {
4227 foreach ($price_types as $pt) {
4228 $category_id = $pt->category_id;
4229 $count = (int) ($normalized_traveler_counts[(int) $category_id] ?? ($normalized_traveler_counts[(string) $category_id] ?? 0));
4230 if ($count > 0) {
4231 // Single source of truth for the line amount (per-person ×
4232 // count, flat per-group, or per-block group pricing).
4233 $pt_pricing_mode = $pt->pricing_mode ?? 'per_person';
4234 $category_subtotal = \Yatra\Services\TripPricingService::categoryLineSubtotal($pt, $count, (float) $pt->effective_price);
4235 $category_breakdown[] = [
4236 'category_id' => $category_id,
4237 'label' => $pt->category_label ?? __('Traveler', 'yatra'),
4238 'count' => $count,
4239 'price' => (float) $pt->effective_price,
4240 'subtotal' => $category_subtotal,
4241 'pricing_mode' => $pt_pricing_mode,
4242 // Carry the group-size knobs so the reconciliation pass
4243 // below can re-derive the same per-block/flat subtotal.
4244 'max_pax' => isset($pt->max_pax) && $pt->max_pax !== null && $pt->max_pax !== '' ? (int) $pt->max_pax : null,
4245 'group_overflow' => $pt->group_overflow ?? 'block',
4246 ];
4247 $subtotal += $category_subtotal;
4248 $total_travelers += $count;
4249 }
4250 }
4251 } else {
4252 // Regular pricing
4253 $total_travelers = array_sum(array_map('intval', $normalized_traveler_counts));
4254 // If traveler_counts is empty, fallback to session 'travelers' count
4255 if ($total_travelers < 1) {
4256 $total_travelers = !empty($session['travelers']) ? (int) $session['travelers'] : 1;
4257 }
4258 $price_per_person = $base_trip_price;
4259 $subtotal = $price_per_person * $total_travelers;
4260
4261 }
4262
4263 // Calculate group discount
4264 $discountService = new \Yatra\Services\DiscountService();
4265 $travelerCountsForDiscount = [];
4266 if ($is_traveler_based) {
4267 foreach ($normalized_traveler_counts as $k => $v) {
4268 if (is_numeric($k)) {
4269 $travelerCountsForDiscount[(int) $k] = (int) $v;
4270 }
4271 }
4272 }
4273 if (empty($travelerCountsForDiscount)) {
4274 $travelerCountsForDiscount['default'] = $total_travelers;
4275 }
4276
4277 $priceTypesForDiscount = [];
4278 if ($is_traveler_based) {
4279 foreach ($price_types as $pt) {
4280 $pt = (array) $pt;
4281 // Keep pricing_mode / max_pax / group_overflow so the group
4282 // discount base honours flat and per-block group pricing
4283 // (not just category_id + effective_price).
4284 $pt['effective_price'] = $pt['effective_price'] ?? \Yatra\Services\TripPricingService::resolveCategoryEffectivePrice($pt);
4285 $priceTypesForDiscount[] = $pt;
4286 }
4287 } else {
4288 $priceTypesForDiscount[] = [
4289 'category_id' => 'default',
4290 'effective_price' => $base_trip_price,
4291 ];
4292 }
4293
4294 $group_discount = $discountService->calculateGroupDiscount($trip_id, $travelerCountsForDiscount, $priceTypesForDiscount);
4295 $group_discount_amount = $group_discount['amount'] ?? 0;
4296 $group_discount_label = $group_discount['label'] ?? __('Group Discount', 'yatra');
4297 $group_discount_code = $group_discount['code'] ?? null;
4298
4299 // Calculate coupon discount using DiscountService
4300 $coupon_discount_amount = 0;
4301 $coupon_discount_label = '';
4302 $coupon_error = '';
4303
4304 if (!empty($coupon_code)) {
4305 $discountService = new \Yatra\Services\DiscountService();
4306 $subtotal_after_group = $subtotal - $group_discount_amount;
4307
4308 $coupon_result = $discountService->calculateCouponDiscount(
4309 $coupon_code,
4310 $subtotal_after_group,
4311 $trip_id,
4312 $total_travelers,
4313 $is_traveler_based ? $normalized_traveler_counts : []
4314 );
4315
4316 if ($coupon_result['calculated_amount'] > 0) {
4317 $coupon_discount_amount = $coupon_result['calculated_amount'];
4318 $coupon_discount_label = $coupon_result['label'];
4319 } else {
4320 $coupon_error = __('This coupon is not valid for your booking.', 'yatra');
4321 }
4322 }
4323
4324 // Use CalculationService for on-demand pricing calculation
4325 $calculationService = new CalculationService();
4326
4327 // The selected-service ids the customer just submitted live in
4328 // `$selected_service_ids_from_request` (line ~2635). The previous
4329 // version of this method initialised a fresh `$additional_services
4330 // = []` here and passed that empty list into calculateFromSession
4331 // — which made the Pro AdditionalServicesModule's
4332 // `addServicesToSubtotal` hook bail out at its `empty($selectedServiceIds)`
4333 // guard, so every AJAX summary refresh wiped services out of the
4334 // Trip Subtotal even though the sidebar still rendered the rows.
4335 // Pass the real selected ids instead so CalculationService →
4336 // Pro filter chain folds them into `$subtotal` correctly.
4337 $additional_services = is_array($selected_service_ids_from_request)
4338 ? array_values(array_map('intval', $selected_service_ids_from_request))
4339 : [];
4340
4341 // Create session-like data structure for calculation (trip data fetched from database)
4342 $session_like_data = [
4343 'trip_id' => $trip_id,
4344 'travelers' => $total_travelers,
4345 'traveler_counts' => $traveler_counts,
4346 'travel_date' => $travel_date,
4347 'departure_time' => $departure_time,
4348 'additional_services' => $additional_services
4349 ];
4350
4351 // Apply filter for pro plugins to modify summary calculation parameters
4352 $calculation_params = apply_filters('yatra_summary_calculation_params', [
4353 'session_data' => $session_like_data,
4354 'coupon_code' => $coupon_code,
4355 'payment_method' => $payment_method,
4356 ]);
4357
4358 $pricing = $calculationService->calculateFromSession(
4359 $calculation_params['session_data'],
4360 $calculation_params['coupon_code'],
4361 $calculation_params['payment_method']
4362 );
4363
4364 $total_amount = $pricing['final_total'];
4365 $amount_due = $pricing['amount_due'];
4366 $tax_calculation = $pricing['tax_calculation'];
4367 $total_tax_amount = $pricing['tax_calculation']['total_tax_amount'];
4368 $tax_inclusive = $pricing['tax_calculation']['tax_inclusive'];
4369 $tax_breakdown = $pricing['tax_calculation']['tax_breakdown'];
4370
4371 // ── Reconcile per-category display prices with CalculationService ─
4372 //
4373 // The $category_breakdown computed above (~line 3358) used a SEPARATE
4374 // DP filter pass (~line 3290) that's gated on yatra_dynamic_pricing_enabled.
4375 // In certain AJAX-recompute contexts (e.g. switching payment_method)
4376 // that loop could miss DP — for example when a stored availability
4377 // row's price_types already had a pre-DP effective_price baked in,
4378 // or when a date-sensitive DP rule didn't fire because the request
4379 // didn't carry the same departure_date context.
4380 //
4381 // CalculationService is the single source of truth for booking math;
4382 // it already computed the correct post-DP per-category prices and
4383 // returned them as `category_prices_post_dp` (keyed by string
4384 // category_id). Reconcile the display breakdown against that map so
4385 // "Adult x 8 ($131.12 x 8)" can never disagree with the Trip
4386 // Subtotal the rest of the page is built from.
4387 if (!empty($category_breakdown) && !empty($pricing['category_prices_post_dp']) && is_array($pricing['category_prices_post_dp'])) {
4388 $catPricesPostDp = $pricing['category_prices_post_dp'];
4389 $reconciledSubtotal = 0.0;
4390 foreach ($category_breakdown as &$cat) {
4391 $cid = isset($cat['category_id']) ? (string) $cat['category_id'] : '';
4392 if ($cid !== '' && array_key_exists($cid, $catPricesPostDp)) {
4393 $authoritativePrice = (float) $catPricesPostDp[$cid];
4394 $count = (int) ($cat['count'] ?? 0);
4395 $cat['price'] = $authoritativePrice;
4396 // Re-derive the line amount from the authoritative post-DP
4397 // price using the same rule as the charge (flat per-group,
4398 // per-block, or per-person × count).
4399 $cat['subtotal'] = \Yatra\Services\TripPricingService::categoryLineSubtotal($cat, $count, $authoritativePrice);
4400 }
4401 $reconciledSubtotal += (float) ($cat['subtotal'] ?? 0);
4402 }
4403 unset($cat);
4404 // Keep the top-level $subtotal in sync with the reconciled
4405 // breakdown so any downstream renderers that read it (instead
4406 // of $pricing['base_amount']) still see consistent numbers.
4407 if ($reconciledSubtotal > 0) {
4408 $subtotal = $reconciledSubtotal;
4409 }
4410 }
4411
4412 /**
4413 * Filter: Get additional services for this trip
4414 * Allows premium modules to add extra services to the booking summary
4415 *
4416 * @param array $services Empty array by default
4417 * @param int $trip_id The trip ID
4418 * @param int $total_travelers Total number of travelers
4419 * @param array $traveler_counts Traveler counts by category
4420 * @param string $travel_date The travel date
4421 * @since 3.0.0
4422 */
4423 $additional_services = apply_filters('yatra_booking_additional_services', [], $trip_id, $total_travelers, $traveler_counts, $travel_date);
4424
4425 // Get selected services from request (priority) or session
4426 // If request has additional_services, use that; otherwise fall back to session
4427 if ($selected_service_ids_from_request !== null) {
4428 $selected_service_ids = $selected_service_ids_from_request;
4429 } else {
4430 $selected_service_ids = isset($existing_session['additional_services']) && is_array($existing_session['additional_services'])
4431 ? array_map('intval', $existing_session['additional_services'])
4432 : [];
4433 }
4434
4435 // Mark which services are selected and calculate their price based on price_per
4436 $duration_days = (int) ($trip->duration_days ?? 1);
4437 $default_services_total = 0.0;
4438 foreach ($additional_services as &$service) {
4439 $serviceId = (int) $service['id'];
4440 $isInRequest = in_array($serviceId, $selected_service_ids, true);
4441 $isRequired = !empty($service['is_required']);
4442 $isIncluded = !empty($service['is_included']);
4443 $service['selected'] = $isInRequest || $isRequired || $isIncluded;
4444
4445 // Calculate the price based on price_per (person, day, booking)
4446 $basePrice = (float) ($service['price'] ?? 0);
4447 $pricePer = $service['price_per'] ?? 'person';
4448
4449 switch ($pricePer) {
4450 case 'person':
4451 $service['calculated_price'] = $basePrice * $total_travelers;
4452 break;
4453 case 'day':
4454 $service['calculated_price'] = $basePrice * max(1, $duration_days);
4455 break;
4456 case 'booking':
4457 default:
4458 $service['calculated_price'] = $basePrice;
4459 break;
4460 }
4461
4462 if (!empty($service['selected']) && empty($service['is_included'])) {
4463 $default_services_total += (float) $service['calculated_price'];
4464 }
4465 }
4466 unset($service);
4467
4468 /**
4469 * Filter: Calculate additional services total
4470 * Allows premium modules to add services cost to the booking total
4471 *
4472 * @param float $services_total The services total (0 by default)
4473 * @param array $additional_services The services with 'selected' flag
4474 * @param int $trip_id The trip ID
4475 * @param int $total_travelers Total number of travelers
4476 * @param int $duration_days Trip duration in days
4477 * @since 3.0.0
4478 */
4479 $services_total = apply_filters('yatra_booking_services_total', (float) $default_services_total, $additional_services, $trip_id, $total_travelers, (int) ($trip->duration_days ?? 1));
4480
4481 // Get itinerary costs (separate from additional services)
4482 $itinerary_costs = apply_filters('yatra_booking_itinerary_costs', [], $trip_id, $total_travelers, $traveler_counts, $travel_date);
4483 $itinerary_costs_total = 0.0;
4484
4485 foreach ($itinerary_costs as $cost) {
4486 $basePrice = (float) ($cost['price'] ?? 0);
4487 $pricePer = $cost['price_per'] ?? 'person';
4488
4489 switch ($pricePer) {
4490 case 'person':
4491 $calculatedPrice = $basePrice * $total_travelers;
4492 break;
4493 case 'day':
4494 $calculatedPrice = $basePrice * $duration_days;
4495 break;
4496 case 'booking':
4497 default:
4498 $calculatedPrice = $basePrice;
4499 break;
4500 }
4501
4502 $itinerary_costs_total += $calculatedPrice;
4503 }
4504
4505 // Note: CalculationService already includes itinerary costs in final_total
4506 // No need to add itinerary_costs_total again - it's already included in $total_amount
4507
4508 // Calculate due amount based on payment method.
4509 //
4510 // Flow: compute a sensible default using the *percentage* filters (which
4511 // Pro can already override per-trip via trip.deposit_percentage), then
4512 // hand off to `yatra_calculate_amount_due` so Pro can apply absolute
4513 // overrides too (e.g. trip.deposit_amount as a fixed cap). Doing both
4514 // keeps the math consistent with CalculationService::calculatePaymentAmounts().
4515 $context = ['trip_id' => $trip_id];
4516 $flexible_payments_enabled = apply_filters('yatra_flexible_payments_enabled', false);
4517 $deposit_percentage = (int) apply_filters('yatra_deposit_percentage', 20, $context);
4518 $partial_percentage = (int) apply_filters('yatra_partial_payment_percentage', 30, $context);
4519
4520 $amount_due = $total_amount;
4521 if ($payment_method === 'deposit') {
4522 $amount_due = $total_amount * ($deposit_percentage / 100);
4523 } elseif ($payment_method === 'partial') {
4524 $amount_due = $total_amount * ($partial_percentage / 100);
4525 }
4526
4527 $amount_due = (float) apply_filters(
4528 'yatra_calculate_amount_due',
4529 $amount_due,
4530 $total_amount,
4531 $payment_method,
4532 $context
4533 );
4534
4535 Logger::debug('Yatra booking summary: payment method and amount due', [
4536 'context' => 'booking_summary_rest',
4537 'trip_id' => $trip_id,
4538 'flexible_payments_enabled' => $flexible_payments_enabled,
4539 'payment_method' => $payment_method,
4540 'total_amount' => round($total_amount, 4),
4541 'amount_due' => round($amount_due, 4),
4542 'deposit_percentage' => $deposit_percentage,
4543 'partial_percentage' => $partial_percentage,
4544 ]);
4545
4546 // Build pricing HTML for the summary section (using CalculationService data)
4547 $pricing_html = $this->buildPricingHtml([
4548 'is_traveler_based' => $is_traveler_based,
4549 'category_breakdown' => $category_breakdown,
4550 'price_per_person' => $price_per_person ?? $base_trip_price,
4551 'total_travelers' => $total_travelers,
4552 'gross_total' => $pricing['gross_total'] ?? $pricing['base_amount'],
4553 'subtotal' => $pricing['gross_total'] ?? $pricing['base_amount'],
4554 'taxable_amount' => $pricing['taxable_amount'] ?? 0,
4555 'group_discount_amount' => $pricing['group_discount']['amount'] ?? 0,
4556 'group_discount_label' => $pricing['group_discount']['label'] ?? '',
4557 'coupon_discount_amount' => $pricing['coupon_discount']['calculated_amount'] ?? 0,
4558 'coupon_discount_label' => $pricing['coupon_discount']['label'] ?? '',
4559 'coupon_code' => $pricing['coupon_discount']['code'] ?? '',
4560 'additional_services' => $additional_services,
4561 'services_total' => $services_total,
4562 'itinerary_costs' => $itinerary_costs,
4563 'itinerary_costs_total' => $itinerary_costs_total,
4564 'total_amount' => $total_amount,
4565 'amount_due' => $amount_due,
4566 'payment_method' => $payment_method,
4567 'deposit_percentage' => $deposit_percentage,
4568 'partial_percentage' => $partial_percentage,
4569 // Tax variables from centralized calculation
4570 'enable_tax' => $pricing['tax_calculation']['enable_tax'],
4571 'tax_breakdown' => $pricing['tax_calculation']['tax_breakdown'],
4572 'total_tax_amount' => $pricing['tax_calculation']['total_tax_amount'],
4573 'tax_inclusive' => $pricing['tax_calculation']['tax_inclusive'],
4574 // Dynamic-pricing data — without these, the AJAX-refreshed summary
4575 // would never carry the DP line items even though CalculationService
4576 // produces them on every recalculation.
4577 'dynamic_pricing' => $pricing['dynamic_pricing'] ?? null,
4578 'unit_price_before_dp' => $pricing['unit_price_before_dp'] ?? null,
4579 'dp_total_adjustment' => $pricing['dp_total_adjustment'] ?? 0,
4580 // Authoritative post-DP per-category map. Checkout::getCategoryBreakdown
4581 // prefers this over the session's $pt->effective_price (which can be
4582 // pre-DP after a stored availability row's price_types come in
4583 // pre-baked), so forwarding it here is what keeps the AJAX-rendered
4584 // "Adult x N ($X x N)" row in sync with the actual Trip Subtotal.
4585 'category_prices_post_dp' => $pricing['category_prices_post_dp'] ?? [],
4586 // Currency for consistent formatting
4587 'currency' => $pricing['currency'] ?? \Yatra\Services\SettingsService::getCurrency(),
4588 ]);
4589
4590 // Build response
4591 return new WP_REST_Response([
4592 'success' => true,
4593 'data' => [
4594 'is_traveler_based' => $is_traveler_based,
4595 'category_breakdown' => $category_breakdown,
4596 'subtotal' => round($subtotal, 2),
4597 'subtotal_formatted' => yatra_format_price($subtotal),
4598 'total_travelers' => $total_travelers,
4599 'group_discount' => $group_discount ? [
4600 'amount' => round($group_discount_amount, 2),
4601 'amount_formatted' => yatra_format_price($group_discount_amount),
4602 'label' => $group_discount_label,
4603 'code' => $group_discount_code,
4604 'applied_categories' => $group_discount['applied_categories'] ?? [],
4605 ] : null,
4606 'coupon_discount' => $coupon_discount_amount > 0 ? [
4607 'amount' => round($coupon_discount_amount, 2),
4608 'amount_formatted' => yatra_format_price($coupon_discount_amount),
4609 'label' => $coupon_discount_label,
4610 'code' => $coupon_code,
4611 ] : null,
4612 'coupon_error' => $coupon_error,
4613 'total_discount' => round($group_discount_amount + $coupon_discount_amount, 2),
4614 'total_discount_formatted' => yatra_format_price($group_discount_amount + $coupon_discount_amount),
4615 // Additional services (premium feature)
4616 'additional_services' => $additional_services,
4617 'services_total' => round($services_total, 2),
4618 'services_total_formatted' => yatra_format_price($services_total),
4619 // Itinerary costs (separate from services)
4620 'itinerary_costs' => $itinerary_costs,
4621 'itinerary_costs_total' => round($itinerary_costs_total, 2),
4622 'itinerary_costs_total_formatted' => yatra_format_price($itinerary_costs_total),
4623 'total_amount' => round($total_amount, 2),
4624 'total_amount_formatted' => yatra_format_price($total_amount),
4625 'amount_due' => round($amount_due, 2),
4626 'amount_due_formatted' => yatra_format_price($amount_due),
4627 'deposit_percentage' => $deposit_percentage,
4628 'partial_percentage' => $partial_percentage,
4629 // HTML for the pricing section
4630 'pricing_html' => $pricing_html,
4631 ],
4632 ]);
4633 }
4634
4635 /**
4636 * Build HTML for the pricing summary section
4637 * This is returned via AJAX to update the pricing breakdown dynamically
4638 * Uses the pricing-summary.php template for rendering with Checkout model
4639 */
4640 private function buildPricingHtml(array $data): string
4641 {
4642 // Get session data to create Checkout model
4643 yatra_start_session();
4644 $session = yatra_get_booking_session();
4645
4646 // Get trip data
4647 $trip_id = (int) ($session['trip_id'] ?? 0);
4648 if (empty($trip_id)) {
4649 return '<p>' . __('Pricing information not available.', 'yatra') . '</p>';
4650 }
4651
4652 $tripRepository = new \Yatra\Repositories\TripRepository();
4653 $trip = $tripRepository->findPublished($trip_id);
4654 if (!$trip) {
4655 return '<p>' . __('Trip not found.', 'yatra') . '</p>';
4656 }
4657
4658 // Build pricing calculation array from data (centralized pricing)
4659 $resolvedCurrentPrice = \Yatra\Services\TripPricingService::resolveRegularCurrentPrice($trip);
4660 $pricingCalculation = [
4661 'original_price' => $trip->original_price ?? 0,
4662 'discounted_price' => $resolvedCurrentPrice,
4663 'unit_price' => $data['price_per_person'] ?? $resolvedCurrentPrice,
4664 'pricing_type' => $session['pricing_type'] ?? 'regular',
4665 'base_amount' => $data['gross_total'] ?? 0,
4666 'subtotal' => $data['subtotal'] ?? $data['gross_total'] ?? 0,
4667 'taxable_amount' => $data['taxable_amount'] ?? 0,
4668 'gross_total' => $data['gross_total'] ?? 0,
4669 'final_total' => $data['total_amount'] ?? 0,
4670 'amount_due' => $data['amount_due'] ?? 0,
4671 'travelers_count' => $data['total_travelers'] ?? 1,
4672 'is_traveler_based' => $data['is_traveler_based'] ?? false,
4673 'category_breakdown' => $data['category_breakdown'] ?? [],
4674 'group_discount' => [
4675 'amount' => $data['group_discount_amount'] ?? 0,
4676 'label' => $data['group_discount_label'] ?? '',
4677 ],
4678 'coupon_discount' => [
4679 'code' => $data['coupon_code'] ?? '',
4680 'calculated_amount' => $data['coupon_discount_amount'] ?? 0,
4681 'label' => $data['coupon_discount_label'] ?? '',
4682 ],
4683 'total_discount_amount' => ($data['group_discount_amount'] ?? 0) + ($data['coupon_discount_amount'] ?? 0),
4684 'additional_services' => $data['additional_services'] ?? [],
4685 'services_total' => $data['services_total'] ?? 0,
4686 'itinerary_costs' => $data['itinerary_costs'] ?? [],
4687 'itinerary_costs_total' => $data['itinerary_costs_total'] ?? 0,
4688 'tax_calculation' => [
4689 'enable_tax' => $data['enable_tax'] ?? false,
4690 'tax_breakdown' => $data['tax_breakdown'] ?? [],
4691 'total_tax_amount' => $data['total_tax_amount'] ?? 0,
4692 'tax_inclusive' => $data['tax_inclusive'] ?? false,
4693 ],
4694 // Dynamic-pricing breakdown — without this, the AJAX-refreshed
4695 // sidebar would never show DP line items even though the page-load
4696 // path does. Keys match CalculationService's pricing_data shape so
4697 // Checkout::getDynamicPricing() returns identical results in both
4698 // render contexts.
4699 'dynamic_pricing' => $data['dynamic_pricing'] ?? null,
4700 'unit_price_before_dp' => $data['unit_price_before_dp'] ?? null,
4701 'dp_total_adjustment' => $data['dp_total_adjustment'] ?? 0,
4702 // Authoritative post-DP per-category prices. Checkout::getCategoryBreakdown
4703 // keys off this to override the (potentially stale / pre-DP)
4704 // $pt->effective_price coming from session price_types — without
4705 // it, the AJAX recompute renders pre-DP rows while the rest of
4706 // the summary uses the post-DP base amount.
4707 'category_prices_post_dp' => $data['category_prices_post_dp'] ?? [],
4708 'currency' => $data['currency'] ?? null,
4709 ];
4710
4711 // Update session with payment method if provided
4712 if (!empty($data['payment_method'])) {
4713 $session['payment_method'] = $data['payment_method'];
4714 }
4715 if (!empty($data['deposit_percentage'])) {
4716 $session['deposit_percentage'] = $data['deposit_percentage'];
4717 }
4718 if (!empty($data['partial_payment_percentage'])) {
4719 $session['partial_payment_percentage'] = $data['partial_payment_percentage'];
4720 }
4721 if (!empty($data['partial_percentage'])) {
4722 $session['partial_payment_percentage'] = $data['partial_percentage'];
4723 }
4724
4725 if (!empty($data['payment_method']) || !empty($data['deposit_percentage']) || !empty($data['partial_percentage']) || !empty($data['partial_payment_percentage'])) {
4726 yatra_set_booking_session($session);
4727 }
4728
4729 // Create Checkout model instance
4730 $checkout = new \Yatra\Models\Checkout($trip, $session, $pricingCalculation);
4731
4732 // Surface dynamic-pricing breakdown to the template scope. The partial
4733 // reads `$dynamic_pricing` for the DP block; the page-load path
4734 // already sets this in booking-content.php.
4735 $dynamic_pricing = $pricingCalculation['dynamic_pricing'] ?? null;
4736 $currency = $pricingCalculation['currency'] ?? null;
4737
4738 // Load the template (uses $checkout model)
4739 $template_path = YATRA_PLUGIN_PATH . 'templates/partials/pricing-summary.php';
4740
4741 if (!file_exists($template_path)) {
4742 return '<p>' . __('Template not found.', 'yatra') . '</p>';
4743 }
4744
4745 // Use output buffering to capture the template output
4746 ob_start();
4747 include $template_path;
4748 return ob_get_clean();
4749 }
4750
4751 /**
4752 * Remove coupon code from booking session
4753 */
4754 public function remove_coupon(WP_REST_Request $request): WP_REST_Response
4755 {
4756 yatra_start_session();
4757
4758 $data = $request->get_json_params() ?? [];
4759
4760 // M-2: restore CSRF protection stripped by public_permission_callback.
4761 if (($blocked = $this->guardPublicBookingMutation($request, $data)) !== null) {
4762 return $blocked;
4763 }
4764
4765 $session = yatra_get_booking_session();
4766
4767 // Same booking_token rehydration as apply_coupon — handle REST
4768 // requests that arrive without a propagated PHPSESSID.
4769 if (empty($session) || empty($session['trip_id'])) {
4770 $token = null;
4771 if (!empty($data['booking_token']) && is_string($data['booking_token'])) {
4772 $token = sanitize_text_field((string) $data['booking_token']);
4773 } elseif (isset($_GET['booking_token']) && is_string($_GET['booking_token'])) {
4774 $token = sanitize_text_field((string) wp_unslash($_GET['booking_token']));
4775 }
4776 if ($token) {
4777 $transient_data = get_transient($token);
4778 if (is_array($transient_data) && !empty($transient_data['trip_id'])) {
4779 $session = $transient_data;
4780 $_SESSION['yatra_booking'] = $session;
4781 $_SESSION['yatra_booking_token'] = $token;
4782 }
4783 }
4784 }
4785
4786 if (empty($session)) {
4787 return new WP_REST_Response([
4788 'success' => false,
4789 'message' => __('No active booking session found.', 'yatra'),
4790 ], 400);
4791 }
4792
4793 // Remove coupon directly from session to avoid array_merge issues
4794 if (isset($_SESSION['yatra_booking']['coupon'])) {
4795 unset($_SESSION['yatra_booking']['coupon']);
4796 }
4797 $_SESSION['yatra_booking']['timestamp'] = time();
4798
4799 // Also update local session array for calculation
4800 unset($session['coupon']);
4801 $session['timestamp'] = time();
4802
4803 // Persist the coupon removal to the transient too — without this,
4804 // the next /booking/summary AJAX (which the JS calls right after
4805 // this endpoint) re-reads the still-couponed transient and the
4806 // sidebar shows the coupon discount as if it never went away.
4807 // `yatra_set_booking_session()` array_merges `$_SESSION['yatra_booking']`
4808 // (already coupon-less above) with the passed data and writes the
4809 // result into the transient keyed by the existing booking token.
4810 yatra_set_booking_session($session);
4811
4812 // Ensure session data is written immediately
4813 if (session_status() === PHP_SESSION_ACTIVE) {
4814 session_write_close();
4815 }
4816
4817 $total_amount = $this->calculateSessionTotal($session);
4818
4819 return new WP_REST_Response([
4820 'success' => true,
4821 'message' => __('Coupon removed.', 'yatra'),
4822 'data' => [
4823 'new_total' => $total_amount,
4824 'new_total_formatted' => yatra_format_price($total_amount),
4825 ],
4826 ]);
4827 }
4828
4829 /**
4830 * Calculate total amount from session
4831 * Uses CalculationService to get accurate pricing (without coupon)
4832 */
4833 private function calculateSessionTotal(array $session): float
4834 {
4835 // Use CalculationService to get accurate base pricing
4836 $calculationService = new \Yatra\Services\CalculationService();
4837
4838 try {
4839 // Calculate pricing WITHOUT coupon (we're calculating this to apply coupon to it)
4840 $pricing = $calculationService->calculateFromSession($session, '');
4841
4842 // Return gross_total (base amount before discounts but after any group discounts)
4843 $total = $pricing['gross_total'] ?? 0;
4844
4845 return (float) $total;
4846 } catch (\Throwable $e) {
4847 return 0.0;
4848 }
4849 }
4850
4851 /**
4852 * @deprecated Use DiscountService::calculateCouponDiscount() instead
4853 * Calculate discount amount
4854 */
4855 private function calculateDiscountAmount(\stdClass $discount, float $total, array $session): float
4856 {
4857 $discount_amount = 0;
4858
4859 // Check if group discount applies
4860 if ($discount->is_group_discount && !empty($discount->min_group_size)) {
4861 $travelers = (int) ($session['travelers'] ?? 1);
4862 if ($travelers >= (int) $discount->min_group_size && !empty($discount->group_discount_amount)) {
4863 // Apply group discount
4864 if ($discount->group_discount_type === 'percentage') {
4865 $discount_amount = $total * ((float) $discount->group_discount_amount / 100);
4866 } else {
4867 $discount_amount = (float) $discount->group_discount_amount;
4868 }
4869 }
4870 }
4871
4872 // If no group discount, apply regular discount
4873 if ($discount_amount === 0) {
4874 if ($discount->type === 'percentage') {
4875 $discount_amount = $total * ((float) $discount->amount / 100);
4876 } else {
4877 $discount_amount = (float) $discount->amount;
4878 }
4879 }
4880
4881 // Apply max discount cap if set
4882 if (!empty($discount->max_discount_amount) && $discount_amount > (float) $discount->max_discount_amount) {
4883 $discount_amount = (float) $discount->max_discount_amount;
4884 }
4885
4886 // Ensure discount doesn't exceed total
4887 if ($discount_amount > $total) {
4888 $discount_amount = $total;
4889 }
4890
4891 return round($discount_amount, 2);
4892 }
4893
4894 /**
4895 * Get coupon usage count by user
4896 */
4897 private function getCouponUsageByUser(string $discount_code, int $user_id): int
4898 {
4899 // Use AvailabilityService to check discount code usage
4900 return $this->availabilityService->getDiscountCodeUsage($user_id, strtoupper(sanitize_text_field($discount_code)));
4901 }
4902 }
4903
4904