# yatra/3.0.15/app/Services/NotificationService.php

Yatra – Travel Booking & Tour Operator Software, version 3.0.15. 214 lines.

- Page: https://pluginprobe.com/plugins/yatra/3.0.15/code/app/Services/NotificationService.php
- Raw: https://pluginprobe.com/plugins/yatra/3.0.15/raw/app/Services/NotificationService.php
- Modified: 2026-09-15T11:48:00+00:00

Line numbers below start at 1. Link to a line or a range by appending a fragment to the
page URL, for example `https://pluginprobe.com/plugins/yatra/3.0.15/code/app/Services/NotificationService.php#L10-L20`.

```php
<?php
/**
 * Notification Service
 *
 * Admin / customer emails for booking lifecycle events. Enable/disable and copy are controlled
 * under Yatra → Email → Templates (settings-backed flags), not Settings → Notifications.
 *
 * @package Yatra\Services
 * @since 3.0.0
 */

declare(strict_types=1);

namespace Yatra\Services;

use Yatra\Repositories\BookingRepository;

class NotificationService
{
    /**
     * Send booking created notification (admin: {@see TransactionalEmailTemplateService::TYPE_ADMIN_NEW_BOOKING}).
     */
    public static function sendBookingCreatedNotification(int $bookingId, $bookingData): void
    {
        self::notifyAdminNewBooking($bookingId, $bookingData);
    }

    /**
     * Send payment completed notification (admin + customer templates).
     */
    public static function sendPaymentCompletedNotification(array $paymentData): void
    {
        self::notifyAdminPaymentReceived($paymentData);
        self::notifyCustomerPaymentReceived($paymentData);
    }

    /**
     * Send booking cancellation notification (admin template; customer email uses transactional templates from BookingService).
     */
    public static function sendCancellationNotification(int $bookingId, $bookingData): void
    {
        self::notifyAdminCancellation($bookingId, $bookingData);
    }

    /**
     * Resend just the customer payment-received email (part- or full-payment
     * template, exactly as the automated flow chooses it). Public entry for the
     * admin "resend email" action.
     */
    public static function resendCustomerPaymentEmail(array $paymentData): void
    {
        self::notifyCustomerPaymentReceived($paymentData);
    }

    /**
     * Resend just the admin payment-received notification. Public entry for the
     * admin "resend email" action.
     */
    public static function resendAdminPaymentEmail(array $paymentData): void
    {
        self::notifyAdminPaymentReceived($paymentData);
    }

    /**
     * Notify admin of new booking
     */
    private static function notifyAdminNewBooking(int $bookingId, $bookingData): void
    {
        if (!apply_filters('yatra_notify_admin_new_booking', true, $bookingId, $bookingData)) {
            return;
        }

        $admin_email = SettingsService::getString('admin_email', (string) get_option('admin_email', ''));
        if ($admin_email === '' || !is_email($admin_email)) {
            return;
        }

        $repository = new BookingRepository();
        $booking = $repository->findWithTrip($bookingId);
        if (!$booking) {
            return;
        }

        $adminNotifyContext = [
            'booking_id' => $bookingId,
            'reference' => $booking->reference ?? '',
            'source' => 'yatra_booking_created',
        ];
        if (!apply_filters('yatra_send_checkout_admin_notification', true, $adminNotifyContext)) {
            return;
        }

        $variables = TransactionalEmailTemplateService::variablesFromBooking($booking);

        TransactionalEmailTemplateService::sendIfEnabled(
            TransactionalEmailTemplateService::TYPE_ADMIN_NEW_BOOKING,
            $admin_email,
            $variables
        );
    }

    /**
     * Notify admin of payment received (template: admin_payment_received).
     */
    private static function notifyAdminPaymentReceived(array $paymentData): void
    {
        $admin_email = SettingsService::getString('admin_email', (string) get_option('admin_email', ''));
        if ($admin_email === '' || !is_email($admin_email)) {
            return;
        }

        $bookingRepository = new BookingRepository();
        $booking = $bookingRepository->findWithTrip((int) ($paymentData['booking_id'] ?? 0));
        if (!$booking) {
            return;
        }

        $vars = TransactionalEmailTemplateService::variablesFromBooking($booking);
        $vars['payment_amount_formatted'] = yatra_format_price((float) ($paymentData['amount'] ?? 0));
        $vars['payment_method'] = (string) ($paymentData['payment_method'] ?? __('Online payment', 'yatra'));
        $vars['transaction_id'] = (string) ($paymentData['transaction_id'] ?? '');

        TransactionalEmailTemplateService::sendIfEnabled(
            TransactionalEmailTemplateService::TYPE_ADMIN_PAYMENT_RECEIVED,
            $admin_email,
            $vars
        );
    }

    /**
     * Which payment email to send: the part-payment template or the full one.
     *
     * Defaults to the long-standing single template. The part-payment template
     * is used only when ALL of these hold, so an existing site sees no change
     * until its operator opts in:
     *
     *   1. a balance is genuinely still outstanding on the booking,
     *   2. deposits / partial payments are switched on at all, and
     *   3. the operator has enabled the separate part-payment template —
     *      either the free "Partial Payment Received" toggle, or (Pro Email
     *      Automation) the active "Partial Payment Received" DB template. On a
     *      Pro site the Email → Templates switch only writes the Pro row, so
     *      the free toggle stays at its default and must not be the sole gate.
     */
    private static function paymentTemplateTypeFor(object $booking): string
    {
        $full = TransactionalEmailTemplateService::TYPE_PAYMENT_CONFIRMATION;
        $partial = TransactionalEmailTemplateService::TYPE_PARTIAL_PAYMENT_RECEIVED;

        // Nothing left to pay → this is the full-payment confirmation.
        if ((float) ($booking->amount_due ?? 0) <= 0) {
            return $full;
        }

        if (!yatra_partial_payments_enabled()) {
            return $full;
        }

        $partialEnabled = SettingsService::isEnabled('email_template_partial_payment')
            || (bool) apply_filters('yatra_pro_email_automation_owns_transactional_type', false, $partial);

        return $partialEnabled ? $partial : $full;
    }

    /**
     * Notify customer of payment received
     */
    private static function notifyCustomerPaymentReceived(array $paymentData): void
    {
        $bookingRepository = new BookingRepository();
        $booking = $bookingRepository->findWithTrip((int) ($paymentData['booking_id'] ?? 0));

        if (!$booking || empty($booking->contact_email)) {
            return;
        }

        $vars = TransactionalEmailTemplateService::variablesFromBooking($booking);
        $vars['payment_amount_formatted'] = yatra_format_price((float) ($paymentData['amount'] ?? 0));
        $vars['payment_method'] = (string) ($paymentData['payment_method'] ?? __('Online payment', 'yatra'));
        $vars['transaction_id'] = (string) ($paymentData['transaction_id'] ?? '');

        TransactionalEmailTemplateService::sendIfEnabled(
            self::paymentTemplateTypeFor($booking),
            $booking->contact_email,
            $vars
        );
    }

    /**
     * Notify admin of cancellation
     */
    private static function notifyAdminCancellation(int $bookingId, $bookingData): void
    {
        $admin_email = SettingsService::getString('admin_email', (string) get_option('admin_email', ''));
        if ($admin_email === '' || !is_email($admin_email)) {
            return;
        }

        $repository = new BookingRepository();
        $booking = $repository->findWithTrip($bookingId);
        if (!$booking) {
            return;
        }

        $variables = TransactionalEmailTemplateService::variablesFromBooking($booking);

        TransactionalEmailTemplateService::sendIfEnabled(
            TransactionalEmailTemplateService::TYPE_ADMIN_BOOKING_CANCELLED,
            $admin_email,
            $variables
        );
    }
}

```