/**
* Process the IPN. Firstly, we'll hope we put the standard args into the IPN URL so
* we can easily find what registration the IPN is for and what payment method.
* However, if not, we'll give all payment methods a chance to claim it and process it.
* If a payment is found for the IPN info, it is saved.
*
* @param array $_req_data eg $_REQUEST
* @param EE_Transaction|int $transaction optional (or a transactions id)
* @param EE_Payment_Method $payment_method (or a slug or id of one)
* @param boolean $update_txn whether or not to call
* EE_Transaction_Processor::update_transaction_and_registrations_after_checkout_or_payment()
* @param bool $separate_IPN_request whether the IPN uses a separate request ( true like PayPal )
* or is processed manually ( false like Mijireh )
* @throws EE_Error
* @throws Exception
* @return EE_Payment
*/
public function process_ipn($_req_data, $transaction = null, $payment_method = null, $update_txn = true, $separate_IPN_request = true)
{
EE_Registry::instance()->load_model('Change_Log');
$_req_data = $this->_remove_unusable_characters_from_array((array) $_req_data);
EE_Processor_Base::set_IPN($separate_IPN_request);
$obj_for_log = null;
if ($transaction instanceof EE_Transaction) {
$obj_for_log = $transaction;
if ($payment_method instanceof EE_Payment_Method) {
$obj_for_log = EEM_Payment::instance()->get_one(array(array('TXN_ID' => $transaction->ID(), 'PMD_ID' => $payment_method->ID()), 'order_by' => array('PAY_timestamp' => 'desc')));
}
} else {
if ($payment_method instanceof EE_Payment) {
$obj_for_log = $payment_method;
}
}
$log = EEM_Change_Log::instance()->log(EEM_Change_Log::type_gateway, array('IPN data received' => $_req_data), $obj_for_log);
try {
/**
* @var EE_Payment $payment
*/
$payment = NULL;
if ($transaction && $payment_method) {
/** @type EE_Transaction $transaction */
$transaction = EEM_Transaction::instance()->ensure_is_obj($transaction);
/** @type EE_Payment_Method $payment_method */
$payment_method = EEM_Payment_Method::instance()->ensure_is_obj($payment_method);
if ($payment_method->type_obj() instanceof EE_PMT_Base) {
$payment = $payment_method->type_obj()->handle_ipn($_req_data, $transaction);
$log->set_object($payment);
} else {
// not a payment
EE_Error::add_error(sprintf(__('A valid payment method could not be determined due to a technical issue.%sPlease refresh your browser and try again or contact %s for assistance.', 'event_espresso'), '<br/>', EE_Registry::instance()->CFG->organization->get_pretty('email')), __FILE__, __FUNCTION__, __LINE__);
}
} else {
//that's actually pretty ok. The IPN just wasn't able
//to identify which transaction or payment method this was for
// give all active payment methods a chance to claim it
$active_payment_methods = EEM_Payment_Method::instance()->get_all_active();
foreach ($active_payment_methods as $active_payment_method) {
try {
$payment = $active_payment_method->type_obj()->handle_unclaimed_ipn($_req_data);
$payment_method = $active_payment_method;
EEM_Change_Log::instance()->log(EEM_Change_Log::type_gateway, array('IPN data' => $_req_data), $payment);
break;
} catch (EE_Error $e) {
//that's fine- it apparently couldn't handle the IPN
}
}
}
// EEM_Payment_Log::instance()->log("got to 7",$transaction,$payment_method);
if ($payment instanceof EE_Payment) {
$payment->save();
// update the TXN
$this->update_txn_based_on_payment($transaction, $payment, $update_txn, $separate_IPN_request);
} else {
//we couldn't find the payment for this IPN... let's try and log at least SOMETHING
if ($payment_method) {
EEM_Change_Log::instance()->log(EEM_Change_Log::type_gateway, array('IPN data' => $_req_data), $payment_method);
} elseif ($transaction) {
EEM_Change_Log::instance()->log(EEM_Change_Log::type_gateway, array('IPN data' => $_req_data), $transaction);
}
}
return $payment;
} catch (EE_Error $e) {
do_action('AHEE__log', __FILE__, __FUNCTION__, sprintf(__('Error occurred while receiving IPN. Transaction: %1$s, req data: %2$s. The error was "%3$s"', 'event_espresso'), print_r($transaction, TRUE), print_r($_req_data, TRUE), $e->getMessage()));
throw $e;
}
}
/**
* @param boolean $IPN
*/
public static function set_IPN($IPN)
{
self::$IPN = filter_var($IPN, FILTER_VALIDATE_BOOLEAN);
}
