/** * get_payment_row_html * * @access public * @param EE_Payment $payment * @return string */ public function get_payment_row_html($payment = NULL) { $html = ''; if ($payment instanceof EE_Payment) { if ($payment->payment_method() instanceof EE_Payment_Method && $payment->payment_method()->is_off_site() && $payment->status() === EEM_Payment::status_id_failed) { // considering the registrant has made it to the Thank You page, // any failed payments may actually be pending and the IPN is just slow // so let's $payment->set_status(EEM_Payment::status_id_pending); } $payment_declined_msg = $payment->STS_ID() === EEM_Payment::status_id_declined ? '<br /><span class="small-text">' . $payment->gateway_response() . '</span>' : ''; $html .= ' <tr> <td> ' . $payment->timestamp() . ' </td> <td> ' . ($payment->payment_method() instanceof EE_Payment_Method ? $payment->payment_method()->name() : __('Unknown', 'event_espresso')) . ' </td> <td class="jst-rght"> ' . EEH_Template::format_currency($payment->amount()) . ' </td> <td class="jst-rght" style="line-height:1;"> ' . $payment->pretty_status(TRUE) . $payment_declined_msg . ' </td> </tr>'; do_action('AHEE__thank_you_page_payment_details_template__after_each_payment', $payment); } return $html; }
/** * This should be called each time there may have been an update to a * payment on a transaction (ie, we asked for a payment to process a * payment for a transaction, or we told a payment method about an IPN, or * we told a payment method to * "finalize_payment_for" (a transaction), or we told a payment method to * process a refund. This should handle firing the correct hooks to * indicate * what exactly happened and updating the transaction appropriately). This * could be integrated directly into EE_Transaction upon save, but we want * this logic to be separate from 'normal' plain-jane saving and updating * of transactions and payments, and to be tied to payment processing. * Note: this method DOES NOT save the payment passed into it. It is the responsibility * of previous code to decide whether or not to save (because the payment passed into * this method might be a temporary, never-to-be-saved payment from an offline gateway, * in which case we only want that payment object for some temporary usage during this request, * but we don't want it to be saved). * * @param EE_Transaction|int $transaction * @param EE_Payment $payment * @param boolean $update_txn * whether or not to call * EE_Transaction_Processor:: * update_transaction_and_registrations_after_checkout_or_payment() * (you can save 1 DB query if you know you're going * to save it later instead) * @param bool $IPN * if processing IPNs or other similar payment * related activities that occur in alternate * requests than the main one that is processing the * TXN, then set this to true to check whether the * TXN is locked before updating * @throws \EE_Error */ public function update_txn_based_on_payment($transaction, $payment, $update_txn = true, $IPN = false) { $do_action = 'AHEE__EE_Payment_Processor__update_txn_based_on_payment__not_successful'; /** @type EE_Transaction $transaction */ $transaction = EEM_Transaction::instance()->ensure_is_obj($transaction); // can we freely update the TXN at this moment? if ($IPN && $transaction->is_locked()) { // don't update the transaction at this exact moment // because the TXN is active in another request EE_Cron_Tasks::schedule_update_transaction_with_payment(time(), $transaction->ID(), $payment->ID()); } else { // verify payment and that it has been saved if ($payment instanceof EE_Payment && $payment->ID()) { if ($payment->payment_method() instanceof EE_Payment_Method && $payment->payment_method()->type_obj() instanceof EE_PMT_Base) { $payment->payment_method()->type_obj()->update_txn_based_on_payment($payment); // update TXN registrations with payment info $this->process_registration_payments($transaction, $payment); } $do_action = $payment->just_approved() ? 'AHEE__EE_Payment_Processor__update_txn_based_on_payment__successful' : $do_action; } else { // send out notifications add_filter('FHEE__EED_Messages___maybe_registration__deliver_notifications', '__return_true'); $do_action = 'AHEE__EE_Payment_Processor__update_txn_based_on_payment__no_payment_made'; } // if this is an IPN, then we want to know the initial TXN status prior to updating the TXN // so that we know whether the status has changed and notifications should be triggered if ($IPN) { /** @type EE_Transaction_Processor $transaction_processor */ $transaction_processor = EE_Registry::instance()->load_class('Transaction_Processor'); $transaction_processor->set_old_txn_status($transaction->status_ID()); } if ($payment->status() !== EEM_Payment::status_id_failed) { /** @type EE_Transaction_Payments $transaction_payments */ $transaction_payments = EE_Registry::instance()->load_class('Transaction_Payments'); // set new value for total paid $transaction_payments->calculate_total_payments_and_update_status($transaction); // call EE_Transaction_Processor::update_transaction_and_registrations_after_checkout_or_payment() ??? if ($update_txn) { $this->_post_payment_processing($transaction, $payment, $IPN); } } // granular hook for others to use. do_action($do_action, $transaction, $payment); do_action('AHEE_log', __CLASS__, __FUNCTION__, $do_action, '$do_action'); //global hook for others to use. do_action('AHEE__EE_Payment_Processor__update_txn_based_on_payment', $transaction, $payment); } }
/** * _build_payment_json_response * * @access public * @param \EE_Payment $payment * @param array $REG_IDs * @param bool | null $delete_txn_reg_status_change * @return array */ protected function _build_payment_json_response(EE_Payment $payment, $REG_IDs = array(), $delete_txn_reg_status_change = null) { // was the payment deleted ? if (is_bool($delete_txn_reg_status_change)) { return array('PAY_ID' => $payment->ID(), 'amount' => $payment->amount(), 'total_paid' => $payment->transaction()->paid(), 'txn_status' => $payment->transaction()->status_ID(), 'pay_status' => $payment->STS_ID(), 'registrations' => $this->_registration_payment_data_array($REG_IDs), 'delete_txn_reg_status_change' => $delete_txn_reg_status_change); } else { $this->_get_payment_status_array(); return array('amount' => $payment->amount(), 'total_paid' => $payment->transaction()->paid(), 'txn_status' => $payment->transaction()->status_ID(), 'pay_status' => $payment->STS_ID(), 'PAY_ID' => $payment->ID(), 'STS_ID' => $payment->STS_ID(), 'status' => self::$_pay_status[$payment->STS_ID()], 'date' => $payment->timestamp('Y-m-d', 'h:i a'), 'method' => strtoupper($payment->source()), 'PM_ID' => $payment->payment_method() ? $payment->payment_method()->ID() : 1, 'gateway' => $payment->payment_method() ? $payment->payment_method()->admin_name() : __("Unknown", 'event_espresso'), 'gateway_response' => $payment->gateway_response(), 'txn_id_chq_nmbr' => $payment->txn_id_chq_nmbr(), 'po_number' => $payment->po_number(), 'extra_accntng' => $payment->extra_accntng(), 'registrations' => $this->_registration_payment_data_array($REG_IDs)); } }