PluginProbe
Yatra – Travel Booking & Tour Operator Software / 3.0.9
Yatra – Travel Booking & Tour Operator Software v3.0.9
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.9, at app/Controllers/BookingSessionController.php

4,812 lines 224.6 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 // ========================================
1210 // CSRF — booking-scoped action nonce
1211 // ========================================
1212 // The public_permission_callback on this route intentionally
1213 // bypasses WP's default cookie/nonce check so guests can hit it
1214 // at all. That bypass would otherwise leave the endpoint open
1215 // to cross-site forgery (any third-party page could POST a
1216 // booking using the visitor's session).
1217 //
1218 // We validate a booking-scoped action nonce here instead. The
1219 // token is minted at page-render time (FrontendAssetsProvider
1220 // injects it into `yatraBookingData.bookingNonce`) and the JS
1221 // forwards it in `X-Yatra-Booking-Nonce`. We also accept it in
1222 // the JSON body for any non-JS fallback flow.
1223 //
1224 // Returns 403 on failure — distinct from the 401 used by the
1225 // login/guest-checkout gates so frontends can distinguish
1226 // "security check failed" from "auth required".
1227 if (!$this->verifyBookingNonce($request, $data)) {
1228 return new WP_REST_Response([
1229 'success' => false,
1230 'message' => __('Security check failed. Please refresh the page and try again.', 'yatra'),
1231 'code' => 'invalid_nonce',
1232 ], 403);
1233 }
1234
1235 // ========================================
1236 // REMAINING PAYMENT vs NEW BOOKING
1237 // ========================================
1238 // A leftover PHP session from "pay remaining balance" must not hijack a normal
1239 // checkout POST (full traveler payload). Only treat as remaining-payment when the
1240 // client is actually on that flow (hidden field) or sends no new-booking travelers.
1241 // Early return: process_remaining_payment() — no createBooking().
1242 if (yatra_has_remaining_session()) {
1243 $is_remaining_checkout = !empty($data['is_remaining_payment']);
1244 $travelers_payload = $data['travelers'] ?? null;
1245 $has_new_booking_travelers = is_array($travelers_payload) && count($travelers_payload) > 0;
1246
1247 if ($is_remaining_checkout) {
1248 return $this->process_remaining_payment($request);
1249 }
1250
1251 if ($has_new_booking_travelers) {
1252 yatra_clear_remaining_session();
1253 } else {
1254 return $this->process_remaining_payment($request);
1255 }
1256 }
1257
1258 // ========================================
1259 // NEW BOOKING CHECKOUT (not pay-remaining)
1260 // ========================================
1261 // Below: createBooking() runs once; payment is initiated afterward if amount_due > 0.
1262
1263 // ========================================
1264 // GET BOOKING SETTINGS
1265 // ========================================
1266 $settings = [
1267 'booking_confirmation' => \Yatra\Services\SettingsService::get('booking_confirmation', true),
1268 'auto_confirm_bookings' => \Yatra\Services\SettingsService::get('auto_confirm_bookings', false),
1269 'require_login' => \Yatra\Services\SettingsService::get('require_login', false),
1270 'allow_guest_checkout' => \Yatra\Services\SettingsService::get('allow_guest_checkout', true),
1271 'booking_expiry_hours' => (int) \Yatra\Services\SettingsService::get('booking_expiry_hours', 24),
1272 'auto_confirm_pay_later' => \Yatra\Services\SettingsService::get('auto_confirm_pay_later', true),
1273 ];
1274
1275 // ========================================
1276 // CHECK LOGIN REQUIREMENT
1277 // ========================================
1278 if ($settings['require_login'] && !is_user_logged_in()) {
1279 return new WP_REST_Response([
1280 'success' => false,
1281 'message' => __('You must be logged in to make a booking.', 'yatra'),
1282 'code' => 'login_required',
1283 'login_url' => wp_login_url(home_url($_SERVER['REQUEST_URI'] ?? '')),
1284 ], 401);
1285 }
1286
1287 // Check guest checkout
1288 if (!$settings['allow_guest_checkout'] && !is_user_logged_in()) {
1289 return new WP_REST_Response([
1290 'success' => false,
1291 'message' => __('Guest checkout is not allowed. Please log in or create an account.', 'yatra'),
1292 'code' => 'guest_not_allowed',
1293 'login_url' => wp_login_url(home_url($_SERVER['REQUEST_URI'] ?? '')),
1294 ], 401);
1295 }
1296
1297 // ========================================
1298 // GUEST EMAIL VERIFICATION GATE
1299 // ========================================
1300 // When `require_guest_email_verification` is on AND the
1301 // customer is not logged in, the booking goes through a
1302 // two-step flow:
1303 // 1. Booking row is created with status='pending_verification'
1304 // so the operator sees the intent in the admin and the
1305 // cron can purge unverified rows after N days.
1306 // 2. A magic-link email is sent. Payment is NOT initiated
1307 // until the customer clicks the link.
1308 // 3. On click, /yatra/v1/booking/verify-email validates the
1309 // HMAC token, flips status to 'pending', and redirects
1310 // to the payment continuation URL.
1311 // Logged-in users skip this entirely — their email is already
1312 // verified by WordPress on registration.
1313 $needs_email_verification = !is_user_logged_in()
1314 && (bool) \Yatra\Services\SettingsService::get('require_guest_email_verification', false);
1315
1316 // Get session data
1317 $session = yatra_get_booking_session();
1318
1319 // REST requests don't always carry PHPSESSID in the same scope as the
1320 // page that rendered the booking form (cookie path mismatches, output
1321 // buffering before session_start, server-side caching, etc). When
1322 // `$session` is empty we try to rehydrate from the transient backup that
1323 // BookingPageHandler writes when the form is rendered — the JS submit
1324 // now carries `booking_token` in the request body for exactly this
1325 // recovery path. Without this, `traveler_counts` / `pricing_type` /
1326 // `price_types` are lost and a `traveler_based` trip's
1327 // calculatePricing() collapses to 0, then BookingService rejects with
1328 // "Total amount must be greater than zero."
1329 if ((empty($session) || empty($session['trip_id'])) && !empty($data['booking_token'])) {
1330 $tokenFromBody = sanitize_text_field((string) $data['booking_token']);
1331 if ($tokenFromBody !== '') {
1332 $transient_data = get_transient($tokenFromBody);
1333 if (is_array($transient_data) && !empty($transient_data['trip_id'])) {
1334 $session = $transient_data;
1335 }
1336 }
1337 }
1338
1339 // Validate we have session data or direct booking data
1340 $trip_id = !empty($data['trip_id']) ? (int) $data['trip_id'] : ($session['trip_id'] ?? 0);
1341
1342 if (!$trip_id) {
1343 return new WP_REST_Response([
1344 'success' => false,
1345 'message' => __('No trip selected for booking.', 'yatra'),
1346 ], 400);
1347 }
1348
1349 // Which booking-form sections are enabled (Pro Dynamic Form module).
1350 // The default config has every section enabled, so on existing/un-customised
1351 // sites $contact_enabled and $traveler_enabled are both true and the logic
1352 // below behaves exactly as before — only disabled sections change anything.
1353 $form_config = function_exists('yatra_get_booking_form_config') ? yatra_get_booking_form_config() : [];
1354 $contact_enabled = !isset($form_config['contact_form']['enabled']) || (bool) $form_config['contact_form']['enabled'];
1355 $traveler_enabled = !isset($form_config['traveler_form']['enabled']) || (bool) $form_config['traveler_form']['enabled'];
1356
1357 // Get contact email - handle both flat and nested formats
1358 $contact_email = trim((string) ($data['contact_email'] ?? ''));
1359 $contact_phone = $data['contact_phone'] ?? '';
1360 // International phone widget: fold the chosen country (companion
1361 // *_country field carrying the ISO) into the number as "+<dial><digits>".
1362 // A no-op for legacy submissions with no companion field, an already
1363 // "+"-prefixed value, or an unknown ISO — so existing data is never
1364 // altered and nothing is invented.
1365 $contact_phone = \Yatra\Helpers\FormatHelper::combineInternationalPhone(
1366 (string) $contact_phone,
1367 (string) ($data['contact_phone_country'] ?? '')
1368 );
1369 $contact_first_name = $data['contact_first_name'] ?? '';
1370 $contact_last_name = $data['contact_last_name'] ?? '';
1371 $contact_country = $data['contact_country'] ?? '';
1372
1373 $contact_nationality = $data['contact_nationality'] ?? '';
1374 $contact_address = $data['contact_address'] ?? '';
1375
1376 // Emergency contact
1377 $emergency_name = $data['emergency_name'] ?? '';
1378 $emergency_phone = \Yatra\Helpers\FormatHelper::combineInternationalPhone(
1379 (string) ($data['emergency_phone'] ?? ''),
1380 (string) ($data['emergency_phone_country'] ?? '')
1381 );
1382 $emergency_relationship = $data['emergency_relationship'] ?? '';
1383
1384 // Travel details
1385 $travel_date = $data['travel_date'] ?? ($session['travel_date'] ?? '');
1386 $travelers = $data['travelers'] ?? [];
1387
1388 // EMAIL RESOLUTION: prefer the Contact email. When it's missing — the
1389 // Contact section is off, or the operator collects email through a
1390 // CUSTOM email-type field rather than the locked core `email` field —
1391 // resolve it from the form config instead, mirroring the admin
1392 // "form captures email" notice (contact + traveler sections). At least
1393 // one enabled form must capture an email; the form builder warns the
1394 // operator about this too. On a default form the core `email` field
1395 // already populated $contact_email, so none of the fallbacks run.
1396
1397 // (a) Custom email-type field in the Contact section (submitted as
1398 // contact_<id>). The core `email` field is already read above, so skip
1399 // it here.
1400 if ($contact_email === '' && $contact_enabled) {
1401 foreach ($this->emailFieldIds($form_config['contact_form'] ?? []) as $fid) {
1402 if ($fid === 'email') {
1403 continue;
1404 }
1405 $val = trim((string) ($data['contact_' . $fid] ?? ''));
1406 if ($val !== '' && is_email($val)) {
1407 $contact_email = $val;
1408 break;
1409 }
1410 }
1411 }
1412
1413 // (b) Fall back to a traveler email — the conventional `email` key OR
1414 // any traveler email-type field — adopting the lead traveler's
1415 // name/phone as the contact when the Contact section is off, so the
1416 // booking/customer isn't nameless. On a default form this checks only
1417 // $t['email'], identical to the original behaviour.
1418 if ($contact_email === '' && is_array($travelers)) {
1419 $traveler_email_ids = $traveler_enabled
1420 ? $this->emailFieldIds($form_config['traveler_form'] ?? [])
1421 : [];
1422 if (!in_array('email', $traveler_email_ids, true)) {
1423 $traveler_email_ids[] = 'email';
1424 }
1425 foreach ($travelers as $t) {
1426 if (!is_array($t)) {
1427 continue;
1428 }
1429 $found = '';
1430 foreach ($traveler_email_ids as $fid) {
1431 if (!empty($t[$fid]) && is_email((string) $t[$fid])) {
1432 $found = trim((string) $t[$fid]);
1433 break;
1434 }
1435 }
1436 if ($found !== '') {
1437 $contact_email = $found;
1438 if ($contact_first_name === '') { $contact_first_name = (string) ($t['first_name'] ?? ''); }
1439 if ($contact_last_name === '') { $contact_last_name = (string) ($t['last_name'] ?? ''); }
1440 if (empty($contact_phone) && !empty($t['phone'])) { $contact_phone = (string) $t['phone']; }
1441 break;
1442 }
1443 }
1444 }
1445
1446 // When the Traveler form is disabled there are no per-traveler fields, so
1447 // build traveler rows from the selected count and use the lead contact as
1448 // traveler 1 (book-by-count). Only runs when the section is off.
1449 if (!$traveler_enabled && (empty($travelers) || !is_array($travelers))) {
1450 $synth_count = (int) ($data['travelers_count']
1451 ?? $session['travelers']
1452 ?? (is_array($session['traveler_counts'] ?? null) ? array_sum(array_map('intval', $session['traveler_counts'])) : 0));
1453 $synth_count = max(1, $synth_count);
1454 $travelers = [];
1455 for ($i = 1; $i <= $synth_count; $i++) {
1456 $travelers[] = [
1457 'type' => 'traveler',
1458 'first_name' => $i === 1 ? $contact_first_name : '',
1459 'last_name' => $i === 1 ? $contact_last_name : '',
1460 'email' => $i === 1 ? $contact_email : '',
1461 ];
1462 }
1463 }
1464
1465 // Validate required fields — email is always required (resolved above).
1466 if ($contact_email === '' || !is_email($contact_email)) {
1467 return new WP_REST_Response([
1468 'success' => false,
1469 'message' => __('A valid email address is required to complete this booking.', 'yatra'),
1470 ], 400);
1471 }
1472
1473 // Phone belongs to the Contact section. Require it only when that section
1474 // is enabled AND the phone field is itself enabled+required in the config,
1475 // so an operator who made phone optional (or disabled it) via the Dynamic
1476 // Form module isn't blocked on a field the customer never saw. On a
1477 // default form phone is locked+required, so this is unchanged for
1478 // existing Free/Pro users.
1479 $contact_phone_required = false;
1480 if ($contact_enabled && !empty($form_config['contact_form']['fields']) && is_array($form_config['contact_form']['fields'])) {
1481 foreach ($form_config['contact_form']['fields'] as $cf) {
1482 if (is_array($cf) && ($cf['id'] ?? '') === 'phone') {
1483 $cf_enabled = !isset($cf['enabled']) || (bool) $cf['enabled'];
1484 $contact_phone_required = $cf_enabled && !empty($cf['required']);
1485 break;
1486 }
1487 }
1488 } elseif ($contact_enabled) {
1489 // No field metadata available (legacy/edge): preserve the original
1490 // "require phone when contact is on" behaviour.
1491 $contact_phone_required = true;
1492 }
1493 if ($contact_phone_required && empty($contact_phone)) {
1494 return new WP_REST_Response([
1495 'success' => false,
1496 'message' => __('Phone number is required.', 'yatra'),
1497 ], 400);
1498 }
1499
1500 if (empty($travel_date)) {
1501 return new WP_REST_Response([
1502 'success' => false,
1503 'message' => __('Travel date is required.', 'yatra'),
1504 ], 400);
1505 }
1506
1507 if (empty($travelers) || !is_array($travelers)) {
1508 return new WP_REST_Response([
1509 'success' => false,
1510 'message' => __('At least one traveler is required.', 'yatra'),
1511 ], 400);
1512 }
1513
1514 // Server-side enforcement of required form fields (incl. CUSTOM fields).
1515 // Gated on the Dynamic Form Field module: free/default installs keep their
1516 // existing validation untouched. Mirrors the frontend's required rules so
1517 // a crafted request can't bypass them; respects the operator's config
1518 // (only enabled+required fields in enabled sections are checked).
1519 if (function_exists('apply_filters') && apply_filters('yatra_dynamic_form_field_enabled', false)) {
1520 $required_error = $this->validateRequiredFormFields(
1521 is_array($form_config) ? $form_config : [],
1522 $data,
1523 $travelers,
1524 $contact_enabled,
1525 $traveler_enabled
1526 );
1527 if ($required_error !== null) {
1528 return new WP_REST_Response([
1529 'success' => false,
1530 'message' => $required_error,
1531 ], 400);
1532 }
1533 }
1534
1535 // Get trip data
1536 $trip = $this->tripRepository->findPublished($trip_id);
1537
1538 if (!$trip) {
1539 return new WP_REST_Response([
1540 'success' => false,
1541 'message' => __('Trip not found.', 'yatra'),
1542 ], 404);
1543 }
1544
1545 // ========================================
1546 // PRICING via CalculationService (single source of truth)
1547 // ========================================
1548 // Count only actual travelers (exclude contact and emergency contact)
1549 $travelers_count = 0;
1550 foreach ($travelers as $traveler) {
1551 if (isset($traveler['type']) && $traveler['type'] === 'traveler') {
1552 $travelers_count++;
1553 }
1554 }
1555 // Fallback if no type is set (legacy data)
1556 if ($travelers_count === 0) {
1557 $travelers_count = count($travelers);
1558 }
1559
1560 $payment_method = strtolower(trim(sanitize_text_field($data['payment_method'] ?? ($session['payment_method'] ?? 'full'))));
1561 if ($payment_method === '') {
1562 $payment_method = 'full';
1563 }
1564 $payment_gateway = strtolower(trim(sanitize_text_field($data['payment_gateway'] ?? 'pay_later')));
1565
1566 // Get coupon code from request OR session
1567 $coupon_code = sanitize_text_field($data['coupon_code'] ?? '');
1568 if (empty($coupon_code) && !empty($session['coupon']['code'])) {
1569 $coupon_code = sanitize_text_field($session['coupon']['code']);
1570 }
1571
1572 $departure_time = $data['departure_time'] ?? ($session['departure_time'] ?? '');
1573 $additional_services = $data['additional_services'] ?? ($session['additional_services'] ?? []);
1574 $availability_id = $data['availability_id'] ?? ($session['availability_id'] ?? null);
1575
1576 // Build traveler_counts from travelers array or session
1577 $traveler_counts = [];
1578 if (!empty($data['traveler_counts']) && is_array($data['traveler_counts'])) {
1579 $traveler_counts = $data['traveler_counts'];
1580 } elseif (!empty($session['traveler_counts']) && is_array($session['traveler_counts'])) {
1581 $traveler_counts = $session['traveler_counts'];
1582 } else {
1583 // Build from travelers array if category_id is present
1584 foreach ($travelers as $traveler) {
1585 $categoryId = $traveler['category_id'] ?? null;
1586 if ($categoryId) {
1587 if (!isset($traveler_counts[$categoryId])) {
1588 $traveler_counts[$categoryId] = 0;
1589 }
1590 $traveler_counts[$categoryId]++;
1591 }
1592 }
1593 if (empty($traveler_counts) && $travelers_count > 0) {
1594 $traveler_counts['default'] = $travelers_count;
1595 }
1596 }
1597
1598 // Pricing single source of truth: ALWAYS use calculateFromSession.
1599 //
1600 // The booking session is kept in sync by the JS layer — every
1601 // service toggle, traveler-count change, and coupon apply/remove
1602 // POSTs to /booking/session, which updates the transient. The
1603 // sidebar's `/booking/summary` then renders from
1604 // `calculateFromSession($session, …)`. If we built a second pricing
1605 // path here from form fields, any subtle drift (form missing a
1606 // category_id, traveler_counts aggregated as 'default', etc) would
1607 // produce a different total than the customer saw — they'd be
1608 // charged something they didn't agree to. So we merge the latest
1609 // session with any form-submitted overrides (services list,
1610 // travel_date, availability_id) and let calculateFromSession do
1611 // the math the same way the sidebar did.
1612 $calculationService = new CalculationService();
1613 $session_for_pricing = is_array($session) ? $session : [];
1614 $session_for_pricing['trip_id'] = $trip_id;
1615 $session_for_pricing['travelers'] = $travelers_count;
1616 // Prefer per-category counts when we have them — otherwise let
1617 // calculateFromSession fall back to its internal handling.
1618 if (!empty($traveler_counts) && is_array($traveler_counts)) {
1619 $session_for_pricing['traveler_counts'] = $traveler_counts;
1620 }
1621 if (!empty($travel_date)) {
1622 $session_for_pricing['travel_date'] = $travel_date;
1623 }
1624 if (!empty($departure_time)) {
1625 $session_for_pricing['departure_time'] = $departure_time;
1626 }
1627 if (!empty($availability_id) && is_numeric($availability_id)) {
1628 $session_for_pricing['availability_id'] = (int) $availability_id;
1629 }
1630 if (is_array($additional_services)) {
1631 $session_for_pricing['additional_services'] = array_values(array_map('intval', $additional_services));
1632 }
1633
1634 try {
1635 $pricing = $calculationService->calculateFromSession(
1636 $session_for_pricing,
1637 $coupon_code,
1638 $payment_method
1639 );
1640 } catch (\Throwable $e) {
1641 $pricing = [];
1642 }
1643
1644 // If the session is so degenerate that even calculateFromSession
1645 // couldn't make a positive total (e.g. no traveler_counts at all),
1646 // surface that cleanly so the booking is rejected with a friendly
1647 // error rather than silently charging $0.
1648 if (((float) ($pricing['final_total'] ?? 0)) <= 0) {
1649 try {
1650 $sessionPricing = $calculationService->calculatePricing([
1651 'trip_id' => $trip_id,
1652 'travelers_count' => $travelers_count,
1653 'traveler_counts' => $traveler_counts,
1654 'travel_date' => $travel_date,
1655 'departure_time' => $departure_time,
1656 'selected_services' => $additional_services,
1657 'availability_id' => (!empty($availability_id) && is_numeric($availability_id)) ? (int) $availability_id : null,
1658 'coupon_code' => $coupon_code,
1659 'payment_method' => $payment_method,
1660 ]);
1661 if (((float) ($sessionPricing['final_total'] ?? 0)) > 0) {
1662 $pricing = $sessionPricing;
1663 }
1664 } catch (\Throwable $e) {
1665 // Keep $pricing as-is; downstream guard will surface a clean error.
1666 }
1667 }
1668
1669 // Enforce per-group category size limits (min_pax / max_pax). A per-group
1670 // category charges one flat price for a group within the configured
1671 // range, so a selection outside that range must be rejected before we
1672 // charge. No-op for per-person categories and categories with no limits.
1673 $group_size_error = $this->validateGroupSizeLimits($pricing['price_types'] ?? [], $traveler_counts);
1674 if ($group_size_error !== null) {
1675 return new WP_REST_Response([
1676 'success' => false,
1677 'message' => $group_size_error,
1678 ], 400);
1679 }
1680
1681 // Extract pricing results
1682 $total_amount = $pricing['final_total'];
1683 $amount_due = $pricing['amount_due'];
1684 $amount_paid = $pricing['amount_paid'];
1685 $tax_calculation = $pricing['tax_calculation'];
1686 $tax_breakdown = $tax_calculation['tax_breakdown'];
1687 $total_tax_amount = $tax_calculation['total_tax_amount'];
1688
1689 $tax_inclusive = $tax_calculation['tax_inclusive'];
1690 $tax_rate = $tax_calculation['tax_rate'];
1691 $subtotal_before_discount = $pricing['subtotal'];
1692 $discount_amount = $pricing['total_discount_amount'];
1693 $discount_code = $pricing['group_discount']['code'] ?? ($pricing['coupon_discount']['code'] ?? null);
1694
1695 // ========================================
1696 // CAPACITY / WAITLIST
1697 // ========================================
1698 $resolvedAvailabilityForWaitlist = null;
1699 if ($travel_date !== '') {
1700 try {
1701 $availResolutionSvc = new \Yatra\Services\AvailabilityResolutionService();
1702 $resolvedAvailabilityForWaitlist = $availResolutionSvc->resolveAvailabilityForDate(
1703 $trip_id,
1704 $travel_date,
1705 $departure_time !== '' ? $departure_time : null
1706 );
1707 } catch (\Throwable $e) {
1708 // Leave null; legacy checkout without strict availability still works
1709 }
1710 }
1711
1712 $isWaitlistCheckout = false;
1713
1714 if ($resolvedAvailabilityForWaitlist !== null) {
1715 $availStatus = (string) ($resolvedAvailabilityForWaitlist->status ?? 'available');
1716 if (in_array($availStatus, ['blocked', 'closed', 'cancelled'], true)) {
1717 return new WP_REST_Response([
1718 'success' => false,
1719 'message' => __('This departure is not open for booking.', 'yatra'),
1720 'code' => 'date_blocked',
1721 ], 400);
1722 }
1723 // Respect explicit sold_out even if seats_available is stale — waitlist only if allowed
1724 if ($availStatus === 'sold_out') {
1725 if (\Yatra\Services\WaitlistService::canJoinWaitlist($trip, $resolvedAvailabilityForWaitlist, $travelers_count)) {
1726 $isWaitlistCheckout = true;
1727 } else {
1728 return new WP_REST_Response([
1729 'success' => false,
1730 'message' => __('This departure is sold out.', 'yatra'),
1731 'code' => 'sold_out',
1732 ], 400);
1733 }
1734 }
1735 }
1736
1737 if (
1738 !$isWaitlistCheckout
1739 && \Yatra\Services\WaitlistService::isInsufficientSeats($resolvedAvailabilityForWaitlist, $travelers_count)
1740 ) {
1741 if (\Yatra\Services\WaitlistService::canJoinWaitlist($trip, $resolvedAvailabilityForWaitlist, $travelers_count)) {
1742 $isWaitlistCheckout = true;
1743 } else {
1744 return new WP_REST_Response([
1745 'success' => false,
1746 'message' => __('This departure is full. Waitlist is not available for this trip or date.', 'yatra'),
1747 'code' => 'sold_out',
1748 ], 400);
1749 }
1750 }
1751
1752 // Generate booking reference using the same method as BookingService
1753 $bookingRepository = new \Yatra\Repositories\BookingRepository();
1754 $booking_reference = $bookingRepository->generateReference();
1755
1756 Logger::debug('Yatra booking create: pricing and payment selection', [
1757 'context' => 'booking_create_rest',
1758 'trip_id' => $trip_id,
1759 'booking_reference' => $booking_reference,
1760 'flexible_payments_enabled' => (bool) apply_filters('yatra_flexible_payments_enabled', false),
1761 'payment_method' => $payment_method,
1762 'payment_gateway' => $payment_gateway,
1763 'total_amount' => round((float) $total_amount, 4),
1764 'amount_due' => round((float) $amount_due, 4),
1765 'deposit_percentage' => (int) apply_filters('yatra_deposit_percentage', 20, ['trip_id' => $trip_id]),
1766 'partial_percentage' => (int) apply_filters('yatra_partial_payment_percentage', 30, ['trip_id' => $trip_id]),
1767 ]);
1768
1769 // Prepare contact data
1770 $contact_data = [
1771 'first_name' => sanitize_text_field($contact_first_name),
1772 'last_name' => sanitize_text_field($contact_last_name),
1773 'email' => sanitize_email($contact_email),
1774 'phone' => sanitize_text_field($contact_phone),
1775 'country' => sanitize_text_field($contact_country),
1776 'nationality' => sanitize_text_field($contact_nationality),
1777 'address' => sanitize_text_field($contact_address),
1778 ];
1779 // Persist every submitted contact_* field (incl. CUSTOM fields the
1780 // operator added to the form) so the data isn't lost and is usable as
1781 // {{contact_<id>}} email variables. Built-in keys above are not overwritten.
1782 foreach ($data as $field_key => $field_value) {
1783 if (is_string($field_key) && strpos($field_key, 'contact_') === 0 && is_scalar($field_value)) {
1784 $field_id = substr($field_key, strlen('contact_'));
1785 if ($field_id === '' || $field_id === 'data') {
1786 continue;
1787 }
1788 // A phone widget's `<field>_country` companion is folded into the
1789 // phone value below, not stored as its own field.
1790 if (substr($field_id, -8) === '_country' && isset($data[substr($field_key, 0, -8)])) {
1791 continue;
1792 }
1793 if (isset($contact_data[$field_id])) {
1794 continue;
1795 }
1796 $field_string = (string) $field_value;
1797 // Custom phone field: combine national number + country companion.
1798 if (isset($data[$field_key . '_country'])) {
1799 $field_string = \Yatra\Helpers\FormatHelper::combineInternationalPhone(
1800 $field_string,
1801 (string) $data[$field_key . '_country']
1802 );
1803 }
1804 $contact_data[$field_id] = sanitize_text_field($field_string);
1805 }
1806 }
1807
1808 // Prepare emergency contact data
1809 $emergency_data = [
1810 'name' => sanitize_text_field($emergency_name),
1811 'phone' => sanitize_text_field($emergency_phone),
1812 'relationship' => sanitize_text_field($emergency_relationship),
1813 ];
1814 // Same dynamic capture for emergency_* custom fields.
1815 foreach ($data as $field_key => $field_value) {
1816 if (is_string($field_key) && strpos($field_key, 'emergency_') === 0 && is_scalar($field_value)) {
1817 $field_id = substr($field_key, strlen('emergency_'));
1818 if ($field_id === '' || $field_id === 'contact') {
1819 continue;
1820 }
1821 if (substr($field_id, -8) === '_country' && isset($data[substr($field_key, 0, -8)])) {
1822 continue;
1823 }
1824 if (isset($emergency_data[$field_id])) {
1825 continue;
1826 }
1827 $field_string = (string) $field_value;
1828 if (isset($data[$field_key . '_country'])) {
1829 $field_string = \Yatra\Helpers\FormatHelper::combineInternationalPhone(
1830 $field_string,
1831 (string) $data[$field_key . '_country']
1832 );
1833 }
1834 $emergency_data[$field_id] = sanitize_text_field($field_string);
1835 }
1836 }
1837
1838 // Sanitize travelers data
1839 $sanitized_travelers = [];
1840 foreach ($travelers as $traveler) {
1841 if (is_array($traveler)) {
1842 $sanitized_traveler = [];
1843 foreach ($traveler as $key => $value) {
1844 $sk = sanitize_key((string) $key);
1845 // Skip a phone widget's `<field>_country` companion; it is
1846 // folded into the phone value in the pass below.
1847 if (substr($sk, -8) === '_country' && isset($traveler[substr((string) $key, 0, -8)])) {
1848 continue;
1849 }
1850 if (is_array($value)) {
1851 $sanitized_traveler[$sk] = array_map(static function ($v) {
1852 return sanitize_text_field(is_scalar($v) ? (string) $v : '');
1853 }, $value);
1854 } else {
1855 $sanitized_traveler[$sk] = sanitize_text_field((string) $value);
1856 }
1857 }
1858 // Combine each phone field with its country companion (national
1859 // number + dial code → "+<dial><digits>").
1860 foreach (array_keys($sanitized_traveler) as $tk) {
1861 $companion = $tk . '_country';
1862 if (isset($traveler[$companion]) && is_string($sanitized_traveler[$tk])) {
1863 $sanitized_traveler[$tk] = \Yatra\Helpers\FormatHelper::combineInternationalPhone(
1864 (string) $sanitized_traveler[$tk],
1865 (string) $traveler[$companion]
1866 );
1867 }
1868 }
1869 $sanitized_travelers[] = $sanitized_traveler;
1870 }
1871 }
1872
1873 // ========================================
1874 // CREATE WORDPRESS USER ACCOUNT (if requested)
1875 // ========================================
1876 $user_id = get_current_user_id();
1877 $create_account = !empty($data['create_account']) && !empty($data['account_password']);
1878
1879 if (!$user_id && $create_account && !empty($data['account_password'])) {
1880 $account_password = sanitize_text_field($data['account_password']);
1881 $account_password_confirm = sanitize_text_field($data['account_password_confirm'] ?? '');
1882
1883 // Validate password
1884 if (strlen($account_password) < 8) {
1885 return new WP_REST_Response([
1886 'success' => false,
1887 'message' => __('Password must be at least 8 characters long.', 'yatra'),
1888 ], 400);
1889 }
1890
1891 if ($account_password !== $account_password_confirm) {
1892 return new WP_REST_Response([
1893 'success' => false,
1894 'message' => __('Passwords do not match.', 'yatra'),
1895 ], 400);
1896 }
1897
1898 // Check if user already exists
1899 if (email_exists($contact_email)) {
1900 return new WP_REST_Response([
1901 'success' => false,
1902 'message' => __('An account with this email already exists. Please log in.', 'yatra'),
1903 ], 400);
1904 }
1905
1906 // Create WordPress user
1907 $username = sanitize_user(current(explode('@', $contact_email)));
1908 $original_username = $username;
1909 $counter = 1;
1910
1911 while (username_exists($username)) {
1912 $username = $original_username . $counter;
1913 $counter++;
1914 }
1915
1916 $user_id = wp_create_user($username, $account_password, $contact_email);
1917
1918 if (is_wp_error($user_id)) {
1919 return new WP_REST_Response([
1920 'success' => false,
1921 'message' => wp_strip_all_tags($user_id->get_error_message()),
1922 ], 400);
1923 }
1924
1925 // Assign Yatra Customer role
1926 $user = new \WP_User($user_id);
1927 $user->set_role('yatra_customer');
1928
1929 // Update user meta with contact information
1930 wp_update_user([
1931 'ID' => $user_id,
1932 'first_name' => $contact_data['first_name'],
1933 'last_name' => $contact_data['last_name'],
1934 'display_name' => $contact_data['first_name'] . ' ' . $contact_data['last_name'],
1935 ]);
1936
1937 if (!empty($contact_phone)) {
1938 update_user_meta($user_id, 'billing_phone', $contact_phone);
1939 update_user_meta($user_id, 'phone', $contact_phone);
1940 }
1941
1942 if (!empty($contact_country)) {
1943 update_user_meta($user_id, 'billing_country', $contact_country);
1944 }
1945
1946 if (!empty($contact_address)) {
1947 update_user_meta($user_id, 'billing_address_1', $contact_address);
1948 }
1949
1950 // Auto-login the user
1951 wp_set_current_user($user_id);
1952 wp_set_auth_cookie($user_id);
1953 }
1954
1955 // ========================================
1956 // CREATE OR UPDATE CUSTOMER
1957 // ========================================
1958 // Customers are separate from WordPress users - this is for CRM purposes
1959 $customer_id = null;
1960 try {
1961 $customer_id = $this->customerRepository->findOrCreate([
1962 'user_id' => $user_id ?: null,
1963 'first_name' => $contact_data['first_name'],
1964 'last_name' => $contact_data['last_name'],
1965 'email' => $contact_data['email'],
1966 'phone' => $contact_data['phone'],
1967 'address' => $contact_data['address'],
1968 'country' => $contact_data['country'],
1969 'nationality' => $contact_data['nationality'],
1970 'emergency_name' => $emergency_data['name'],
1971 'emergency_phone' => $emergency_data['phone'],
1972 'emergency_relationship' => $emergency_data['relationship'],
1973 'newsletter_optin' => !empty($data['subscribe_newsletter']),
1974 'total_spent' => $total_amount,
1975 'source' => 'booking',
1976 ]);
1977 } catch (\Exception $e) {
1978 // Log error but continue - customer creation is not critical
1979 }
1980
1981 // Create booking using BookingService
1982 $booking_service = new \Yatra\Services\BookingService();
1983
1984 $is_offline_gateway = $this->isOfflineGateway($payment_gateway);
1985
1986 // Ensure DB availability row is linked so inventory sync can subtract seats after booking.
1987 if (!$isWaitlistCheckout && empty($availability_id) && $trip_id > 0 && $travel_date !== '') {
1988 try {
1989 $dtForResolve = is_string($departure_time) ? trim($departure_time) : '';
1990 $dtForResolve = $dtForResolve !== '' ? $dtForResolve : null;
1991 $resolvedCheckout = (new \Yatra\Services\AvailabilityResolutionService())->resolveAvailabilityForDate(
1992 $trip_id,
1993 sanitize_text_field($travel_date),
1994 $dtForResolve
1995 );
1996 if (is_object($resolvedCheckout)
1997 && ($resolvedCheckout->source ?? '') === 'availability_date'
1998 && isset($resolvedCheckout->id)
1999 && is_numeric($resolvedCheckout->id)
2000 && (int) $resolvedCheckout->id > 0) {
2001 $availability_id = (int) $resolvedCheckout->id;
2002 }
2003 } catch (\Throwable $e) {
2004 // Recurring / trip-default checkout: no single availability_dates row
2005 }
2006 }
2007
2008 // Always defer createBooking's copy: session sends one rich confirmation at the end, or
2009 // transactional confirmation before payment redirect (see processPaymentGateway returns).
2010 $booking_data = [
2011 'reference' => $booking_reference,
2012 'trip_id' => $trip_id,
2013 'customer_id' => $customer_id,
2014 'user_id' => $user_id ?: null,
2015 'contact_first_name' => $contact_data['first_name'],
2016 'contact_last_name' => $contact_data['last_name'],
2017 'contact_email' => $contact_data['email'],
2018 'contact_phone' => $contact_data['phone'],
2019 'contact_country' => $contact_data['country'],
2020 'contact_data' => wp_json_encode($contact_data),
2021 'emergency_contact' => wp_json_encode($emergency_data),
2022 'travel_date' => sanitize_text_field($travel_date),
2023 'availability_id' => !empty($availability_id) ? (int) $availability_id : null,
2024 'departure_time' => is_string($departure_time) ? trim($departure_time) : '',
2025 'travelers_count' => $travelers_count,
2026 'total_amount' => $total_amount,
2027 'amount_paid' => 0,
2028 'amount_due' => $amount_due,
2029 'currency' => $pricing['currency'] ?? \Yatra\Services\SettingsService::getCurrency(),
2030 'discount_amount' => $discount_amount,
2031 'discount_code' => $discount_code,
2032 'payment_method' => $payment_method,
2033 'payment_gateway' => $payment_gateway,
2034 'status' => 'pending',
2035 'special_requests' => sanitize_textarea_field($data['special_requests'] ?? ''),
2036 'newsletter_optin' => !empty($data['subscribe_newsletter']) ? 1 : 0,
2037 'ip_address' => $this->getClientIp(),
2038 'created_at' => current_time('mysql'),
2039 'updated_at' => current_time('mysql'),
2040 // Tax fields
2041 'subtotal' => $subtotal_before_discount,
2042 'tax_amount' => $total_tax_amount,
2043 'tax_rate' => $tax_rate,
2044 'tax_inclusive' => $tax_inclusive,
2045 'tax_details' => wp_json_encode($tax_breakdown),
2046 // Itinerary costs
2047 'itinerary_costs' => wp_json_encode($pricing['itinerary_costs'] ?? []),
2048 'itinerary_costs_total' => ($pricing['itinerary_costs_total'] ?? 0),
2049 'skip_initial_customer_confirmation' => true,
2050 ];
2051
2052 if ($isWaitlistCheckout && $resolvedAvailabilityForWaitlist) {
2053 $booking_data['availability_id'] = (int) $resolvedAvailabilityForWaitlist->id;
2054 $booking_data['status'] = 'waitlist';
2055 // Preserve the customer's real OFFLINE gateway + deposit/partial
2056 // choice (Bank Transfer / Pay Later). No charge is taken for a
2057 // waitlisted slot regardless, and waitlist promotion only flips the
2058 // status — it never restores the selection — so pinning to
2059 // pay_later/full here would permanently drop the chosen gateway AND
2060 // wipe the deposit (BookingService recomputes amount_due from
2061 // payment_method). Online gateways stay deferred to pay_later/full
2062 // since a card can't be charged for a non-guaranteed slot.
2063 if (!$is_offline_gateway) {
2064 $booking_data['payment_gateway'] = 'pay_later';
2065 $booking_data['payment_method'] = 'full';
2066 }
2067 }
2068
2069 // Hold the booking in `pending_verification` until the guest
2070 // clicks the magic link. Payment is initiated only after the
2071 // status flips to 'pending' (in the verify-email endpoint).
2072 // We also pin the gateway to `pay_later` here because the
2073 // payment selection at this point would otherwise lock the
2074 // operator into a specific gateway before the customer has
2075 // even confirmed their email — better to defer that choice
2076 // until verification completes and the regular checkout
2077 // resumes.
2078 if ($needs_email_verification && !$isWaitlistCheckout) {
2079 $booking_data['status'] = 'pending_verification';
2080 // Defer the gateway choice ONLY for online gateways: a real charge
2081 // would otherwise lock the customer into a gateway before they have
2082 // confirmed their email. For OFFLINE gateways (Bank Transfer / Pay
2083 // Later) there is no charge to defer, and the verify-email endpoint
2084 // does not restore the selection afterwards — so pinning to
2085 // pay_later/full here would permanently drop the customer's chosen
2086 // gateway AND their deposit/partial amount (BookingService recomputes
2087 // amount_due from payment_method, so 'full' wipes the deposit).
2088 // Preserve the real selection for offline gateways.
2089 if (!$is_offline_gateway) {
2090 $booking_data['payment_gateway'] = 'pay_later';
2091 $booking_data['payment_method'] = 'full';
2092 }
2093 }
2094
2095 try {
2096 $booking = $booking_service->createBooking($booking_data);
2097 // BookingService returns ['success'=>bool, 'booking_id'=>int, ...]
2098 $booking_id = $booking['booking_id'] ?? $booking['id'] ?? null;
2099 if (empty($booking['success'])) {
2100 return new WP_REST_Response([
2101 'success' => false,
2102 'message' => $booking['message'] ?? __('Failed to create booking. Please try again.', 'yatra'),
2103 'error' => $booking['message'] ?? '',
2104 'errors' => $booking['errors'] ?? null,
2105 ], 500);
2106 }
2107 } catch (\Exception $e) {
2108 return new WP_REST_Response([
2109 'success' => false,
2110 'message' => __('Failed to create booking. Please try again.', 'yatra'),
2111 'error' => $e->getMessage(),
2112 ], 500);
2113 }
2114
2115 if (empty($booking_id)) {
2116 return new WP_REST_Response([
2117 'success' => false,
2118 'message' => __('Failed to create booking. Please try again.', 'yatra'),
2119 'error' => __('Booking ID was not generated.', 'yatra'),
2120 ], 500);
2121 }
2122
2123 if ($isWaitlistCheckout && $resolvedAvailabilityForWaitlist) {
2124 \Yatra\Services\WaitlistService::incrementAvailabilityWaitlistCount(
2125 (int) $resolvedAvailabilityForWaitlist->id,
2126 $travelers_count
2127 );
2128 }
2129
2130 // Get the actual booking reference from database
2131 $bookingRepository = new \Yatra\Repositories\BookingRepository();
2132 $saved_booking = $bookingRepository->find($booking_id);
2133 if ($saved_booking && !empty($saved_booking->reference)) {
2134 $booking_reference = $saved_booking->reference;
2135 }
2136
2137 // ========================================
2138 // SAVE ADDITIONAL SERVICES (Premium Feature)
2139 // ========================================
2140 /**
2141 * Action: Save additional services for the booking
2142 * Allows premium modules to save selected services with the booking
2143 *
2144 * @param int $booking_id The booking ID
2145 * @param int $trip_id The trip ID
2146 * @param array $data The booking request data (contains selected_services)
2147 * @param int $travelers_count Total number of travelers
2148 * @param int $duration_days Trip duration in days
2149 * @param float $base_amount Trip base price (pre-services, pre-discount) —
2150 * the authoritative base used by the pricing engine for this
2151 * booking. Listeners persisting percentage-type services price
2152 * them against this exact value so the saved line-items reconcile
2153 * with the charged total. Added in a backward-compatible way:
2154 * existing 5-arg listeners simply ignore it.
2155 * @since 3.0.0
2156 */
2157 // Normalise: Pro module reads $data['selected_services'], frontend sends $data['additional_services']
2158 if (!isset($data['selected_services'])) {
2159 $data['selected_services'] = $data['additional_services']
2160 ?? $session['additional_services']
2161 ?? [];
2162 }
2163 if (!is_array($data['selected_services'])) {
2164 $data['selected_services'] = [];
2165 }
2166 $data['selected_services'] = array_map('intval', $data['selected_services']);
2167 do_action('yatra_booking_save_services', $booking_id, $trip_id, $data, $travelers_count, (int) ($trip->duration_days ?? 1), (float) ($pricing['base_amount'] ?? 0));
2168
2169 // ========================================
2170 // SAVE TRAVELLERS TO NORMALIZED TABLES
2171 // ========================================
2172 // Each traveller is saved to yatra_booking_travellers table
2173 // Their dynamic fields are saved to yatra_booking_traveller_meta table
2174 foreach ($sanitized_travelers as $index => $traveler_fields) {
2175 // First traveller (index 0) is always the lead traveller
2176 $is_lead = ($index === 0);
2177
2178 // Create traveller record with all their fields stored in meta
2179 $this->travellerRepository->create(
2180 $booking_id,
2181 $index,
2182 $is_lead,
2183 $traveler_fields
2184 );
2185 }
2186
2187 if ($isWaitlistCheckout && $resolvedAvailabilityForWaitlist) {
2188 yatra_clear_booking_session();
2189 if ($settings['booking_confirmation']) {
2190 $booking_service->sendNewBookingTransactionalConfirmation((int) $booking_id);
2191 }
2192
2193 return new WP_REST_Response([
2194 'success' => true,
2195 'message' => __('You are on the waitlist. We will contact you if a space opens up.', 'yatra'),
2196 'data' => [
2197 'booking_id' => $booking_id,
2198 'reference' => $booking_reference,
2199 'status' => 'waitlist',
2200 'waitlist' => true,
2201 'redirect_url' => $this->getConfirmationUrl($booking_reference),
2202 'customer_email' => $contact_data['email'],
2203 'customer_name' => trim($contact_data['first_name'] . ' ' . $contact_data['last_name']),
2204 'trip_id' => $trip_id,
2205 'trip_date' => $travel_date,
2206 'currency' => $pricing['currency'] ?? \Yatra\Services\SettingsService::getCurrency(),
2207 'total_amount' => $total_amount,
2208 'amount_due' => $amount_due,
2209 ],
2210 ]);
2211 }
2212
2213 // Departure link + booked_count: handled inside BookingService::createBooking (and inventory sync hooks).
2214 // Persist travel window on the booking row for reporting (optional columns).
2215 if (!empty($travel_date)) {
2216 try {
2217 $start_date = $travel_date;
2218 $duration_days = !empty($trip->duration_days) ? (int) $trip->duration_days : 1;
2219 $end_date = date('Y-m-d', strtotime($start_date . ' + ' . ($duration_days - 1) . ' days'));
2220 $bookingColumns = $this->bookingRepository->getTableColumns();
2221 $bookingUpdateData = [];
2222 if (in_array('start_date', $bookingColumns, true)) {
2223 $bookingUpdateData['start_date'] = $start_date;
2224 }
2225 if (in_array('end_date', $bookingColumns, true)) {
2226 $bookingUpdateData['end_date'] = $end_date;
2227 }
2228 if ($bookingUpdateData !== []) {
2229 $this->bookingRepository->update($booking_id, $bookingUpdateData);
2230 }
2231 } catch (\Exception $e) {
2232 // Non-fatal
2233 }
2234 }
2235
2236 // Clear booking session
2237 yatra_clear_booking_session();
2238
2239 // ========================================
2240 // GUEST EMAIL VERIFICATION — INTERCEPT
2241 // ========================================
2242 // Booking row + travelers + services are already saved at
2243 // this point with status='pending_verification'. Send the
2244 // magic-link email, return a structured "check your email"
2245 // response, and DO NOT initiate payment. The customer's
2246 // click on the verify-email endpoint transitions the booking
2247 // to 'pending' and emits the payment-continuation URL.
2248 if ($needs_email_verification) {
2249 $verify_url = \Yatra\Services\GuestVerificationTokenService::buildVerifyUrl(
2250 (int) $booking_id,
2251 (string) $contact_data['email']
2252 );
2253
2254 // Variables piped into the template email. All standard
2255 // booking merge tags resolve normally (the row exists);
2256 // we also pass intro_paragraph + footer_note + the
2257 // expiry banner so operators that haven't customised
2258 // the template still get good defaults.
2259 $email_vars = [];
2260 if ($saved_booking !== null) {
2261 $email_vars = \Yatra\Services\TransactionalEmailTemplateService::variablesFromBooking($saved_booking);
2262 }
2263 // Belt-and-braces: ensure customer name + email are
2264 // populated even when variablesFromBooking returned an
2265 // empty shell (which shouldn't happen, but if it does
2266 // we don't want the email to render "Hi ,").
2267 $email_vars['customer_email'] = (string) ($email_vars['customer_email'] ?? $contact_data['email']);
2268 $email_vars['customer_name'] = (string) ($email_vars['customer_name']
2269 ?? trim(($contact_data['first_name'] ?? '') . ' ' . ($contact_data['last_name'] ?? '')));
2270 $email_vars['customer_first_name'] = (string) ($email_vars['customer_first_name']
2271 ?? ($contact_data['first_name'] ?? ''));
2272 $email_vars['verification_link'] = $verify_url;
2273 $email_vars['intro_paragraph'] = __(
2274 "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.",
2275 'yatra'
2276 );
2277 $email_vars['footer_note'] = __(
2278 "If you didn't make this booking, you can safely ignore this email — no charges have been made.",
2279 'yatra'
2280 );
2281 $email_vars['expiry_notice_html'] = '<strong>'
2282 . esc_html__('This link expires in 48 hours.', 'yatra')
2283 . '</strong>';
2284
2285 // Guest-checkout verification prefers the operator's CONFIGURED
2286 // customer verification template so their customisation is honoured
2287 // (the guest system template was consolidated away — using the guest
2288 // type always fell back to the built-in default and ignored the
2289 // configured one). This email MUST still carry the verification link
2290 // — a guest can't complete the booking without it — so we only fall
2291 // back to the built-in GUEST default when the effective customer
2292 // template would omit {{verification_link}} (an operator can, and on
2293 // real sites does, customise that template and drop the tag). The
2294 // check respects Pro-owned DB templates too. Booking copy is injected
2295 // above via intro_paragraph / footer_note / expiry merge vars.
2296 //
2297 // Keep the booking-specific SUBJECT line ("Verify your email to
2298 // complete your booking") that guests saw before the guest template
2299 // was consolidated away — reusing the customer template body must not
2300 // drag along the account-oriented "Verify your email address"
2301 // subject. This is honoured additively by the renderer / Pro sender
2302 // via the reserved `_subject_override` var, so only this guest send
2303 // is affected. Computed before it is stored, so the render below
2304 // resolves the clean guest subject (no self-reference).
2305 $email_vars['_subject_override'] = \Yatra\Services\TransactionalEmailTemplateService::render(
2306 \Yatra\Services\TransactionalEmailTemplateService::TYPE_GUEST_EMAIL_VERIFICATION,
2307 $email_vars
2308 )['subject'];
2309 $verificationEmailSent = false;
2310 if (\Yatra\Services\TransactionalEmailTemplateService::templateRendersVerificationLink(
2311 \Yatra\Services\TransactionalEmailTemplateService::TYPE_CUSTOMER_EMAIL_VERIFICATION
2312 )) {
2313 $verificationEmailSent = \Yatra\Services\TransactionalEmailTemplateService::sendIfEnabled(
2314 \Yatra\Services\TransactionalEmailTemplateService::TYPE_CUSTOMER_EMAIL_VERIFICATION,
2315 (string) $contact_data['email'],
2316 $email_vars
2317 );
2318 }
2319 // Guarantee a verification email even if the customer template would
2320 // drop the link OR its per-type toggle is disabled — a guest can't
2321 // complete checkout without it. The built-in GUEST default always
2322 // carries the link. sendIfEnabled() returns whether it actually sent,
2323 // so this only fires when the preferred send did not (no double send).
2324 if (!$verificationEmailSent) {
2325 \Yatra\Services\TransactionalEmailTemplateService::sendIfEnabled(
2326 \Yatra\Services\TransactionalEmailTemplateService::TYPE_GUEST_EMAIL_VERIFICATION,
2327 (string) $contact_data['email'],
2328 $email_vars
2329 );
2330 }
2331
2332 return new WP_REST_Response([
2333 'success' => true,
2334 'code' => 'email_verification_required',
2335 'message' => __(
2336 "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.",
2337 'yatra'
2338 ),
2339 'data' => [
2340 'booking_id' => $booking_id,
2341 'reference' => $booking_reference,
2342 'email' => $contact_data['email'],
2343 'expires_in_seconds' => (int) apply_filters('yatra_guest_verification_ttl_seconds', 48 * 3600),
2344 ],
2345 ]);
2346 }
2347
2348 // Check if this is an offline gateway
2349 $is_offline = $is_offline_gateway;
2350
2351 // For online gateways, create payment intent and return redirect URL
2352 if (!$is_offline && $amount_due > 0) {
2353 // Build payment params - merge with request data so gateways can access their own tokens
2354 $payment_params = array_merge($data, [
2355 'booking_id' => $booking_id,
2356 'reference' => $booking_reference,
2357 'amount' => $amount_due,
2358 'currency' => $pricing['currency'] ?? \Yatra\Services\SettingsService::getCurrency(),
2359 'customer_email' => $contact_data['email'],
2360 'customer_name' => $contact_data['first_name'] . ' ' . $contact_data['last_name'],
2361 'trip_title' => $trip->title,
2362 ]);
2363
2364 // Process payment based on gateway
2365 $payment_result = $this->processPaymentGateway($payment_gateway, $payment_params);
2366
2367 if ($payment_result['success']) {
2368 // Handle redirect-based gateways (PayPal, eSewa, Khalti, etc.)
2369 if (!empty($payment_result['payment_url'])) {
2370 if ($settings['booking_confirmation']) {
2371 $booking_service->sendNewBookingTransactionalConfirmation((int) $booking_id);
2372 }
2373 return new WP_REST_Response([
2374 'success' => true,
2375 'message' => __('Booking created. Redirecting to payment...', 'yatra'),
2376 'data' => [
2377 'booking_id' => $booking_id,
2378 'reference' => $booking_reference,
2379 'payment_url' => $payment_result['payment_url'],
2380 ],
2381 ]);
2382 }
2383
2384 // Handle client-side payment gateways (Stripe, Razorpay, Square, etc.)
2385 if (!empty($payment_result['requires_action'])) {
2386 if ($settings['booking_confirmation']) {
2387 $booking_service->sendNewBookingTransactionalConfirmation((int) $booking_id);
2388 }
2389 return new WP_REST_Response([
2390 'success' => true,
2391 'message' => __('Booking created. Complete payment...', 'yatra'),
2392 'data' => array_merge([
2393 'booking_id' => $booking_id,
2394 'reference' => $booking_reference,
2395 ], $payment_result),
2396 ]);
2397 }
2398 }
2399
2400 // If payment processing failed, return error so user can fix the issue
2401 if (!$payment_result['success']) {
2402 $errorMessage = $payment_result['error'] ?? $payment_result['message'] ?? __('Payment processing failed. Please try again.', 'yatra');
2403 return new WP_REST_Response([
2404 'success' => false,
2405 'message' => $errorMessage,
2406 'data' => [
2407 'booking_id' => $booking_id,
2408 'reference' => $booking_reference,
2409 'payment_error' => true,
2410 ],
2411 ]);
2412 }
2413 }
2414
2415 // ========================================
2416 // DETERMINE BOOKING STATUS
2417 // ========================================
2418 // Priority:
2419 // 1. auto_confirm_bookings setting (confirms ALL bookings automatically)
2420 // 2. For pay_later: auto_confirm_pay_later setting
2421 // 3. For bank_transfer: always pending until verified
2422
2423 $booking_status = 'pending';
2424 $status_message = __('Booking received!', 'yatra');
2425
2426 // Check if auto-confirm all bookings is enabled
2427 if ($settings['auto_confirm_bookings']) {
2428 // Auto-confirm is enabled - confirm immediately regardless of payment
2429 $booking_status = 'confirmed';
2430 $status_message = __('Booking confirmed!', 'yatra');
2431 } elseif ($payment_gateway === 'pay_later') {
2432 // Pay Later: Check the specific pay_later auto-confirm setting
2433 if ($settings['auto_confirm_pay_later']) {
2434 $booking_status = 'confirmed';
2435 $status_message = __('Booking confirmed! Payment will be collected later.', 'yatra');
2436 } else {
2437 $booking_status = 'pending';
2438 $status_message = __('Booking received! We will contact you to arrange payment.', 'yatra');
2439 }
2440 } elseif ($payment_gateway === 'bank_transfer') {
2441 // Bank Transfer: Always pending until payment is verified by admin
2442 $booking_status = 'pending';
2443 $status_message = __('Booking received! Please complete the bank transfer. We will confirm once payment is verified.', 'yatra');
2444 }
2445
2446 // Calculate booking expiry time for pending bookings
2447 $expiry_datetime = null;
2448 if ($booking_status === 'pending' && $settings['booking_expiry_hours'] > 0) {
2449 $expiry_datetime = date('Y-m-d H:i:s', strtotime('+' . $settings['booking_expiry_hours'] . ' hours'));
2450 }
2451
2452 // Set confirmed_at if auto-confirmed
2453 $confirmed_at = ($booking_status === 'confirmed') ? current_time('mysql') : null;
2454
2455 // Update booking status with additional metadata
2456 $update_data = [
2457 'status' => $booking_status,
2458 'payment_status' => 'pending', // No payment made yet for offline gateways
2459 ];
2460
2461 if ($confirmed_at) {
2462 $update_data['confirmed_at'] = $confirmed_at;
2463 }
2464
2465 if ($expiry_datetime) {
2466 $update_data['expires_at'] = $expiry_datetime;
2467 }
2468
2469 // Use repository to update booking
2470 $this->bookingRepository->update($booking_id, $update_data);
2471
2472 /**
2473 * yatra_booking_created already fired from BookingService::createBooking — do not fire again here
2474 * (duplicate admin + Pro automation).
2475 *
2476 * Synthetic pending→confirmed on the same request duplicates Pro "booking.confirmed" sequences with the
2477 * checkout confirmation email. Skip by default; restore with:
2478 * add_filter('yatra_skip_checkout_autoconfirm_status_changed_event', '__return_false');
2479 */
2480 if ($booking_status === 'confirmed') {
2481 if (!apply_filters('yatra_skip_checkout_autoconfirm_status_changed_event', true, (int) $booking_id, 'pending', 'confirmed')) {
2482 do_action('yatra_booking_status_changed', (int) $booking_id, 'pending', 'confirmed');
2483 }
2484 // Trip Consent / Google Calendar listen on `yatra_booking_confirmed` (not fired by status_changed skip above).
2485 \yatra_trigger_booking_confirmed((int) $booking_id, 'pending');
2486 }
2487
2488 // ========================================
2489 // SEND CONFIRMATION EMAIL
2490 // ========================================
2491 if ($settings['booking_confirmation']) {
2492 $this->sendBookingConfirmationEmail($booking_id, $booking_reference, $trip, [
2493 'contact' => $contact_data,
2494 'emergency' => $emergency_data,
2495 'travelers' => $sanitized_travelers,
2496 'travel_date' => $travel_date,
2497 'payment_method' => $payment_method,
2498 'payment_gateway' => $payment_gateway,
2499 'total_amount' => $total_amount,
2500 'amount_due' => $amount_due,
2501 'booking_status' => $booking_status,
2502 'expiry_datetime' => $expiry_datetime,
2503 ]);
2504 }
2505
2506 return new WP_REST_Response([
2507 'success' => true,
2508 'message' => $status_message,
2509 'data' => [
2510 'booking_id' => $booking_id,
2511 'reference' => $booking_reference,
2512 'status' => $booking_status,
2513 'payment_status' => 'pending',
2514 'redirect_url' => $this->getConfirmationUrl($booking_reference),
2515 'customer_email' => $contact_data['email'],
2516 'customer_name' => trim($contact_data['first_name'] . ' ' . $contact_data['last_name']),
2517 'trip_id' => $trip_id,
2518 'trip_date' => $travel_date,
2519 'currency' => $pricing['currency'] ?? \Yatra\Services\SettingsService::getCurrency(),
2520 'amount' => $amount_due,
2521 'subtotal' => $subtotal_before_discount,
2522 'discount_amount' => $discount_amount,
2523 'discount_code' => $discount_code,
2524 'total_amount' => $total_amount,
2525 ],
2526 ]);
2527 }
2528
2529
2530 /**
2531 * Get confirmation page URL (see yatra_get_booking_confirmation_url()).
2532 */
2533 private function getConfirmationUrl(string $reference): string
2534 {
2535 return yatra_get_booking_confirmation_url($reference);
2536 }
2537
2538 /**
2539 * Whether the gateway completes without an external payment step (registry flag + fallback).
2540 */
2541 private function isOfflineGateway(string $gatewayId): bool
2542 {
2543 try {
2544 $registry = \Yatra\PaymentGateways\PaymentGatewayRegistry::getInstance();
2545 $gateway = $registry->get($gatewayId);
2546 if ($gateway) {
2547 return $gateway->isOffline();
2548 }
2549 } catch (\Throwable $e) {
2550 // Fall through to legacy IDs
2551 }
2552
2553 return in_array($gatewayId, ['pay_later', 'bank_transfer'], true);
2554 }
2555
2556 /**
2557 * Pay balance due on an existing booking only.
2558 *
2559 * Does not call BookingService::createBooking() or insert a second booking row.
2560 * Initiates gateway flow with the stored booking_id; on success, payment is recorded
2561 * via PaymentGatewayController::handle_successful_payment, webhooks, or recordGatewayPayment
2562 * — same completion paths as initial checkout.
2563 */
2564 private function process_remaining_payment(WP_REST_Request $request): WP_REST_Response
2565 {
2566 $data = $request->get_json_params();
2567 if (!is_array($data)) {
2568 $data = [];
2569 }
2570 $payment_gateway = strtolower(trim(sanitize_text_field($data['payment_gateway'] ?? 'pay_later')));
2571
2572 $session = yatra_get_remaining_session();
2573
2574 $booking_id = (int) ($session['booking_id'] ?? 0);
2575 $booking_reference = (string) ($session['booking_reference'] ?? '');
2576 $currency = (string) ($session['currency'] ?? '');
2577 $contact_email = (string) ($session['contact_email'] ?? '');
2578 $contact_first_name = (string) ($session['contact_first_name'] ?? '');
2579 $contact_last_name = (string) ($session['contact_last_name'] ?? '');
2580 $trip_id = (int) ($session['trip_id'] ?? 0);
2581 $trip_title = (string) ($session['trip_title'] ?? '');
2582 $travel_date = (string) ($session['travel_date'] ?? '');
2583
2584 if ($booking_id <= 0) {
2585 return new WP_REST_Response([
2586 'success' => false,
2587 'message' => __('Invalid booking for remaining payment.', 'yatra'),
2588 ], 400);
2589 }
2590
2591 $booking = $this->bookingRepository->find($booking_id);
2592 if (!$booking) {
2593 yatra_clear_remaining_session();
2594 return new WP_REST_Response([
2595 'success' => false,
2596 'message' => __('Booking not found.', 'yatra'),
2597 ], 404);
2598 }
2599
2600 if ($booking_reference === '' && !empty($booking->reference)) {
2601 $booking_reference = (string) $booking->reference;
2602 }
2603
2604 // Authoritative balance from DB (do not rely on session alone)
2605 $remaining_amount = (float) ($booking->amount_due ?? 0);
2606 if ($remaining_amount <= 0 && isset($booking->total_amount)) {
2607 $remaining_amount = max(
2608 0,
2609 (float) $booking->total_amount - (float) ($booking->amount_paid ?? 0)
2610 );
2611 }
2612
2613 if ($remaining_amount <= 0) {
2614 yatra_clear_remaining_session();
2615 return new WP_REST_Response([
2616 'success' => false,
2617 'message' => __('This booking is already fully paid.', 'yatra'),
2618 ], 400);
2619 }
2620
2621 // Verify user owns this booking
2622 $current_user = get_current_user_id();
2623 if ($current_user && (int) $booking->user_id !== $current_user) {
2624 yatra_clear_remaining_session();
2625 return new WP_REST_Response([
2626 'success' => false,
2627 'message' => __('You do not have permission to pay for this booking.', 'yatra'),
2628 ], 403);
2629 }
2630
2631 if ($currency === '') {
2632 $currency = (string) ($booking->currency ?? SettingsService::getCurrency());
2633 }
2634
2635 // Use contact info from session or booking
2636 $customer_email = $contact_email !== '' ? $contact_email : (string) ($booking->contact_email ?? $booking->customer_email ?? '');
2637 $customer_name = trim($contact_first_name . ' ' . $contact_last_name);
2638 if ($customer_name === '') {
2639 $customer_name = trim(($booking->contact_first_name ?? '') . ' ' . ($booking->contact_last_name ?? ''));
2640 }
2641
2642 if ($customer_email === '') {
2643 return new WP_REST_Response([
2644 'success' => false,
2645 'message' => __('Email address is required.', 'yatra'),
2646 ], 400);
2647 }
2648
2649 $is_offline_gateway = $this->isOfflineGateway($payment_gateway);
2650
2651 // Server-side guard: offline gateways (Pay Later, Bank Transfer, etc.) don't
2652 // actually collect money. Letting them be selected for a remaining-balance
2653 // payment leaves the booking unpaid while the customer thinks they finished
2654 // the flow. The frontend already filters them out for this checkout — this
2655 // catches a tampered client. Filterable so a custom Pay Later that does
2656 // settle can opt back in.
2657 $allow_offline_for_remaining = (bool) apply_filters(
2658 'yatra_remaining_payment_allow_offline_gateway',
2659 false,
2660 $payment_gateway,
2661 $booking
2662 );
2663 if ($is_offline_gateway && !$allow_offline_for_remaining) {
2664 return new WP_REST_Response([
2665 'success' => false,
2666 'message' => __('This payment method cannot be used to settle a remaining balance. Please choose a card-based gateway.', 'yatra'),
2667 'data' => [
2668 'rejected_gateway' => $payment_gateway,
2669 'reason' => 'offline_not_allowed_for_remaining_payment',
2670 ],
2671 ], 400);
2672 }
2673
2674 // Online gateways: delegate to the same flow as new-booking checkout (PayPal redirect, Stripe intent, etc.).
2675 // Do not put confirmation URL in redirect_url here — that caused the browser to skip payment entirely.
2676 if (!$is_offline_gateway && $remaining_amount > 0) {
2677 // The gateway needs an explicit return URL with the `balance=paid` flag so the
2678 // confirmation page can show "balance just paid" content. Without setting it
2679 // here, processPaymentWithGateway() would fall back to a plain confirmation URL
2680 // and the customer would land on the generic post-booking template.
2681 $remaining_return_url = add_query_arg(
2682 'balance',
2683 'paid',
2684 $this->getConfirmationUrl($booking_reference)
2685 );
2686
2687 $payment_params = array_merge($data, [
2688 'booking_id' => $booking_id,
2689 'reference' => $booking_reference,
2690 'amount' => $remaining_amount,
2691 'currency' => $currency,
2692 'customer_email' => $customer_email,
2693 'customer_name' => $customer_name !== '' ? $customer_name : $customer_email,
2694 'trip_title' => $trip_title,
2695 'return_url' => $remaining_return_url,
2696 ]);
2697
2698 $payment_result = $this->processPaymentGateway($payment_gateway, $payment_params);
2699
2700 if (!empty($payment_result['success'])) {
2701 // Common identity fields the Stripe.js / PayPal SDK frontend expects on
2702 // the response. process_remaining_payment is reached without going through
2703 // the new-booking checkout, so the gateway result alone is missing
2704 // customer_email / customer_name — re-attach them from the booking we
2705 // already loaded above. Also overwrite confirmation_url AND redirect_url
2706 // with the balance-tagged version so the post-payment landing page knows
2707 // this was a remaining-balance flow.
2708 //
2709 // Why both fields: the Stripe.js helper buildConfirmationUrlFromBookingInfo()
2710 // prefers bookingInfo.redirect_url and only falls back to rebuilding the URL
2711 // from scratch (without query params) when redirect_url is absent. Without
2712 // redirect_url being explicitly set here the `?balance=paid` flag would be
2713 // lost on the final navigation after Stripe success.
2714 $remaining_identity_fields = [
2715 'customer_email' => $customer_email,
2716 'customer_name' => $customer_name,
2717 'confirmation_url' => $remaining_return_url,
2718 'redirect_url' => $remaining_return_url,
2719 ];
2720
2721 if (!empty($payment_result['payment_url'])) {
2722 return new WP_REST_Response([
2723 'success' => true,
2724 'message' => __('Redirecting to payment...', 'yatra'),
2725 'data' => array_merge([
2726 'booking_id' => $booking_id,
2727 'reference' => $booking_reference,
2728 'payment_url' => $payment_result['payment_url'],
2729 'is_remaining_payment' => true,
2730 ], $remaining_identity_fields),
2731 ]);
2732 }
2733
2734 if (!empty($payment_result['requires_action'])) {
2735 return new WP_REST_Response([
2736 'success' => true,
2737 'message' => __('Complete payment...', 'yatra'),
2738 'data' => array_merge(
2739 [
2740 'booking_id' => $booking_id,
2741 'reference' => $booking_reference,
2742 'is_remaining_payment' => true,
2743 ],
2744 $payment_result,
2745 $remaining_identity_fields
2746 ),
2747 ]);
2748 }
2749
2750 if (!empty($payment_result['redirect_url'])) {
2751 return new WP_REST_Response([
2752 'success' => true,
2753 'message' => __('Payment processed.', 'yatra'),
2754 'data' => array_merge([
2755 'booking_id' => $booking_id,
2756 'reference' => $booking_reference,
2757 'redirect_url' => $payment_result['redirect_url'],
2758 'is_remaining_payment' => true,
2759 ], $remaining_identity_fields),
2760 ]);
2761 }
2762 }
2763
2764 $err = $payment_result['message'] ?? $payment_result['error'] ?? __('Payment processing failed. Please try again.', 'yatra');
2765
2766 return new WP_REST_Response([
2767 'success' => false,
2768 'message' => $err,
2769 'data' => [
2770 'payment_error' => true,
2771 'booking_id' => $booking_id,
2772 ],
2773 ], 400);
2774 }
2775
2776 // Offline gateways: no external redirect — confirmation page only.
2777 // Append `balance=paid` so the confirmation template renders the
2778 // remaining-payment-specific banner ("balance received, fully paid")
2779 // instead of the generic "booking confirmed" copy.
2780 yatra_clear_remaining_session();
2781
2782 $offline_redirect = add_query_arg(
2783 'balance',
2784 'paid',
2785 $this->getConfirmationUrl($booking_reference)
2786 );
2787
2788 return new WP_REST_Response([
2789 'success' => true,
2790 'message' => __('Continue to confirmation.', 'yatra'),
2791 'data' => [
2792 'booking_id' => $booking_id,
2793 'reference' => $booking_reference,
2794 'trip_id' => $trip_id,
2795 'trip_title' => $trip_title,
2796 'trip_date' => $travel_date,
2797 'currency' => $currency,
2798 'amount' => $remaining_amount,
2799 'customer_email' => $customer_email,
2800 'customer_name' => $customer_name,
2801 'redirect_url' => $offline_redirect,
2802 'is_remaining_payment' => true,
2803 ],
2804 ]);
2805 }
2806
2807 /**
2808 * Process payment through the selected gateway
2809 */
2810 private function processPaymentGateway(string $gateway, array $params): array
2811 {
2812 // Debug logging
2813 if (defined('WP_DEBUG') && WP_DEBUG) {
2814 }
2815
2816 // All gateways use the unified gateway system
2817 return $this->processPaymentWithGateway($gateway, $params);
2818 }
2819
2820 /**
2821 * Process payment using the proper gateway system
2822 */
2823 private function processPaymentWithGateway(string $gatewayId, array $params): array
2824 {
2825 try {
2826 $registry = \Yatra\PaymentGateways\PaymentGatewayRegistry::getInstance();
2827 $gateway = $registry->get($gatewayId);
2828
2829 if (!$gateway) {
2830 return ['success' => false, 'message' => "Payment gateway '{$gatewayId}' not found"];
2831 }
2832
2833 if (!$gateway->isEnabled()) {
2834 return [
2835 'success' => false,
2836 'message' => __('This payment method is not available.', 'yatra'),
2837 ];
2838 }
2839
2840 if (!$gateway->isProperlyConfigured()) {
2841 return [
2842 'success' => false,
2843 'message' => GatewayUserMessages::gatewayNotConfigured($gateway),
2844 ];
2845 }
2846
2847 // Prepare payment data - pass all params, gateways extract what they need.
2848 // Default return_url to the configured booking confirmation URL so redirect gateways
2849 // (e.g. PayPal Advanced, Mollie, Paystack) do not fall back to wrong paths; gateways
2850 // may still append their own query args on top of this URL.
2851 $ref = isset($params['reference']) ? trim((string) $params['reference']) : '';
2852 $paymentData = array_merge($params, [
2853 'description' => $params['trip_title'] ?? '',
2854 'cancel_url' => home_url('/book/?payment=cancelled&ref=' . ($params['reference'] ?? '')),
2855 'metadata' => [
2856 'booking_id' => $params['booking_id'],
2857 'reference' => $params['reference'] ?? ''
2858 ]
2859 ]);
2860 if ($ref !== '' && empty($paymentData['return_url'])) {
2861 $paymentData['return_url'] = $this->getConfirmationUrl($ref);
2862 }
2863
2864 // Process the payment through the gateway
2865 $result = $gateway->processPayment($paymentData);
2866
2867 // Debug logging
2868 if (defined('WP_DEBUG') && WP_DEBUG) {
2869 }
2870
2871 if ($result['success']) {
2872 // Save transaction ID for tracking
2873 if (!empty($result['transaction_id'])) {
2874 $this->bookingRepository->updatePaymentSessionId(
2875 (int) $params['booking_id'],
2876 $result['transaction_id']
2877 );
2878 }
2879
2880 // For gateways that require client-side action (Stripe, Razorpay, etc.)
2881 // Payment will be recorded after client completes the action
2882 if (!empty($result['requires_action'])) {
2883 return array_merge(['success' => true], $result);
2884 }
2885
2886 // For gateways that return a redirect URL for external payment (PayPal, eSewa, Khalti)
2887 // Payment will be recorded on callback/return
2888 if (!empty($result['redirect_url']) || !empty($result['payment_url'])) {
2889 // Check if this is a completed payment with redirect (like Square)
2890 // vs pending external payment (like PayPal)
2891 $isCompletedPayment = !empty($result['transaction_id']) &&
2892 (($result['status'] ?? '') === 'completed' || ($result['status'] ?? '') === 'succeeded');
2893
2894 if ($isCompletedPayment) {
2895 $this->recordGatewayPayment($params, $result, $gatewayId);
2896 }
2897
2898 return [
2899 'success' => true,
2900 'payment_url' => $result['redirect_url'] ?? $result['payment_url']
2901 ];
2902 }
2903
2904 // For offline gateways or successful direct payments without redirect
2905 return [
2906 'success' => true,
2907 'redirect_url' => $this->getConfirmationUrl($params['reference'] ?? '')
2908 ];
2909 }
2910
2911 // Log the payment failure for debugging
2912 if (defined('WP_DEBUG') && WP_DEBUG) {
2913 }
2914
2915 return [
2916 'success' => false,
2917 'message' => $result['message'] ?? $result['error'] ?? 'Payment processing failed. Please try again.'
2918 ];
2919
2920 } catch (\Exception $e) {
2921 // Log the exception for debugging
2922 return [
2923 'success' => false,
2924 'message' => 'An unexpected error occurred. Please try again or contact support.'
2925 ];
2926 }
2927 }
2928
2929 /**
2930 * Record payment from gateway result
2931 * Matches Stripe's completePayment behavior
2932 */
2933 private function recordGatewayPayment(array $params, array $result, string $gatewayId): void
2934 {
2935 global $wpdb;
2936
2937 try {
2938 $bookingId = (int) $params['booking_id'];
2939 $amount = (float) ($params['amount'] ?? 0);
2940 $currency = $params['currency'] ?? 'USD';
2941 $transactionId = $result['transaction_id'] ?? '';
2942
2943 // Get booking
2944 $booking = $this->bookingRepository->find($bookingId);
2945 if (!$booking) {
2946 return;
2947 }
2948
2949 // Already settled in full — never apply another charge to it. A fresh
2950 // booking is never already paid, so in practice this only guards a
2951 // stray/duplicate completion call (with a different transaction id)
2952 // against over-applying the ledger.
2953 if (($booking->payment_status ?? '') === 'paid') {
2954 return;
2955 }
2956
2957 $paymentRepository = new \Yatra\Repositories\PaymentRepository();
2958
2959 // Idempotency guard: skip if this gateway transaction is already
2960 // recorded for this booking. Prevents duplicate ledger rows when a
2961 // payment is submitted twice (the gateway uses a fresh idempotency
2962 // key per call, so it won't dedupe a true retry). Mirrors
2963 // PaymentGatewayController::handle_successful_payment().
2964 if ($transactionId !== '') {
2965 $existing = $paymentRepository->findByTransactionId($transactionId);
2966 if ($existing && (int) ($existing->booking_id ?? 0) === $bookingId) {
2967 return;
2968 }
2969 }
2970
2971 // Record the payment
2972 $paymentRepository->create([
2973 'booking_id' => $bookingId,
2974 'amount' => $amount,
2975 'currency' => $currency,
2976 'gateway' => $gatewayId,
2977 'transaction_id' => $transactionId,
2978 'status' => 'completed',
2979 'customer_id' => $booking->customer_id ? (int) $booking->customer_id : null,
2980 'created_at' => current_time('mysql'),
2981 ]);
2982
2983 // Update the booking ledger + status. The synchronous gateways
2984 // (Square, Authorize.Net) reach this generic path but previously left
2985 // the booking at pending/pending — only the payment row was written.
2986 // This now matches handle_successful_payment(): accumulate amount_paid,
2987 // recompute amount_due, set payment_status (paid vs partial), and
2988 // confirm the booking (a deposit confirms too, consistent with Stripe).
2989 $newAmountPaid = (float) ($booking->amount_paid ?? 0) + $amount;
2990 $newAmountDue = max(0.0, (float) ($booking->total_amount ?? 0) - $newAmountPaid);
2991 $paymentStatus = $newAmountDue > 0.0 ? 'partial' : 'paid';
2992 $previousStatus = (string) ($booking->status ?? 'pending');
2993
2994 $this->bookingRepository->update($bookingId, [
2995 'amount_paid' => $newAmountPaid,
2996 'amount_due' => $newAmountDue,
2997 'payment_status' => $paymentStatus,
2998 'status' => 'confirmed',
2999 ]);
3000
3001 if (function_exists('yatra_trigger_booking_confirmed')) {
3002 \yatra_trigger_booking_confirmed($bookingId, $previousStatus);
3003 }
3004
3005 // Fire payment completed action
3006 do_action('yatra_payment_completed', [
3007 'booking_id' => $bookingId,
3008 'transaction_id' => $transactionId,
3009 'amount' => $amount,
3010 'currency' => $currency,
3011 'gateway' => $gatewayId,
3012 ]);
3013 } catch (\Throwable $e) {
3014 // Best-effort: the charge is already recorded; a confirmation-page
3015 // reload / status reconciliation can recover if this update fails.
3016 }
3017 }
3018
3019 /**
3020 * Process PayPal payment
3021 */
3022 private function processPayPalPayment(array $params, array $config, bool $is_test): array
3023 {
3024 $client_id = $config['client_id'] ?? '';
3025 $client_secret = $config['client_secret'] ?? '';
3026
3027 if (empty($client_id) || empty($client_secret)) {
3028 return ['success' => false, 'message' => 'PayPal credentials not configured'];
3029 }
3030
3031 $base_url = $is_test ? 'https://api-m.sandbox.paypal.com' : 'https://api-m.paypal.com';
3032
3033 try {
3034 // Get access token
3035 $auth_response = wp_remote_post($base_url . '/v1/oauth2/token', [
3036 'headers' => [
3037 'Authorization' => 'Basic ' . base64_encode($client_id . ':' . $client_secret),
3038 'Content-Type' => 'application/x-www-form-urlencoded',
3039 ],
3040 'body' => 'grant_type=client_credentials',
3041 ]);
3042
3043 if (is_wp_error($auth_response)) {
3044 return ['success' => false, 'message' => $auth_response->get_error_message()];
3045 }
3046
3047 $auth_body = json_decode(wp_remote_retrieve_body($auth_response), true);
3048 $access_token = $auth_body['access_token'] ?? '';
3049
3050 if (empty($access_token)) {
3051 return ['success' => false, 'message' => 'Failed to get PayPal access token'];
3052 }
3053
3054 // Create order
3055 $order_response = wp_remote_post($base_url . '/v2/checkout/orders', [
3056 'headers' => [
3057 'Authorization' => 'Bearer ' . $access_token,
3058 'Content-Type' => 'application/json',
3059 ],
3060 'body' => wp_json_encode([
3061 'intent' => 'CAPTURE',
3062 'purchase_units' => [[
3063 'reference_id' => $params['reference'],
3064 'amount' => [
3065 'currency_code' => $params['currency'],
3066 'value' => number_format($params['amount'], 2, '.', ''),
3067 ],
3068 'description' => $params['trip_title'],
3069 ]],
3070 'application_context' => [
3071 'return_url' => add_query_arg('payment', 'success', $this->getConfirmationUrl($params['reference'])),
3072 'cancel_url' => home_url('/book/?payment=cancelled&ref=' . $params['reference']),
3073 ],
3074 ]),
3075 ]);
3076
3077 if (is_wp_error($order_response)) {
3078 return ['success' => false, 'message' => $order_response->get_error_message()];
3079 }
3080
3081 $order_body = json_decode(wp_remote_retrieve_body($order_response), true);
3082
3083 // Find approval link
3084 foreach ($order_body['links'] ?? [] as $link) {
3085 if ($link['rel'] === 'approve') {
3086 // Save order ID for capture later
3087 $this->bookingRepository->updatePaymentSessionId(
3088 (int) $params['booking_id'],
3089 $order_body['id'] ?? ''
3090 );
3091
3092 return ['success' => true, 'payment_url' => $link['href']];
3093 }
3094 }
3095
3096 return ['success' => false, 'message' => 'Failed to create PayPal order'];
3097 } catch (\Exception $e) {
3098 return ['success' => false, 'message' => $e->getMessage()];
3099 }
3100 }
3101
3102 /**
3103 * Process Razorpay payment
3104 */
3105 private function processRazorpayPayment(array $params, array $config, bool $is_test): array
3106 {
3107 $key_id = $config['api_key'] ?? '';
3108 $key_secret = $config['api_secret'] ?? '';
3109
3110 if (empty($key_id) || empty($key_secret)) {
3111 return ['success' => false, 'message' => 'Razorpay credentials not configured'];
3112 }
3113
3114 try {
3115 // Create Razorpay order
3116 $response = wp_remote_post('https://api.razorpay.com/v1/orders', [
3117 'headers' => [
3118 'Authorization' => 'Basic ' . base64_encode($key_id . ':' . $key_secret),
3119 'Content-Type' => 'application/json',
3120 ],
3121 'body' => wp_json_encode([
3122 'amount' => (int) ($params['amount'] * 100), // Amount in paise
3123 'currency' => $params['currency'],
3124 'receipt' => $params['reference'],
3125 'notes' => [
3126 'booking_id' => $params['booking_id'],
3127 'trip' => $params['trip_title'],
3128 ],
3129 ]),
3130 ]);
3131
3132 if (is_wp_error($response)) {
3133 return ['success' => false, 'message' => $response->get_error_message()];
3134 }
3135
3136 $body = json_decode(wp_remote_retrieve_body($response), true);
3137
3138 if (!empty($body['id'])) {
3139 // Save order ID
3140 $this->bookingRepository->updatePaymentSessionId(
3141 (int) $params['booking_id'],
3142 $body['id']
3143 );
3144
3145 // Razorpay requires client-side integration, return data for JS
3146 // Store order details and redirect to a payment page
3147 $payment_url = add_query_arg([
3148 'razorpay_order' => $body['id'],
3149 'booking_ref' => $params['reference'],
3150 'key' => $key_id,
3151 'amount' => (int) ($params['amount'] * 100),
3152 'currency' => $params['currency'],
3153 'name' => get_bloginfo('name'),
3154 'description' => $params['trip_title'],
3155 'email' => $params['customer_email'],
3156 ], home_url('/yatra-payment/razorpay/'));
3157
3158 return ['success' => true, 'payment_url' => $payment_url];
3159 }
3160
3161 return ['success' => false, 'message' => $body['error']['description'] ?? 'Failed to create Razorpay order'];
3162 } catch (\Exception $e) {
3163 return ['success' => false, 'message' => $e->getMessage()];
3164 }
3165 }
3166
3167 /**
3168 * Process eSewa payment
3169 */
3170 private function processEsewaPayment(array $params, array $config, bool $is_test): array
3171 {
3172 $merchant_id = $config['merchant_id'] ?? '';
3173
3174 if (empty($merchant_id)) {
3175 return ['success' => false, 'message' => 'eSewa merchant ID not configured'];
3176 }
3177
3178 $base_url = $is_test ? 'https://uat.esewa.com.np/epay/main' : 'https://esewa.com.np/epay/main';
3179
3180 // eSewa uses form redirect, build URL with parameters
3181 $payment_url = add_query_arg([
3182 'amt' => $params['amount'],
3183 'psc' => 0,
3184 'pdc' => 0,
3185 'txAmt' => 0,
3186 'tAmt' => $params['amount'],
3187 'pid' => $params['reference'],
3188 'scd' => $merchant_id,
3189 'su' => add_query_arg(
3190 ['payment' => 'success', 'gateway' => 'esewa'],
3191 $this->getConfirmationUrl($params['reference'])
3192 ),
3193 'fu' => home_url('/book/?payment=failed&ref=' . $params['reference']),
3194 ], $base_url);
3195
3196 return ['success' => true, 'payment_url' => $payment_url];
3197 }
3198
3199 /**
3200 * Process Khalti payment
3201 */
3202 private function processKhaltiPayment(array $params, array $config, bool $is_test): array
3203 {
3204 $secret_key = $config['api_secret'] ?? '';
3205
3206 if (empty($secret_key)) {
3207 return ['success' => false, 'message' => 'Khalti secret key not configured'];
3208 }
3209
3210 $base_url = $is_test ? 'https://a.khalti.com/api/v2/epayment/initiate/' : 'https://khalti.com/api/v2/epayment/initiate/';
3211
3212 try {
3213 $response = wp_remote_post($base_url, [
3214 'headers' => [
3215 'Authorization' => 'Key ' . $secret_key,
3216 'Content-Type' => 'application/json',
3217 ],
3218 'body' => wp_json_encode([
3219 'return_url' => add_query_arg(
3220 ['payment' => 'success', 'gateway' => 'khalti'],
3221 $this->getConfirmationUrl($params['reference'])
3222 ),
3223 'website_url' => home_url(),
3224 'amount' => (int) ($params['amount'] * 100), // Amount in paisa
3225 'purchase_order_id' => $params['reference'],
3226 'purchase_order_name' => $params['trip_title'],
3227 'customer_info' => [
3228 'name' => $params['customer_name'],
3229 'email' => $params['customer_email'],
3230 ],
3231 ]),
3232 ]);
3233
3234 if (is_wp_error($response)) {
3235 return ['success' => false, 'message' => $response->get_error_message()];
3236 }
3237
3238 $body = json_decode(wp_remote_retrieve_body($response), true);
3239
3240 if (!empty($body['payment_url'])) {
3241 // Save pidx for verification
3242 $this->bookingRepository->updatePaymentSessionId(
3243 (int) $params['booking_id'],
3244 $body['pidx'] ?? ''
3245 );
3246
3247 return ['success' => true, 'payment_url' => $body['payment_url']];
3248 }
3249
3250 return ['success' => false, 'message' => $body['detail'] ?? 'Failed to initiate Khalti payment'];
3251 } catch (\Exception $e) {
3252 return ['success' => false, 'message' => $e->getMessage()];
3253 }
3254 }
3255
3256 /**
3257 * Process Authorize.net payment
3258 */
3259 private function processAuthorizeNetPayment(array $params, array $config, bool $is_test): array
3260 {
3261 // Authorize.net typically requires hosted payment page or client-side integration
3262 // Return URL for hosted payment page setup
3263 return [
3264 'success' => true,
3265 'payment_url' => add_query_arg([
3266 'booking_ref' => $params['reference'],
3267 'amount' => $params['amount'],
3268 'gateway' => 'authorize_net',
3269 ], home_url('/yatra-payment/authorize-net/'))
3270 ];
3271 }
3272
3273 /**
3274 * Get client IP address
3275 */
3276 private function getClientIp(): string
3277 {
3278 $ip_keys = ['HTTP_CLIENT_IP', 'HTTP_X_FORWARDED_FOR', 'HTTP_X_FORWARDED', 'HTTP_FORWARDED_FOR', 'HTTP_FORWARDED', 'REMOTE_ADDR'];
3279
3280 foreach ($ip_keys as $key) {
3281 if (!empty($_SERVER[$key])) {
3282 $ip = sanitize_text_field($_SERVER[$key]);
3283 if (strpos($ip, ',') !== false) {
3284 $ip = trim(explode(',', $ip)[0]);
3285 }
3286 if (filter_var($ip, FILTER_VALIDATE_IP)) {
3287 return $ip;
3288 }
3289 }
3290 }
3291
3292 return '0.0.0.0';
3293 }
3294
3295 /**
3296 * Send booking confirmation email
3297 */
3298 private function sendBookingConfirmationEmail(int $booking_id, string $reference, object $trip, array $data): void
3299 {
3300 $contact = $data['contact'] ?? [];
3301 $travelers = $data['travelers'] ?? [];
3302 $travel_date = $data['travel_date'] ?? '';
3303 $total_amount = $data['total_amount'] ?? 0;
3304 $amount_due = $data['amount_due'] ?? 0;
3305 $payment_method = $data['payment_method'] ?? 'full';
3306 $payment_gateway = $data['payment_gateway'] ?? 'pay_later';
3307 $booking_status = $data['booking_status'] ?? 'pending';
3308 // Cancellation copy in the email now comes from the trip's
3309 // own cancellation_policy field (set per-trip on the Trip
3310 // editor), not from removed global settings. Falls back to
3311 // empty so the paragraph is silently omitted when the trip
3312 // doesn't have a policy set.
3313 $trip_cancellation_policy = isset($trip->cancellation_policy)
3314 ? wp_strip_all_tags((string) $trip->cancellation_policy)
3315 : '';
3316 $expiry_datetime = $data['expiry_datetime'] ?? null;
3317
3318 $customer_email = $contact['email'] ?? '';
3319 $customer_name = trim(($contact['first_name'] ?? '') . ' ' . ($contact['last_name'] ?? ''));
3320
3321 if (empty($customer_email)) {
3322 return;
3323 }
3324
3325 // Format prices using global currency settings
3326 $formatted_total = yatra_format_price($total_amount);
3327 $formatted_due = yatra_format_price($amount_due);
3328
3329 $intro_paragraph = $booking_status === 'confirmed'
3330 ? __('Thank you for your booking! Your reservation has been confirmed.', 'yatra')
3331 : __('Thank you for your booking! Your reservation has been received and is pending confirmation.', 'yatra');
3332 if ($booking_status === 'pending' && $expiry_datetime) {
3333 $intro_paragraph .= ' ' . sprintf(
3334 /* translators: %s: payment expiry date and time (formatted). */
3335 __('Please complete your payment before %s to avoid automatic cancellation.', 'yatra'),
3336 date_i18n(get_option('date_format') . ' ' . get_option('time_format'), strtotime($expiry_datetime))
3337 );
3338 }
3339
3340 ob_start();
3341 ?>
3342 <div style="background:#f3f4f6;padding:20px;border-radius:8px;margin:16px 0;">
3343 <p style="margin:0 0 8px;"><strong><?php esc_html_e('Booking reference', 'yatra'); ?>:</strong> <?php echo esc_html($reference); ?></p>
3344 <p style="margin:0 0 8px;"><strong><?php esc_html_e('Trip', 'yatra'); ?>:</strong> <?php echo esc_html($trip->title); ?></p>
3345 <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>
3346 <p style="margin:0 0 8px;"><strong><?php esc_html_e('Duration', 'yatra'); ?>:</strong> <?php /* translators: 1: number of days, 2: number of nights. */
3347 echo esc_html(sprintf(__('%1$d days / %2$d nights', 'yatra'), (int) $trip->duration_days, (int) $trip->duration_nights)); ?></p>
3348 <p style="margin:0;"><strong><?php esc_html_e('Travelers', 'yatra'); ?>:</strong> <?php echo esc_html((string) count($travelers)); ?></p>
3349 </div>
3350 <h3 style="font-size:16px;"><?php esc_html_e('Payment details', 'yatra'); ?></h3>
3351 <p><?php /* translators: %s: total amount (formatted). */
3352 echo esc_html(sprintf(__('Total: %s', 'yatra'), $formatted_total)); ?></p>
3353 <?php if ($payment_method === 'deposit') : ?>
3354 <p><?php /* translators: 1: amount due now (formatted), 2: remaining amount (formatted). */
3355 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>
3356 <?php elseif ($payment_method === 'partial') : ?>
3357 <p><?php /* translators: 1: amount due now (formatted), 2: remaining amount (formatted). */
3358 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>
3359 <?php else : ?>
3360 <p><?php esc_html_e('Payment type: Full payment', 'yatra'); ?></p>
3361 <?php endif; ?>
3362 <?php if ($payment_gateway === 'pay_later') : ?>
3363 <p><?php esc_html_e('Pay later — please contact us to arrange payment.', 'yatra'); ?></p>
3364 <?php elseif ($payment_gateway === 'bank_transfer') : ?>
3365 <p><?php esc_html_e('Bank transfer — you will receive bank details separately.', 'yatra'); ?></p>
3366 <?php endif; ?>
3367 <h3 style="font-size:16px;"><?php esc_html_e('Travelers', 'yatra'); ?></h3>
3368 <ul style="padding-left:20px;">
3369 <?php foreach ($travelers as $i => $traveler) : ?>
3370 <?php
3371 $traveler_name = trim(($traveler['first_name'] ?? '') . ' ' . ($traveler['last_name'] ?? ''));
3372 ?>
3373 <li><?php /* translators: 1: traveler number (1-based), 2: traveler full name. */
3374 echo esc_html(sprintf(__('Traveler %1$d: %2$s', 'yatra'), $i + 1, $traveler_name ?: '')); ?></li>
3375 <?php endforeach; ?>
3376 </ul>
3377 <?php
3378 // Cancellation policy paragraph now sources from the trip's
3379 // per-trip cancellation_policy field (set on the Trip
3380 // editor). The previous version used global cancellation
3381 // settings that were display-only — they appeared here but
3382 // never enforced a real cancellation cutoff. We've removed
3383 // those settings; if the trip itself doesn't define a
3384 // policy, the whole section is silently omitted so the
3385 // email isn't padded with empty headings.
3386 if ($trip_cancellation_policy !== '') {
3387 ?>
3388 <h3 style="font-size:16px;"><?php esc_html_e('Cancellation policy', 'yatra'); ?></h3>
3389 <p><?php echo esc_html($trip_cancellation_policy); ?></p>
3390 <?php
3391 }
3392 ?>
3393 <h3 style="font-size:16px;"><?php esc_html_e('What’s next?', 'yatra'); ?></h3>
3394 <ol style="padding-left:20px;">
3395 <li><?php esc_html_e('You will receive a detailed trip itinerary within 24–48 hours.', 'yatra'); ?></li>
3396 <li><?php esc_html_e('Our team will contact you to confirm any special requirements.', 'yatra'); ?></li>
3397 <li><?php esc_html_e('Please ensure travel documents meet entry requirements for your destination.', 'yatra'); ?></li>
3398 </ol>
3399 <p><?php esc_html_e('If you have any questions, contact us anytime.', 'yatra'); ?></p>
3400 <p><a href="<?php echo esc_url(home_url('/')); ?>"><?php echo esc_html(home_url('/')); ?></a></p>
3401 <?php
3402 $details_html = ob_get_clean();
3403
3404 // Seed from the canonical booking variables FIRST so every dynamic
3405 // merge tag — {{contact_*}} / {{emergency_*}} custom fields,
3406 // {{traveler_custom_fields_html}}, {{balance_due}}, payment/schedule
3407 // tags, etc. — resolves on this offline / pay-later path exactly like
3408 // the online-gateway path (BookingService::sendBookingConfirmationEmail).
3409 // Previously this method hand-built only ~18 core keys, so an operator
3410 // who customised the Booking Confirmation template with a custom-field
3411 // variable saw it render empty on offline bookings. The hand-built keys
3412 // below (the self-rendered details_html, intro, footer) intentionally
3413 // take precedence via array_merge ordering.
3414 $base_vars = [];
3415 $saved_booking = $this->bookingRepository->find($booking_id);
3416 if ($saved_booking) {
3417 $base_vars = TransactionalEmailTemplateService::variablesFromBooking($saved_booking);
3418 }
3419
3420 $vars = array_merge($base_vars, [
3421 'customer_name' => $customer_name,
3422 'customer_first_name' => (string) ($contact['first_name'] ?? ''),
3423 'customer_last_name' => (string) ($contact['last_name'] ?? ''),
3424 'customer_email' => $customer_email,
3425 'customer_phone' => (string) ($contact['phone'] ?? ''),
3426 'booking_reference' => $reference,
3427 'booking_id' => (string) $booking_id,
3428 'trip_name' => (string) $trip->title,
3429 'trip_url' => home_url('/' . SettingsService::getTripBase() . '/' . rawurlencode((string) ($trip->slug ?? '')) . '/'),
3430 'travel_date' => date_i18n(get_option('date_format'), strtotime($travel_date)),
3431 'travelers_count' => (string) count($travelers),
3432 'total_amount_formatted' => $formatted_total,
3433 'amount_due_formatted' => $formatted_due,
3434 'currency' => SettingsService::getCurrency(),
3435 'intro_paragraph' => $intro_paragraph,
3436 'details_html' => $details_html,
3437 'details_html_only' => '1',
3438 /* translators: %s: site name. */
3439 'footer_note' => sprintf(__('— %s', 'yatra'), get_bloginfo('name')),
3440 'transactional_context' => 'booking_created',
3441 ]);
3442
3443 TransactionalEmailTemplateService::sendIfEnabled(
3444 TransactionalEmailTemplateService::TYPE_BOOKING_CONFIRMATION,
3445 $customer_email,
3446 $vars
3447 );
3448
3449 // Admin new-booking email is sent from NotificationService (yatra_booking_created) using
3450 // Email → Templates → Admin: New booking, to avoid duplicate messages.
3451 }
3452
3453 /**
3454 * Apply coupon code to booking session
3455 */
3456 public function apply_coupon(WP_REST_Request $request): WP_REST_Response
3457 {
3458 yatra_start_session();
3459
3460 $data = $request->get_json_params() ?? [];
3461
3462 // M-2: restore CSRF protection stripped by public_permission_callback.
3463 if (($blocked = $this->guardPublicBookingMutation($request, $data)) !== null) {
3464 return $blocked;
3465 }
3466
3467 $code = isset($data['code']) ? strtoupper(sanitize_text_field($data['code'])) : '';
3468
3469 if (empty($code)) {
3470 return new WP_REST_Response([
3471 'success' => false,
3472 'message' => __('Please enter a coupon code.', 'yatra'),
3473 ], 400);
3474 }
3475
3476 // Get current session — with token-rehydration fallback for REST
3477 // contexts where PHPSESSID isn't propagated (same shape as the
3478 // service-toggle / summary endpoints). Also writes back to $_SESSION
3479 // so the subsequent `yatra_set_booking_session()` persists alongside
3480 // the existing transient.
3481 $session = yatra_get_booking_session();
3482 if (empty($session) || empty($session['trip_id'])) {
3483 $token = null;
3484 if (!empty($data['booking_token']) && is_string($data['booking_token'])) {
3485 $token = sanitize_text_field((string) $data['booking_token']);
3486 } elseif (isset($_GET['booking_token']) && is_string($_GET['booking_token'])) {
3487 $token = sanitize_text_field((string) wp_unslash($_GET['booking_token']));
3488 }
3489 if ($token) {
3490 $transient_data = get_transient($token);
3491 if (is_array($transient_data) && !empty($transient_data['trip_id'])) {
3492 $session = $transient_data;
3493 $_SESSION['yatra_booking'] = $session;
3494 $_SESSION['yatra_booking_token'] = $token;
3495 }
3496 }
3497 }
3498 if (empty($session) || empty($session['trip_id'])) {
3499 return new WP_REST_Response([
3500 'success' => false,
3501 'message' => __('No active booking session found.', 'yatra'),
3502 ], 400);
3503 }
3504
3505 // Use DiscountService to calculate coupon discount
3506 $discountService = new \Yatra\Services\DiscountService();
3507 $total_amount = $this->calculateSessionTotal($session);
3508 $trip_id = (int) $session['trip_id'];
3509 $travelers_count = (int) ($session['travelers'] ?? 1);
3510 $traveler_counts = $session['traveler_counts'] ?? [];
3511
3512 $coupon_result = $discountService->calculateCouponDiscount(
3513 $code,
3514 $total_amount,
3515 $trip_id,
3516 $travelers_count,
3517 $traveler_counts
3518 );
3519
3520 // Check if discount was calculated (validation passed)
3521 if ($coupon_result['calculated_amount'] <= 0) {
3522 return new WP_REST_Response([
3523 'success' => false,
3524 'message' => __('This coupon is not valid for your booking.', 'yatra'),
3525 ], 400);
3526 }
3527
3528 $discount_amount = $coupon_result['calculated_amount'];
3529
3530
3531 // Store coupon in session (use the original $code variable, not from result)
3532 $session['coupon'] = [
3533 'code' => $code, // Use the actual code that was validated
3534 'type' => $coupon_result['type'],
3535 'amount' => $coupon_result['amount'],
3536 'discount_amount' => $discount_amount,
3537 'label' => $coupon_result['label'],
3538 ];
3539 $session['timestamp'] = time();
3540
3541 yatra_set_booking_session($session);
3542
3543
3544 return new WP_REST_Response([
3545 'success' => true,
3546 'message' => __('Coupon applied successfully!', 'yatra'),
3547 'data' => [
3548 'code' => $code,
3549 'type' => $coupon_result['type'],
3550 'discount_amount' => $discount_amount,
3551 'discount_formatted' => yatra_format_price($discount_amount),
3552 'new_total' => $total_amount - $discount_amount,
3553 'new_total_formatted' => yatra_format_price($total_amount - $discount_amount),
3554 ],
3555 ]);
3556 }
3557
3558 /**
3559 * Verify a guest's booking email via magic-link token.
3560 *
3561 * Flow:
3562 * 1. Validate the HMAC token (forgery, expiry, email-binding).
3563 * 2. Look up the booking; confirm it's in `pending_verification`.
3564 * 3. Flip status to `pending` (or `confirmed` when auto-confirm
3565 * pay-later is enabled for this site) and fire the standard
3566 * yatra_booking_status_changed action so inventory + email
3567 * automations resume normally.
3568 * 4. 302 redirect the browser to a continuation URL:
3569 * - If amount_due > 0: back to the booking page for the
3570 * payment step the customer skipped earlier.
3571 * - If amount_due == 0 / auto-confirm: to the booking
3572 * confirmation/thank-you page.
3573 * 5. On any failure, render a friendly HTML page (not JSON) so
3574 * the customer sees readable text in their browser tab.
3575 *
3576 * @return WP_REST_Response|WP_Error|void
3577 */
3578 public function verify_email(WP_REST_Request $request)
3579 {
3580 $token = (string) $request->get_param('token');
3581 $bookingRepo = new \Yatra\Repositories\BookingRepository();
3582
3583 // First decode just to extract the booking id (for the
3584 // expectedEmail lookup). Verify() is called again below
3585 // with the actual email so the email-binding check runs.
3586 $partsPreview = explode('.', $token);
3587 $bookingIdGuess = (\count($partsPreview) >= 1 && ctype_digit($partsPreview[0]))
3588 ? (int) $partsPreview[0]
3589 : 0;
3590 $booking = $bookingIdGuess > 0 ? $bookingRepo->find($bookingIdGuess) : null;
3591 $expectedEmail = $booking ? (string) ($booking->contact_email ?? '') : '';
3592
3593 $result = \Yatra\Services\GuestVerificationTokenService::verify($token, $expectedEmail);
3594
3595 if (!$result['ok']) {
3596 $this->renderVerifyEmailErrorPage((string) ($result['reason'] ?? 'invalid'));
3597 }
3598 if ($booking === null) {
3599 $this->renderVerifyEmailErrorPage('booking_not_found');
3600 }
3601
3602 // Re-entrant: if the booking has already been verified, show the
3603 // same success page (idempotent) — pre-3.0.5 silently redirected
3604 // and the customer was left wondering whether anything happened.
3605 $currentStatus = (string) ($booking->status ?? '');
3606 $alreadyVerified = $currentStatus !== 'pending_verification';
3607
3608 if (!$alreadyVerified) {
3609 // Flip status to 'pending' so downstream hooks (inventory /
3610 // notification automations) see fresh data, then fire
3611 // yatra_booking_created so the listeners we deferred at
3612 // creation time (admin "new booking" notification + Pro
3613 // email-automation booking.created fan-out) run now — i.e.
3614 // *after* the customer has proven the email is theirs.
3615 $bookingRepo->updateStatus((int) $booking->id, 'pending');
3616 do_action('yatra_booking_email_verified', (int) $booking->id);
3617
3618 // Re-fetch so the post-verification action receives the
3619 // booking row with the new status, then fire the deferred
3620 // booking-created action. See BookingService::createBooking()
3621 // for the matching skip-on-pending-verification branch.
3622 $verifiedBooking = $bookingRepo->find((int) $booking->id);
3623 if (is_object($verifiedBooking)) {
3624 do_action(
3625 \Yatra\Hooks\TelemetryHookNames::BOOKING_CREATED,
3626 (int) $verifiedBooking->id,
3627 $verifiedBooking
3628 );
3629 }
3630
3631 // Guest email-verification defers the customer booking-confirmation
3632 // email: the checkout flow returns at the verification gate, before
3633 // its send-site (~line 2465), so the confirmation is never sent for a
3634 // verified guest booking. Send it now that the email is proven and the
3635 // booking is live — gated by the same `booking_confirmation` option the
3636 // checkout paths use. Only in this fresh-verify branch, so a re-clicked
3637 // link never re-sends. TYPE_BOOKING_CONFIRMATION is skipped by the Pro
3638 // booking.created fan-out, so this is the single source of the email.
3639 if ((bool) \Yatra\Services\SettingsService::get('booking_confirmation', true)) {
3640 try {
3641 (new \Yatra\Services\BookingService())->sendNewBookingTransactionalConfirmation((int) $booking->id);
3642 } catch (\Throwable $e) {
3643 // A mail failure must never break the customer's "verified" page.
3644 Logger::error('Post-verification booking confirmation email failed', [
3645 'booking_id' => (int) $booking->id,
3646 'error' => $e->getMessage(),
3647 ]);
3648 }
3649 }
3650 }
3651
3652 $this->renderVerifyEmailSuccessPage(
3653 (int) $booking->id,
3654 (string) ($booking->reference ?? ''),
3655 $alreadyVerified
3656 );
3657 }
3658
3659 /**
3660 * Friendly HTML error page rendered when a verification link
3661 * is invalid / expired / tampered with. Avoids JSON in the
3662 * customer's browser tab (terrible UX). Reasons map to clear
3663 * messages so customers know what to do next.
3664 *
3665 * Emits raw HTML and exits. We can't return WP_REST_Response with an
3666 * HTML body because the REST server JSON-encodes the response data
3667 * regardless of the Content-Type header on the response object —
3668 * the customer would see `"<!doctype..."` (a JSON string) in their
3669 * browser tab. Echoing + exiting short-circuits the REST pipeline.
3670 *
3671 * @return never
3672 */
3673 private function renderVerifyEmailErrorPage(string $reason): void
3674 {
3675 $messages = [
3676 'expired' => __('This verification link has expired. Please make a new booking — we keep the link valid for 48 hours.', 'yatra'),
3677 'invalid_signature' => __('This verification link is invalid or has been tampered with. Please make a new booking.', 'yatra'),
3678 'malformed_token' => __('This verification link is malformed. Please make a new booking.', 'yatra'),
3679 'email_changed' => __('The email on this booking has changed since the link was sent. Please contact support.', 'yatra'),
3680 'booking_not_found' => __('We could not find a booking for this verification link. Please make a new booking.', 'yatra'),
3681 ];
3682 $message = $messages[$reason] ?? __('This verification link is no longer valid.', 'yatra');
3683
3684 $brandName = function_exists('yatra_get_brand_name') ? yatra_get_brand_name() : 'Yatra';
3685 $html = sprintf(
3686 '<!doctype html><html lang="%1$s"><head><meta charset="utf-8">'
3687 . '<meta name="viewport" content="width=device-width,initial-scale=1">'
3688 . '<title>%2$s</title>'
3689 . '<style>body{font-family:system-ui,-apple-system,Segoe UI,Roboto,sans-serif;background:#f9fafb;margin:0;padding:40px 20px;color:#111827}'
3690 . '.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}'
3691 . 'h1{font-size:20px;margin:0 0 12px}p{color:#4b5563;line-height:1.6;margin:0 0 20px}'
3692 . 'a{display:inline-block;background:#2563eb;color:#fff;padding:12px 24px;border-radius:8px;text-decoration:none;font-weight:600}</style></head>'
3693 . '<body><div class="box"><h1>%3$s</h1><p>%4$s</p><a href="%5$s">%6$s</a></div></body></html>',
3694 esc_attr(get_locale()),
3695 esc_html__('Verification link issue', 'yatra'),
3696 esc_html__('Verification link issue', 'yatra'),
3697 esc_html($message),
3698 esc_url(home_url('/')),
3699 esc_html(sprintf(/* translators: %s: brand name */ __('Return to %s', 'yatra'), $brandName))
3700 );
3701
3702 if (!headers_sent()) {
3703 status_header(200);
3704 nocache_headers();
3705 header('Content-Type: text/html; charset=UTF-8');
3706 }
3707 echo $html;
3708 exit;
3709 }
3710
3711 /**
3712 * Build the booking continuation URL (post-verification destination).
3713 *
3714 * If the site has a Yatra Bookings page, route through that with the
3715 * booking reference; otherwise fall back to the trip URL. Filterable
3716 * via `yatra_guest_verification_continuation_url` so integrations can
3717 * route to a custom thank-you page.
3718 */
3719 private function continuationUrl(int $bookingId, string $reference): string
3720 {
3721 return (string) apply_filters(
3722 'yatra_guest_verification_continuation_url',
3723 add_query_arg(
3724 ['booking_id' => $bookingId, 'verified' => '1'],
3725 home_url('/' . \Yatra\Services\SettingsService::getBookingBase() . '/')
3726 ),
3727 $bookingId,
3728 $reference
3729 );
3730 }
3731
3732 /**
3733 * Friendly HTML success page rendered after the guest clicks the
3734 * email-verification magic link.
3735 *
3736 * Pre-3.0.5 this endpoint silently 302-redirected to the booking page,
3737 * which made guests believe nothing had happened — there was no visible
3738 * "verified" feedback before they landed on the next step. This page
3739 * gives them an unambiguous confirmation, the booking reference, and
3740 * three explicit CTAs:
3741 * - Continue to booking (primary, continuation URL)
3742 * - My Account (when logged in) / Sign in (when not)
3743 * - Go to homepage (fallback)
3744 *
3745 * Idempotent: when the booking was already verified (re-click on the
3746 * same link), the heading + copy switch to the "already verified"
3747 * variant but the CTAs stay the same.
3748 *
3749 * Emits raw HTML and exits — same reasoning as
3750 * {@see self::renderVerifyEmailErrorPage()}: WP_REST_Response
3751 * JSON-encodes string bodies, so the customer would see
3752 * `"<!doctype..."` in their tab instead of the rendered page.
3753 *
3754 * @return never
3755 */
3756 private function renderVerifyEmailSuccessPage(int $bookingId, string $reference, bool $alreadyVerified): void
3757 {
3758 // Booking is already persisted at this point and (for a fresh verify)
3759 // the status flip + booking-created fan-out have just fired. The
3760 // verified UI's primary action is therefore "View your booking
3761 // confirmation" — NOT "Continue Booking", which mislabelled the
3762 // booking as still in-progress and confused customers into thinking
3763 // they needed to re-submit the form.
3764 $confirmationUrl = function_exists('yatra_get_booking_confirmation_url')
3765 ? yatra_get_booking_confirmation_url($reference)
3766 : $this->continuationUrl($bookingId, $reference);
3767
3768 // Account / login URL — prefer Yatra's account page when present,
3769 // fall back to wp_login_url() so the page never points nowhere.
3770 $accountBase = \Yatra\Services\SettingsService::getAccountBase();
3771 $accountUrl = $accountBase !== ''
3772 ? home_url('/' . trim($accountBase, '/') . '/')
3773 : home_url('/');
3774 $isLoggedIn = function_exists('is_user_logged_in') && is_user_logged_in();
3775 $secondaryUrl = $isLoggedIn ? $accountUrl : wp_login_url($confirmationUrl);
3776 $secondaryLabel = $isLoggedIn
3777 ? __('Go to My Account', 'yatra')
3778 : __('Sign in', 'yatra');
3779
3780 // Logged-in customers always get "Go to My Account". A guest is only
3781 // offered "Sign in" when an account is genuinely part of the flow —
3782 // registration is enabled AND guest checkout is not the operating mode.
3783 // This is a guest email-verification page (guest checkout is normally
3784 // on), so with guest checkout enabled OR registration disabled there is
3785 // no account to sign into; the CTA is hidden rather than dangling to a
3786 // login the guest can't use.
3787 $registrationEnabled = \Yatra\Services\SettingsService::isEnabled('customer_registration');
3788 $guestCheckoutEnabled = \Yatra\Services\SettingsService::isEnabled('allow_guest_checkout');
3789 $showSecondaryCta = $isLoggedIn || ($registrationEnabled && !$guestCheckoutEnabled);
3790 $secondaryCta = $showSecondaryCta
3791 ? '<a class="btn btn-secondary" href="' . esc_url($secondaryUrl) . '">' . esc_html($secondaryLabel) . '</a>'
3792 : '';
3793
3794 $heading = $alreadyVerified
3795 ? __('Email Already Verified', 'yatra')
3796 : __('Email Verified', 'yatra');
3797 $message = $alreadyVerified
3798 ? __('Your booking email is already verified. You can view your booking confirmation, head to your account, or return to the homepage.', 'yatra')
3799 : __('Thanks! Your booking email has been verified and your booking is confirmed. View the full confirmation below.', 'yatra');
3800
3801 $primaryLabel = __('View Booking Confirmation', 'yatra');
3802 $homeLabel = __('Go to Homepage', 'yatra');
3803 $referenceLabel = __('Booking reference', 'yatra');
3804 $brandName = function_exists('yatra_get_brand_name') ? yatra_get_brand_name() : 'Yatra';
3805
3806 $referenceLine = $reference !== ''
3807 ? sprintf(
3808 '<div class="ref"><span class="ref-label">%s</span><code>%s</code></div>',
3809 esc_html($referenceLabel),
3810 esc_html($reference)
3811 )
3812 : '';
3813
3814 // Inline-only styling so the page renders correctly regardless of
3815 // theme stylesheet load order (REST → wp_die/raw HTML response).
3816 $html = sprintf(
3817 '<!doctype html><html lang="%1$s"><head><meta charset="utf-8">'
3818 . '<meta name="viewport" content="width=device-width,initial-scale=1">'
3819 . '<title>%2$s · %3$s</title>'
3820 . '<style>'
3821 . 'body{font-family:system-ui,-apple-system,Segoe UI,Roboto,sans-serif;background:#f9fafb;margin:0;padding:40px 20px;color:#111827}'
3822 . '.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}'
3823 . '.tick{display:inline-flex;align-items:center;justify-content:center;width:72px;height:72px;border-radius:50%%;background:#d1fae5;margin:0 auto 20px}'
3824 . 'h1{font-size:24px;margin:0 0 12px;color:#065f46}'
3825 . 'p{color:#4b5563;line-height:1.6;margin:0 0 24px}'
3826 . '.ref{display:inline-flex;align-items:center;gap:8px;background:#f3f4f6;border-radius:6px;padding:8px 12px;margin:0 0 24px}'
3827 . '.ref-label{font-size:12px;color:#6b7280;text-transform:uppercase;letter-spacing:.04em}'
3828 . '.ref code{font-weight:600;color:#111827}'
3829 . '.actions{display:flex;flex-direction:column;gap:10px;margin-top:8px}'
3830 . '.btn{display:inline-block;padding:12px 24px;border-radius:8px;text-decoration:none;font-weight:600;text-align:center}'
3831 . '.btn-primary{background:#059669;color:#fff}'
3832 . '.btn-primary:hover{background:#047857}'
3833 . '.btn-secondary{background:#fff;color:#1f2937;border:1px solid #d1d5db}'
3834 . '.btn-secondary:hover{background:#f9fafb}'
3835 . '.btn-tertiary{color:#4b5563;padding:8px 12px;font-weight:500}'
3836 . '</style></head>'
3837 . '<body><div class="box">'
3838 . '<div class="tick" aria-hidden="true">'
3839 . '<svg width="40" height="40" viewBox="0 0 24 24" fill="none" stroke="#059669" stroke-width="3" stroke-linecap="round" stroke-linejoin="round">'
3840 . '<polyline points="20 6 9 17 4 12"></polyline></svg>'
3841 . '</div>'
3842 . '<h1>%2$s</h1>'
3843 . '<p>%4$s</p>'
3844 . '%5$s'
3845 . '<div class="actions">'
3846 . '<a class="btn btn-primary" href="%6$s">%7$s</a>'
3847 . '%8$s'
3848 . '<a class="btn btn-tertiary" href="%10$s">%11$s</a>'
3849 . '</div>'
3850 . '</div></body></html>',
3851 esc_attr(get_locale()),
3852 esc_html($heading),
3853 esc_html($brandName),
3854 esc_html($message),
3855 $referenceLine,
3856 esc_url($confirmationUrl),
3857 esc_html($primaryLabel),
3858 // %8 is the fully-built secondary CTA (or '' when hidden — see
3859 // $showSecondaryCta above). %9 is intentionally empty to keep the
3860 // positional args aligned with %10/%11.
3861 $secondaryCta,
3862 '',
3863 esc_url(home_url('/')),
3864 esc_html($homeLabel)
3865 );
3866
3867 if (!headers_sent()) {
3868 status_header(200);
3869 nocache_headers();
3870 header('Content-Type: text/html; charset=UTF-8');
3871 }
3872 echo $html;
3873 exit;
3874 }
3875
3876 /**
3877 * Calculate booking summary and return HTML for dynamic updates
3878 * Called via AJAX when traveler count, date, or coupon changes
3879 */
3880 public function calculate_summary(WP_REST_Request $request): WP_REST_Response
3881 {
3882 yatra_start_session();
3883 $session = yatra_get_booking_session();
3884 $data = $request->get_json_params() ?? [];
3885
3886 // M-2: restore CSRF protection stripped by public_permission_callback.
3887 if (($blocked = $this->guardPublicBookingMutation($request, $data)) !== null) {
3888 return $blocked;
3889 }
3890
3891 // Same REST-context session-rehydration fallback as set_session() /
3892 // create_booking(): when PHPSESSID isn't propagated to the REST API
3893 // scope, look up the transient by `booking_token` (from request body
3894 // first, then ?booking_token=) so the partial summary refresh
3895 // doesn't 400. Without this, every service-toggle re-render fails
3896 // because trip_id resolves to 0.
3897 //
3898 // We also write the rehydrated session into $_SESSION so that the
3899 // downstream buildPricingHtml() — which calls yatra_get_booking_session()
3900 // again — sees the same data and doesn't fall back to its
3901 // "Pricing information not available" branch.
3902 if (empty($session) || empty($session['trip_id'])) {
3903 $token = null;
3904 if (!empty($data['booking_token']) && is_string($data['booking_token'])) {
3905 $token = sanitize_text_field((string) $data['booking_token']);
3906 } elseif (isset($_GET['booking_token']) && is_string($_GET['booking_token'])) {
3907 $token = sanitize_text_field((string) wp_unslash($_GET['booking_token']));
3908 }
3909 if ($token) {
3910 $transient_data = get_transient($token);
3911 if (is_array($transient_data) && !empty($transient_data['trip_id'])) {
3912 $session = $transient_data;
3913 $_SESSION['yatra_booking'] = $session;
3914 $_SESSION['yatra_booking_token'] = $token;
3915 }
3916 }
3917 }
3918
3919 // Get trip_id from session (required)
3920 $trip_id = (int) ($session['trip_id'] ?? 0);
3921
3922 // Get traveler_counts from REQUEST (for dynamic updates) or fallback to session
3923 $traveler_counts = $data['traveler_counts'] ?? ($session['traveler_counts'] ?? []);
3924
3925 // Get other data from request or session
3926 $travel_date = sanitize_text_field($data['travel_date'] ?? ($session['travel_date'] ?? ''));
3927 $departure_time = sanitize_text_field($data['departure_time'] ?? ($session['departure_time'] ?? ''));
3928 $availability_id = $data['availability_id'] ?? ($session['availability_id'] ?? null);
3929 $pricing_type_from_request = sanitize_text_field($data['pricing_type'] ?? ($session['pricing_type'] ?? ''));
3930 $payment_method = strtolower(trim(sanitize_text_field($data['payment_method'] ?? ($session['payment_method'] ?? 'full'))));
3931 if ($payment_method === '') {
3932 $payment_method = 'full';
3933 }
3934 $selected_service_ids_from_request = $data['additional_services'] ?? ($session['additional_services'] ?? null);
3935
3936 // IMPORTANT: Always read coupon from SESSION (not request) to maintain applied discount
3937 $coupon_code = isset($session['coupon']['code']) ? sanitize_text_field($session['coupon']['code']) : '';
3938
3939
3940 if (empty($trip_id)) {
3941 return new WP_REST_Response([
3942 'success' => false,
3943 'message' => __('No active booking session found.', 'yatra'),
3944 ], 400);
3945 }
3946
3947 // Get trip data
3948 $trip = $this->tripRepository->findPublished($trip_id);
3949 if (!$trip) {
3950 return new WP_REST_Response([
3951 'success' => false,
3952 'message' => __('Trip not found.', 'yatra'),
3953 ], 404);
3954 }
3955
3956 // Ensure pricing fields are properly set
3957 $trip->original_price = (float) ($trip->original_price ?? 0);
3958 $trip->discounted_price = !empty($trip->discounted_price) ? (float) $trip->discounted_price : 0;
3959 $trip->sale_price = !empty($trip->sale_price) ? (float) $trip->sale_price : 0;
3960
3961 yatra_start_session();
3962 $existing_session = yatra_get_booking_session();
3963
3964 global $wpdb;
3965
3966 $availability = null;
3967 if (!empty($travel_date)) {
3968 // Use the same resolver as the single-trip UI so rule slots, manual dates,
3969 // and flexible defaults all return a consistent object shape.
3970 try {
3971 $resolver = new \Yatra\Services\AvailabilityResolutionService();
3972 $availability = $resolver->resolveAvailabilityForDate(
3973 $trip_id,
3974 $travel_date,
3975 $departure_time !== '' ? $departure_time : null
3976 );
3977 } catch (\Throwable $e) {
3978 $availability = null;
3979 }
3980 } elseif (!empty($availability_id) && is_numeric($availability_id)) {
3981 // Back-compat: allow summary by numeric availability_id only.
3982 $availability = $this->availabilityService->getById((int) $availability_id);
3983 }
3984
3985 // Resolve pricing type and price_types via centralized TripPricingService
3986 $resolved_pricing_type = !empty($pricing_type_from_request)
3987 ? $pricing_type_from_request
3988 : \Yatra\Services\TripPricingService::resolvePricingType($trip);
3989
3990 $price_types = [];
3991
3992 // First priority: availability price_types (already includes trip fallback from AvailabilityResolutionService)
3993 if ($availability && !empty($availability->price_types)) {
3994 $avail_pts = is_string($availability->price_types)
3995 ? (json_decode($availability->price_types, true) ?: [])
3996 : $availability->price_types;
3997 if (!empty($avail_pts) && is_array($avail_pts)) {
3998 $price_types = array_map(function ($pt) { return (object) $pt; }, $avail_pts);
3999 }
4000 }
4001 // Second priority: trip's price_types via centralized normalizer
4002 if (empty($price_types)) {
4003 $normalized = \Yatra\Services\TripPricingService::resolvePriceTypes($trip);
4004 if (!empty($normalized)) {
4005 $price_types = array_map(function ($pt) { return (object) $pt; }, $normalized);
4006 }
4007 }
4008 // Auto-detect traveler_based if price_types are present
4009 if (!empty($price_types)) {
4010 $resolved_pricing_type = 'traveler_based';
4011 }
4012
4013 // Resolve pricing_mode / group-size limits authoritatively from the
4014 // TravelerCategory so the summary breakdown treats a per-group category
4015 // as a flat charge. No-op for per-person categories.
4016 if (!empty($price_types)) {
4017 $price_types = \Yatra\Services\TripPricingService::applyCategoryPricingMeta($price_types);
4018 }
4019
4020 // Enrich availability price_types with category labels if missing
4021 if (!empty($price_types)) {
4022 $missing_label_category_ids = [];
4023 foreach ($price_types as $pt) {
4024 $pt = (object) $pt;
4025 if (empty($pt->category_label) && !empty($pt->category_id)) {
4026 $missing_label_category_ids[] = (int) $pt->category_id;
4027 }
4028 }
4029
4030 $missing_label_category_ids = array_values(array_unique(array_filter($missing_label_category_ids)));
4031 if (!empty($missing_label_category_ids)) {
4032 // Use AvailabilityService to get traveler categories
4033 $cats = $this->availabilityService->getTravelerCategories($missing_label_category_ids);
4034
4035 $catIndex = [];
4036 foreach ($cats as $cat) {
4037 $catIndex[(int) $cat->id] = $cat;
4038 }
4039
4040 foreach ($price_types as &$pt) {
4041 $pt = (object) $pt;
4042 $catId = !empty($pt->category_id) ? (int) $pt->category_id : null;
4043 if ($catId && isset($catIndex[$catId])) {
4044 $cat = $catIndex[$catId];
4045 if (empty($pt->category_label)) {
4046 $pt->category_label = $cat->label;
4047 }
4048 if (empty($pt->category_slug)) {
4049 $pt->category_slug = $cat->slug;
4050 }
4051 if (!isset($pt->age_min)) {
4052 $pt->age_min = $cat->age_min ? (int) $cat->age_min : null;
4053 }
4054 if (!isset($pt->age_max)) {
4055 $pt->age_max = $cat->age_max ? (int) $cat->age_max : null;
4056 }
4057 }
4058 }
4059 unset($pt);
4060 }
4061 }
4062
4063 foreach ($price_types as $pt) {
4064 $pt->effective_price = $pt->effective_price ?? \Yatra\Services\TripPricingService::resolveCategoryEffectivePrice((array) $pt);
4065 }
4066
4067 if (apply_filters('yatra_dynamic_pricing_enabled', false)) {
4068 $spots_remaining = $availability ? (int) ($availability->spots_remaining ?? null) : null;
4069
4070 foreach ($price_types as $pt) {
4071 if (!isset($pt->effective_price)) {
4072 continue;
4073 }
4074 $price_before = $pt->effective_price;
4075 $pt_orig = (float) ($pt->original_price ?? 0);
4076 $pt->effective_price = apply_filters('yatra_trip_display_price', (float) $pt->effective_price, $trip_id, [
4077 'departure_date' => $travel_date ?: null,
4078 'spots_remaining' => $spots_remaining,
4079 'availability_id' => $availability_id,
4080 'price_type_id' => $pt->id ?? ($pt->price_type_id ?? null),
4081 'original_price' => $pt_orig > 0 ? $pt_orig : (float) $price_before,
4082 'discounted_price' => (float) $price_before,
4083 ]);
4084 }
4085 }
4086
4087 $is_traveler_based = $resolved_pricing_type === 'traveler_based' && !empty($price_types);
4088
4089 // Base trip price via centralized TripPricingService (single source of truth)
4090 $base_trip_price = \Yatra\Services\TripPricingService::resolveRegularCurrentPrice($trip);
4091
4092 // Override with availability pricing if available
4093 if ($availability) {
4094 $avail_price = !empty($availability->discounted_price) && (float) $availability->discounted_price > 0
4095 ? (float) $availability->discounted_price
4096 : (!empty($availability->original_price) && (float) $availability->original_price > 0
4097 ? (float) $availability->original_price : 0);
4098 if ($avail_price > 0) {
4099 $base_trip_price = $avail_price;
4100 }
4101 }
4102
4103 // Apply dynamic pricing filter (Pro DynamicPricingModule hooks here)
4104 if (apply_filters('yatra_dynamic_pricing_enabled', false)) {
4105 $list_for_dp = (float) ($trip->original_price ?? 0);
4106 if ($availability) {
4107 $ao = (float) ($availability->original_price ?? 0);
4108 if ($ao > 0) {
4109 $list_for_dp = $ao;
4110 }
4111 }
4112 $pre_dp_effective = (float) $base_trip_price;
4113 $base_trip_price = apply_filters('yatra_booking_trip_price', $base_trip_price, $trip_id, [
4114 'departure_date' => $travel_date,
4115 'spots_remaining' => $availability ? (int) ($availability->spots_remaining ?? null) : null,
4116 'availability_id' => $availability_id,
4117 'original_price' => $list_for_dp > 0 ? $list_for_dp : $pre_dp_effective,
4118 'discounted_price' => $pre_dp_effective,
4119 ]);
4120 }
4121
4122 // Calculate subtotals per category
4123 $category_breakdown = [];
4124 $subtotal = 0;
4125 $total_travelers = 0;
4126 $normalized_traveler_counts = [];
4127 if (!empty($traveler_counts) && is_array($traveler_counts)) {
4128 foreach ($traveler_counts as $k => $v) {
4129 $key = is_numeric($k) ? (int) $k : (string) $k;
4130 $normalized_traveler_counts[$key] = (int) $v;
4131 }
4132 }
4133
4134 if ($is_traveler_based && !empty($normalized_traveler_counts)) {
4135 foreach ($price_types as $pt) {
4136 $category_id = $pt->category_id;
4137 $count = (int) ($normalized_traveler_counts[(int) $category_id] ?? ($normalized_traveler_counts[(string) $category_id] ?? 0));
4138 if ($count > 0) {
4139 // Single source of truth for the line amount (per-person ×
4140 // count, flat per-group, or per-block group pricing).
4141 $pt_pricing_mode = $pt->pricing_mode ?? 'per_person';
4142 $category_subtotal = \Yatra\Services\TripPricingService::categoryLineSubtotal($pt, $count, (float) $pt->effective_price);
4143 $category_breakdown[] = [
4144 'category_id' => $category_id,
4145 'label' => $pt->category_label ?? __('Traveler', 'yatra'),
4146 'count' => $count,
4147 'price' => (float) $pt->effective_price,
4148 'subtotal' => $category_subtotal,
4149 'pricing_mode' => $pt_pricing_mode,
4150 // Carry the group-size knobs so the reconciliation pass
4151 // below can re-derive the same per-block/flat subtotal.
4152 'max_pax' => isset($pt->max_pax) && $pt->max_pax !== null && $pt->max_pax !== '' ? (int) $pt->max_pax : null,
4153 'group_overflow' => $pt->group_overflow ?? 'block',
4154 ];
4155 $subtotal += $category_subtotal;
4156 $total_travelers += $count;
4157 }
4158 }
4159 } else {
4160 // Regular pricing
4161 $total_travelers = array_sum(array_map('intval', $normalized_traveler_counts));
4162 // If traveler_counts is empty, fallback to session 'travelers' count
4163 if ($total_travelers < 1) {
4164 $total_travelers = !empty($session['travelers']) ? (int) $session['travelers'] : 1;
4165 }
4166 $price_per_person = $base_trip_price;
4167 $subtotal = $price_per_person * $total_travelers;
4168
4169 }
4170
4171 // Calculate group discount
4172 $discountService = new \Yatra\Services\DiscountService();
4173 $travelerCountsForDiscount = [];
4174 if ($is_traveler_based) {
4175 foreach ($normalized_traveler_counts as $k => $v) {
4176 if (is_numeric($k)) {
4177 $travelerCountsForDiscount[(int) $k] = (int) $v;
4178 }
4179 }
4180 }
4181 if (empty($travelerCountsForDiscount)) {
4182 $travelerCountsForDiscount['default'] = $total_travelers;
4183 }
4184
4185 $priceTypesForDiscount = [];
4186 if ($is_traveler_based) {
4187 foreach ($price_types as $pt) {
4188 $pt = (array) $pt;
4189 // Keep pricing_mode / max_pax / group_overflow so the group
4190 // discount base honours flat and per-block group pricing
4191 // (not just category_id + effective_price).
4192 $pt['effective_price'] = $pt['effective_price'] ?? \Yatra\Services\TripPricingService::resolveCategoryEffectivePrice($pt);
4193 $priceTypesForDiscount[] = $pt;
4194 }
4195 } else {
4196 $priceTypesForDiscount[] = [
4197 'category_id' => 'default',
4198 'effective_price' => $base_trip_price,
4199 ];
4200 }
4201
4202 $group_discount = $discountService->calculateGroupDiscount($trip_id, $travelerCountsForDiscount, $priceTypesForDiscount);
4203 $group_discount_amount = $group_discount['amount'] ?? 0;
4204 $group_discount_label = $group_discount['label'] ?? __('Group Discount', 'yatra');
4205 $group_discount_code = $group_discount['code'] ?? null;
4206
4207 // Calculate coupon discount using DiscountService
4208 $coupon_discount_amount = 0;
4209 $coupon_discount_label = '';
4210 $coupon_error = '';
4211
4212 if (!empty($coupon_code)) {
4213 $discountService = new \Yatra\Services\DiscountService();
4214 $subtotal_after_group = $subtotal - $group_discount_amount;
4215
4216 $coupon_result = $discountService->calculateCouponDiscount(
4217 $coupon_code,
4218 $subtotal_after_group,
4219 $trip_id,
4220 $total_travelers,
4221 $is_traveler_based ? $normalized_traveler_counts : []
4222 );
4223
4224 if ($coupon_result['calculated_amount'] > 0) {
4225 $coupon_discount_amount = $coupon_result['calculated_amount'];
4226 $coupon_discount_label = $coupon_result['label'];
4227 } else {
4228 $coupon_error = __('This coupon is not valid for your booking.', 'yatra');
4229 }
4230 }
4231
4232 // Use CalculationService for on-demand pricing calculation
4233 $calculationService = new CalculationService();
4234
4235 // The selected-service ids the customer just submitted live in
4236 // `$selected_service_ids_from_request` (line ~2635). The previous
4237 // version of this method initialised a fresh `$additional_services
4238 // = []` here and passed that empty list into calculateFromSession
4239 // — which made the Pro AdditionalServicesModule's
4240 // `addServicesToSubtotal` hook bail out at its `empty($selectedServiceIds)`
4241 // guard, so every AJAX summary refresh wiped services out of the
4242 // Trip Subtotal even though the sidebar still rendered the rows.
4243 // Pass the real selected ids instead so CalculationService →
4244 // Pro filter chain folds them into `$subtotal` correctly.
4245 $additional_services = is_array($selected_service_ids_from_request)
4246 ? array_values(array_map('intval', $selected_service_ids_from_request))
4247 : [];
4248
4249 // Create session-like data structure for calculation (trip data fetched from database)
4250 $session_like_data = [
4251 'trip_id' => $trip_id,
4252 'travelers' => $total_travelers,
4253 'traveler_counts' => $traveler_counts,
4254 'travel_date' => $travel_date,
4255 'departure_time' => $departure_time,
4256 'additional_services' => $additional_services
4257 ];
4258
4259 // Apply filter for pro plugins to modify summary calculation parameters
4260 $calculation_params = apply_filters('yatra_summary_calculation_params', [
4261 'session_data' => $session_like_data,
4262 'coupon_code' => $coupon_code,
4263 'payment_method' => $payment_method,
4264 ]);
4265
4266 $pricing = $calculationService->calculateFromSession(
4267 $calculation_params['session_data'],
4268 $calculation_params['coupon_code'],
4269 $calculation_params['payment_method']
4270 );
4271
4272 $total_amount = $pricing['final_total'];
4273 $amount_due = $pricing['amount_due'];
4274 $tax_calculation = $pricing['tax_calculation'];
4275 $total_tax_amount = $pricing['tax_calculation']['total_tax_amount'];
4276 $tax_inclusive = $pricing['tax_calculation']['tax_inclusive'];
4277 $tax_breakdown = $pricing['tax_calculation']['tax_breakdown'];
4278
4279 // ── Reconcile per-category display prices with CalculationService ─
4280 //
4281 // The $category_breakdown computed above (~line 3358) used a SEPARATE
4282 // DP filter pass (~line 3290) that's gated on yatra_dynamic_pricing_enabled.
4283 // In certain AJAX-recompute contexts (e.g. switching payment_method)
4284 // that loop could miss DP — for example when a stored availability
4285 // row's price_types already had a pre-DP effective_price baked in,
4286 // or when a date-sensitive DP rule didn't fire because the request
4287 // didn't carry the same departure_date context.
4288 //
4289 // CalculationService is the single source of truth for booking math;
4290 // it already computed the correct post-DP per-category prices and
4291 // returned them as `category_prices_post_dp` (keyed by string
4292 // category_id). Reconcile the display breakdown against that map so
4293 // "Adult x 8 ($131.12 x 8)" can never disagree with the Trip
4294 // Subtotal the rest of the page is built from.
4295 if (!empty($category_breakdown) && !empty($pricing['category_prices_post_dp']) && is_array($pricing['category_prices_post_dp'])) {
4296 $catPricesPostDp = $pricing['category_prices_post_dp'];
4297 $reconciledSubtotal = 0.0;
4298 foreach ($category_breakdown as &$cat) {
4299 $cid = isset($cat['category_id']) ? (string) $cat['category_id'] : '';
4300 if ($cid !== '' && array_key_exists($cid, $catPricesPostDp)) {
4301 $authoritativePrice = (float) $catPricesPostDp[$cid];
4302 $count = (int) ($cat['count'] ?? 0);
4303 $cat['price'] = $authoritativePrice;
4304 // Re-derive the line amount from the authoritative post-DP
4305 // price using the same rule as the charge (flat per-group,
4306 // per-block, or per-person × count).
4307 $cat['subtotal'] = \Yatra\Services\TripPricingService::categoryLineSubtotal($cat, $count, $authoritativePrice);
4308 }
4309 $reconciledSubtotal += (float) ($cat['subtotal'] ?? 0);
4310 }
4311 unset($cat);
4312 // Keep the top-level $subtotal in sync with the reconciled
4313 // breakdown so any downstream renderers that read it (instead
4314 // of $pricing['base_amount']) still see consistent numbers.
4315 if ($reconciledSubtotal > 0) {
4316 $subtotal = $reconciledSubtotal;
4317 }
4318 }
4319
4320 /**
4321 * Filter: Get additional services for this trip
4322 * Allows premium modules to add extra services to the booking summary
4323 *
4324 * @param array $services Empty array by default
4325 * @param int $trip_id The trip ID
4326 * @param int $total_travelers Total number of travelers
4327 * @param array $traveler_counts Traveler counts by category
4328 * @param string $travel_date The travel date
4329 * @since 3.0.0
4330 */
4331 $additional_services = apply_filters('yatra_booking_additional_services', [], $trip_id, $total_travelers, $traveler_counts, $travel_date);
4332
4333 // Get selected services from request (priority) or session
4334 // If request has additional_services, use that; otherwise fall back to session
4335 if ($selected_service_ids_from_request !== null) {
4336 $selected_service_ids = $selected_service_ids_from_request;
4337 } else {
4338 $selected_service_ids = isset($existing_session['additional_services']) && is_array($existing_session['additional_services'])
4339 ? array_map('intval', $existing_session['additional_services'])
4340 : [];
4341 }
4342
4343 // Mark which services are selected and calculate their price based on price_per
4344 $duration_days = (int) ($trip->duration_days ?? 1);
4345 $default_services_total = 0.0;
4346 foreach ($additional_services as &$service) {
4347 $serviceId = (int) $service['id'];
4348 $isInRequest = in_array($serviceId, $selected_service_ids, true);
4349 $isRequired = !empty($service['is_required']);
4350 $isIncluded = !empty($service['is_included']);
4351 $service['selected'] = $isInRequest || $isRequired || $isIncluded;
4352
4353 // Calculate the price based on price_per (person, day, booking)
4354 $basePrice = (float) ($service['price'] ?? 0);
4355 $pricePer = $service['price_per'] ?? 'person';
4356
4357 switch ($pricePer) {
4358 case 'person':
4359 $service['calculated_price'] = $basePrice * $total_travelers;
4360 break;
4361 case 'day':
4362 $service['calculated_price'] = $basePrice * max(1, $duration_days);
4363 break;
4364 case 'booking':
4365 default:
4366 $service['calculated_price'] = $basePrice;
4367 break;
4368 }
4369
4370 if (!empty($service['selected']) && empty($service['is_included'])) {
4371 $default_services_total += (float) $service['calculated_price'];
4372 }
4373 }
4374 unset($service);
4375
4376 /**
4377 * Filter: Calculate additional services total
4378 * Allows premium modules to add services cost to the booking total
4379 *
4380 * @param float $services_total The services total (0 by default)
4381 * @param array $additional_services The services with 'selected' flag
4382 * @param int $trip_id The trip ID
4383 * @param int $total_travelers Total number of travelers
4384 * @param int $duration_days Trip duration in days
4385 * @since 3.0.0
4386 */
4387 $services_total = apply_filters('yatra_booking_services_total', (float) $default_services_total, $additional_services, $trip_id, $total_travelers, (int) ($trip->duration_days ?? 1));
4388
4389 // Get itinerary costs (separate from additional services)
4390 $itinerary_costs = apply_filters('yatra_booking_itinerary_costs', [], $trip_id, $total_travelers, $traveler_counts, $travel_date);
4391 $itinerary_costs_total = 0.0;
4392
4393 foreach ($itinerary_costs as $cost) {
4394 $basePrice = (float) ($cost['price'] ?? 0);
4395 $pricePer = $cost['price_per'] ?? 'person';
4396
4397 switch ($pricePer) {
4398 case 'person':
4399 $calculatedPrice = $basePrice * $total_travelers;
4400 break;
4401 case 'day':
4402 $calculatedPrice = $basePrice * $duration_days;
4403 break;
4404 case 'booking':
4405 default:
4406 $calculatedPrice = $basePrice;
4407 break;
4408 }
4409
4410 $itinerary_costs_total += $calculatedPrice;
4411 }
4412
4413 // Note: CalculationService already includes itinerary costs in final_total
4414 // No need to add itinerary_costs_total again - it's already included in $total_amount
4415
4416 // Calculate due amount based on payment method.
4417 //
4418 // Flow: compute a sensible default using the *percentage* filters (which
4419 // Pro can already override per-trip via trip.deposit_percentage), then
4420 // hand off to `yatra_calculate_amount_due` so Pro can apply absolute
4421 // overrides too (e.g. trip.deposit_amount as a fixed cap). Doing both
4422 // keeps the math consistent with CalculationService::calculatePaymentAmounts().
4423 $context = ['trip_id' => $trip_id];
4424 $flexible_payments_enabled = apply_filters('yatra_flexible_payments_enabled', false);
4425 $deposit_percentage = (int) apply_filters('yatra_deposit_percentage', 20, $context);
4426 $partial_percentage = (int) apply_filters('yatra_partial_payment_percentage', 30, $context);
4427
4428 $amount_due = $total_amount;
4429 if ($payment_method === 'deposit') {
4430 $amount_due = $total_amount * ($deposit_percentage / 100);
4431 } elseif ($payment_method === 'partial') {
4432 $amount_due = $total_amount * ($partial_percentage / 100);
4433 }
4434
4435 $amount_due = (float) apply_filters(
4436 'yatra_calculate_amount_due',
4437 $amount_due,
4438 $total_amount,
4439 $payment_method,
4440 $context
4441 );
4442
4443 Logger::debug('Yatra booking summary: payment method and amount due', [
4444 'context' => 'booking_summary_rest',
4445 'trip_id' => $trip_id,
4446 'flexible_payments_enabled' => $flexible_payments_enabled,
4447 'payment_method' => $payment_method,
4448 'total_amount' => round($total_amount, 4),
4449 'amount_due' => round($amount_due, 4),
4450 'deposit_percentage' => $deposit_percentage,
4451 'partial_percentage' => $partial_percentage,
4452 ]);
4453
4454 // Build pricing HTML for the summary section (using CalculationService data)
4455 $pricing_html = $this->buildPricingHtml([
4456 'is_traveler_based' => $is_traveler_based,
4457 'category_breakdown' => $category_breakdown,
4458 'price_per_person' => $price_per_person ?? $base_trip_price,
4459 'total_travelers' => $total_travelers,
4460 'gross_total' => $pricing['gross_total'] ?? $pricing['base_amount'],
4461 'subtotal' => $pricing['gross_total'] ?? $pricing['base_amount'],
4462 'taxable_amount' => $pricing['taxable_amount'] ?? 0,
4463 'group_discount_amount' => $pricing['group_discount']['amount'] ?? 0,
4464 'group_discount_label' => $pricing['group_discount']['label'] ?? '',
4465 'coupon_discount_amount' => $pricing['coupon_discount']['calculated_amount'] ?? 0,
4466 'coupon_discount_label' => $pricing['coupon_discount']['label'] ?? '',
4467 'coupon_code' => $pricing['coupon_discount']['code'] ?? '',
4468 'additional_services' => $additional_services,
4469 'services_total' => $services_total,
4470 'itinerary_costs' => $itinerary_costs,
4471 'itinerary_costs_total' => $itinerary_costs_total,
4472 'total_amount' => $total_amount,
4473 'amount_due' => $amount_due,
4474 'payment_method' => $payment_method,
4475 'deposit_percentage' => $deposit_percentage,
4476 'partial_percentage' => $partial_percentage,
4477 // Tax variables from centralized calculation
4478 'enable_tax' => $pricing['tax_calculation']['enable_tax'],
4479 'tax_breakdown' => $pricing['tax_calculation']['tax_breakdown'],
4480 'total_tax_amount' => $pricing['tax_calculation']['total_tax_amount'],
4481 'tax_inclusive' => $pricing['tax_calculation']['tax_inclusive'],
4482 // Dynamic-pricing data — without these, the AJAX-refreshed summary
4483 // would never carry the DP line items even though CalculationService
4484 // produces them on every recalculation.
4485 'dynamic_pricing' => $pricing['dynamic_pricing'] ?? null,
4486 'unit_price_before_dp' => $pricing['unit_price_before_dp'] ?? null,
4487 'dp_total_adjustment' => $pricing['dp_total_adjustment'] ?? 0,
4488 // Authoritative post-DP per-category map. Checkout::getCategoryBreakdown
4489 // prefers this over the session's $pt->effective_price (which can be
4490 // pre-DP after a stored availability row's price_types come in
4491 // pre-baked), so forwarding it here is what keeps the AJAX-rendered
4492 // "Adult x N ($X x N)" row in sync with the actual Trip Subtotal.
4493 'category_prices_post_dp' => $pricing['category_prices_post_dp'] ?? [],
4494 // Currency for consistent formatting
4495 'currency' => $pricing['currency'] ?? \Yatra\Services\SettingsService::getCurrency(),
4496 ]);
4497
4498 // Build response
4499 return new WP_REST_Response([
4500 'success' => true,
4501 'data' => [
4502 'is_traveler_based' => $is_traveler_based,
4503 'category_breakdown' => $category_breakdown,
4504 'subtotal' => round($subtotal, 2),
4505 'subtotal_formatted' => yatra_format_price($subtotal),
4506 'total_travelers' => $total_travelers,
4507 'group_discount' => $group_discount ? [
4508 'amount' => round($group_discount_amount, 2),
4509 'amount_formatted' => yatra_format_price($group_discount_amount),
4510 'label' => $group_discount_label,
4511 'code' => $group_discount_code,
4512 'applied_categories' => $group_discount['applied_categories'] ?? [],
4513 ] : null,
4514 'coupon_discount' => $coupon_discount_amount > 0 ? [
4515 'amount' => round($coupon_discount_amount, 2),
4516 'amount_formatted' => yatra_format_price($coupon_discount_amount),
4517 'label' => $coupon_discount_label,
4518 'code' => $coupon_code,
4519 ] : null,
4520 'coupon_error' => $coupon_error,
4521 'total_discount' => round($group_discount_amount + $coupon_discount_amount, 2),
4522 'total_discount_formatted' => yatra_format_price($group_discount_amount + $coupon_discount_amount),
4523 // Additional services (premium feature)
4524 'additional_services' => $additional_services,
4525 'services_total' => round($services_total, 2),
4526 'services_total_formatted' => yatra_format_price($services_total),
4527 // Itinerary costs (separate from services)
4528 'itinerary_costs' => $itinerary_costs,
4529 'itinerary_costs_total' => round($itinerary_costs_total, 2),
4530 'itinerary_costs_total_formatted' => yatra_format_price($itinerary_costs_total),
4531 'total_amount' => round($total_amount, 2),
4532 'total_amount_formatted' => yatra_format_price($total_amount),
4533 'amount_due' => round($amount_due, 2),
4534 'amount_due_formatted' => yatra_format_price($amount_due),
4535 'deposit_percentage' => $deposit_percentage,
4536 'partial_percentage' => $partial_percentage,
4537 // HTML for the pricing section
4538 'pricing_html' => $pricing_html,
4539 ],
4540 ]);
4541 }
4542
4543 /**
4544 * Build HTML for the pricing summary section
4545 * This is returned via AJAX to update the pricing breakdown dynamically
4546 * Uses the pricing-summary.php template for rendering with Checkout model
4547 */
4548 private function buildPricingHtml(array $data): string
4549 {
4550 // Get session data to create Checkout model
4551 yatra_start_session();
4552 $session = yatra_get_booking_session();
4553
4554 // Get trip data
4555 $trip_id = (int) ($session['trip_id'] ?? 0);
4556 if (empty($trip_id)) {
4557 return '<p>' . __('Pricing information not available.', 'yatra') . '</p>';
4558 }
4559
4560 $tripRepository = new \Yatra\Repositories\TripRepository();
4561 $trip = $tripRepository->findPublished($trip_id);
4562 if (!$trip) {
4563 return '<p>' . __('Trip not found.', 'yatra') . '</p>';
4564 }
4565
4566 // Build pricing calculation array from data (centralized pricing)
4567 $resolvedCurrentPrice = \Yatra\Services\TripPricingService::resolveRegularCurrentPrice($trip);
4568 $pricingCalculation = [
4569 'original_price' => $trip->original_price ?? 0,
4570 'discounted_price' => $resolvedCurrentPrice,
4571 'unit_price' => $data['price_per_person'] ?? $resolvedCurrentPrice,
4572 'pricing_type' => $session['pricing_type'] ?? 'regular',
4573 'base_amount' => $data['gross_total'] ?? 0,
4574 'subtotal' => $data['subtotal'] ?? $data['gross_total'] ?? 0,
4575 'taxable_amount' => $data['taxable_amount'] ?? 0,
4576 'gross_total' => $data['gross_total'] ?? 0,
4577 'final_total' => $data['total_amount'] ?? 0,
4578 'amount_due' => $data['amount_due'] ?? 0,
4579 'travelers_count' => $data['total_travelers'] ?? 1,
4580 'is_traveler_based' => $data['is_traveler_based'] ?? false,
4581 'category_breakdown' => $data['category_breakdown'] ?? [],
4582 'group_discount' => [
4583 'amount' => $data['group_discount_amount'] ?? 0,
4584 'label' => $data['group_discount_label'] ?? '',
4585 ],
4586 'coupon_discount' => [
4587 'code' => $data['coupon_code'] ?? '',
4588 'calculated_amount' => $data['coupon_discount_amount'] ?? 0,
4589 'label' => $data['coupon_discount_label'] ?? '',
4590 ],
4591 'total_discount_amount' => ($data['group_discount_amount'] ?? 0) + ($data['coupon_discount_amount'] ?? 0),
4592 'additional_services' => $data['additional_services'] ?? [],
4593 'services_total' => $data['services_total'] ?? 0,
4594 'itinerary_costs' => $data['itinerary_costs'] ?? [],
4595 'itinerary_costs_total' => $data['itinerary_costs_total'] ?? 0,
4596 'tax_calculation' => [
4597 'enable_tax' => $data['enable_tax'] ?? false,
4598 'tax_breakdown' => $data['tax_breakdown'] ?? [],
4599 'total_tax_amount' => $data['total_tax_amount'] ?? 0,
4600 'tax_inclusive' => $data['tax_inclusive'] ?? false,
4601 ],
4602 // Dynamic-pricing breakdown — without this, the AJAX-refreshed
4603 // sidebar would never show DP line items even though the page-load
4604 // path does. Keys match CalculationService's pricing_data shape so
4605 // Checkout::getDynamicPricing() returns identical results in both
4606 // render contexts.
4607 'dynamic_pricing' => $data['dynamic_pricing'] ?? null,
4608 'unit_price_before_dp' => $data['unit_price_before_dp'] ?? null,
4609 'dp_total_adjustment' => $data['dp_total_adjustment'] ?? 0,
4610 // Authoritative post-DP per-category prices. Checkout::getCategoryBreakdown
4611 // keys off this to override the (potentially stale / pre-DP)
4612 // $pt->effective_price coming from session price_types — without
4613 // it, the AJAX recompute renders pre-DP rows while the rest of
4614 // the summary uses the post-DP base amount.
4615 'category_prices_post_dp' => $data['category_prices_post_dp'] ?? [],
4616 'currency' => $data['currency'] ?? null,
4617 ];
4618
4619 // Update session with payment method if provided
4620 if (!empty($data['payment_method'])) {
4621 $session['payment_method'] = $data['payment_method'];
4622 }
4623 if (!empty($data['deposit_percentage'])) {
4624 $session['deposit_percentage'] = $data['deposit_percentage'];
4625 }
4626 if (!empty($data['partial_payment_percentage'])) {
4627 $session['partial_payment_percentage'] = $data['partial_payment_percentage'];
4628 }
4629 if (!empty($data['partial_percentage'])) {
4630 $session['partial_payment_percentage'] = $data['partial_percentage'];
4631 }
4632
4633 if (!empty($data['payment_method']) || !empty($data['deposit_percentage']) || !empty($data['partial_percentage']) || !empty($data['partial_payment_percentage'])) {
4634 yatra_set_booking_session($session);
4635 }
4636
4637 // Create Checkout model instance
4638 $checkout = new \Yatra\Models\Checkout($trip, $session, $pricingCalculation);
4639
4640 // Surface dynamic-pricing breakdown to the template scope. The partial
4641 // reads `$dynamic_pricing` for the DP block; the page-load path
4642 // already sets this in booking-content.php.
4643 $dynamic_pricing = $pricingCalculation['dynamic_pricing'] ?? null;
4644 $currency = $pricingCalculation['currency'] ?? null;
4645
4646 // Load the template (uses $checkout model)
4647 $template_path = YATRA_PLUGIN_PATH . 'templates/partials/pricing-summary.php';
4648
4649 if (!file_exists($template_path)) {
4650 return '<p>' . __('Template not found.', 'yatra') . '</p>';
4651 }
4652
4653 // Use output buffering to capture the template output
4654 ob_start();
4655 include $template_path;
4656 return ob_get_clean();
4657 }
4658
4659 /**
4660 * Remove coupon code from booking session
4661 */
4662 public function remove_coupon(WP_REST_Request $request): WP_REST_Response
4663 {
4664 yatra_start_session();
4665
4666 $data = $request->get_json_params() ?? [];
4667
4668 // M-2: restore CSRF protection stripped by public_permission_callback.
4669 if (($blocked = $this->guardPublicBookingMutation($request, $data)) !== null) {
4670 return $blocked;
4671 }
4672
4673 $session = yatra_get_booking_session();
4674
4675 // Same booking_token rehydration as apply_coupon — handle REST
4676 // requests that arrive without a propagated PHPSESSID.
4677 if (empty($session) || empty($session['trip_id'])) {
4678 $token = null;
4679 if (!empty($data['booking_token']) && is_string($data['booking_token'])) {
4680 $token = sanitize_text_field((string) $data['booking_token']);
4681 } elseif (isset($_GET['booking_token']) && is_string($_GET['booking_token'])) {
4682 $token = sanitize_text_field((string) wp_unslash($_GET['booking_token']));
4683 }
4684 if ($token) {
4685 $transient_data = get_transient($token);
4686 if (is_array($transient_data) && !empty($transient_data['trip_id'])) {
4687 $session = $transient_data;
4688 $_SESSION['yatra_booking'] = $session;
4689 $_SESSION['yatra_booking_token'] = $token;
4690 }
4691 }
4692 }
4693
4694 if (empty($session)) {
4695 return new WP_REST_Response([
4696 'success' => false,
4697 'message' => __('No active booking session found.', 'yatra'),
4698 ], 400);
4699 }
4700
4701 // Remove coupon directly from session to avoid array_merge issues
4702 if (isset($_SESSION['yatra_booking']['coupon'])) {
4703 unset($_SESSION['yatra_booking']['coupon']);
4704 }
4705 $_SESSION['yatra_booking']['timestamp'] = time();
4706
4707 // Also update local session array for calculation
4708 unset($session['coupon']);
4709 $session['timestamp'] = time();
4710
4711 // Persist the coupon removal to the transient too — without this,
4712 // the next /booking/summary AJAX (which the JS calls right after
4713 // this endpoint) re-reads the still-couponed transient and the
4714 // sidebar shows the coupon discount as if it never went away.
4715 // `yatra_set_booking_session()` array_merges `$_SESSION['yatra_booking']`
4716 // (already coupon-less above) with the passed data and writes the
4717 // result into the transient keyed by the existing booking token.
4718 yatra_set_booking_session($session);
4719
4720 // Ensure session data is written immediately
4721 if (session_status() === PHP_SESSION_ACTIVE) {
4722 session_write_close();
4723 }
4724
4725 $total_amount = $this->calculateSessionTotal($session);
4726
4727 return new WP_REST_Response([
4728 'success' => true,
4729 'message' => __('Coupon removed.', 'yatra'),
4730 'data' => [
4731 'new_total' => $total_amount,
4732 'new_total_formatted' => yatra_format_price($total_amount),
4733 ],
4734 ]);
4735 }
4736
4737 /**
4738 * Calculate total amount from session
4739 * Uses CalculationService to get accurate pricing (without coupon)
4740 */
4741 private function calculateSessionTotal(array $session): float
4742 {
4743 // Use CalculationService to get accurate base pricing
4744 $calculationService = new \Yatra\Services\CalculationService();
4745
4746 try {
4747 // Calculate pricing WITHOUT coupon (we're calculating this to apply coupon to it)
4748 $pricing = $calculationService->calculateFromSession($session, '');
4749
4750 // Return gross_total (base amount before discounts but after any group discounts)
4751 $total = $pricing['gross_total'] ?? 0;
4752
4753 return (float) $total;
4754 } catch (\Throwable $e) {
4755 return 0.0;
4756 }
4757 }
4758
4759 /**
4760 * @deprecated Use DiscountService::calculateCouponDiscount() instead
4761 * Calculate discount amount
4762 */
4763 private function calculateDiscountAmount(\stdClass $discount, float $total, array $session): float
4764 {
4765 $discount_amount = 0;
4766
4767 // Check if group discount applies
4768 if ($discount->is_group_discount && !empty($discount->min_group_size)) {
4769 $travelers = (int) ($session['travelers'] ?? 1);
4770 if ($travelers >= (int) $discount->min_group_size && !empty($discount->group_discount_amount)) {
4771 // Apply group discount
4772 if ($discount->group_discount_type === 'percentage') {
4773 $discount_amount = $total * ((float) $discount->group_discount_amount / 100);
4774 } else {
4775 $discount_amount = (float) $discount->group_discount_amount;
4776 }
4777 }
4778 }
4779
4780 // If no group discount, apply regular discount
4781 if ($discount_amount === 0) {
4782 if ($discount->type === 'percentage') {
4783 $discount_amount = $total * ((float) $discount->amount / 100);
4784 } else {
4785 $discount_amount = (float) $discount->amount;
4786 }
4787 }
4788
4789 // Apply max discount cap if set
4790 if (!empty($discount->max_discount_amount) && $discount_amount > (float) $discount->max_discount_amount) {
4791 $discount_amount = (float) $discount->max_discount_amount;
4792 }
4793
4794 // Ensure discount doesn't exceed total
4795 if ($discount_amount > $total) {
4796 $discount_amount = $total;
4797 }
4798
4799 return round($discount_amount, 2);
4800 }
4801
4802 /**
4803 * Get coupon usage count by user
4804 */
4805 private function getCouponUsageByUser(string $discount_code, int $user_id): int
4806 {
4807 // Use AvailabilityService to check discount code usage
4808 return $this->availabilityService->getDiscountCodeUsage($user_id, strtoupper(sanitize_text_field($discount_code)));
4809 }
4810 }
4811
4812