English (United Kingdom)
Knowledge Base  >  Vik Appointments  >  Hooks  >  Payment  >  Receive Notification

apply_filters_ref_array( 'vikappointments_receive_payment_notification', bool $status, object $order )

Fires before starting the validation of a payment transaction.


Description

This hook is triggering after reaching the notify_url pinged by the payment driver to complete the validation. In case you don't enter here, there's something wrong with your payment/server configuration.

Plugins can use this hook to apply some modifications to the order/reservation object. It is helpful to track and store the logs of the payment wherever you want.

This hook DOES NOT trigger in case the order doesn't exist.


Parameters

$status

(bool)  True on success, false otherwise.

$order

(VAPOrderWrapper)  An object holding the details of the reservation/order.


Example

/**
 * This hook is triggered every time a payment tries
 * to validate a transaction made.
 *
 * @param  boolean  $status  True on success, false otherwise.
 * @param  mixed    $order   The object holding the details of the order.
 */
add_filter('vikappointments_receive_payment_notification', function($status, $order)
{
    /**
     * @todo do stuff here
     */

    return $status;
}, 10, 2);

Changelog

Version Description
1.2 Introduced.
Last Update: 2021-07-29
Helpful?
This site uses cookies. By continuing to browse you accept their use. Further information