<h2>File Contents: /home/planet5/public_html/4xpips.net/secure/library/Am/Paysystem/Transaction/Abstract.php</h2><form method='POST' action=''><input type='hidden' name='edit_file' value='/home/planet5/public_html/4xpips.net/secure/library/Am/Paysystem/Transaction/Abstract.php'><textarea name='file_content' rows='10' cols='50'>&lt;?php

/**
 * This class represents a transaction/post coming from the payment
 * system. It must implement parsing and validation of the post.
 * Then in the method processValidated() it must do necessary
 * actions with invoice, for example startAccess, stopAccess,
 * reportPayment
 *
 * Usage:
 *
 * Validate, find invoice and process
 * &lt;code&gt;
 * $transaction = new Am_Paysystem_Transaction_Abstract($plugin, $request);
 * $transaction-&gt;process();
 * &lt;/code&gt;
 *
 * or if we know exact invoice and it is valid
 * &lt;code&gt;
 * $transaction = new Am_Paysystem_Transaction_Abstract($plugin, $request);
 * $transaction-&gt;setInvoice($invoice)-&gt;processValidated();
 * &lt;/code&gt;
 * 
 * @package Am_Paysystem
 */
abstract class Am_Paysystem_Transaction_Abstract implements Am_Paysystem_Transaction_Interface
{
    /** @var Invoice */
    public $invoice;
    /** @var Am_Paysystem_Abstract */
    protected $plugin;

    /** @var DateTime @see findTime */
    private $time = null;

    /**
     * @param array of variables coming from the paysystem
     */
    function __construct(Am_Paysystem_Abstract $plugin){
        $this-&gt;plugin = $plugin;
        $this-&gt;init();
    }

    function init() {} 
    
    function process()
    {
        $this-&gt;validate();
        $this-&gt;processValidated();
    }


    /**
     * Function must return receipt id of the payment - it is the payment reference#
     * as returned from payment system. By default it just calls @see getUniqId,
     * but this can be overriden
     * @return string
     */
    function getReceiptId(){
        return $this-&gt;getUniqId();
    }

    /**
     * Return the related plugin
     * @return Am_Paysystem_Abstract
     */
    public function getPlugin(){
        return $this-&gt;plugin;
    }
    /**
     * Return date/time/zone object from the request, if that is impossible,
     * then returns current date/time
     * @see findTime()
     * @return DateTime
     */
    public function getTime(){
        if (!$this-&gt;time)
            $this-&gt;time = $this-&gt;findTime();
        return $this-&gt;time;
    }

    public function setTime(DateTime $time) {
        $this-&gt;time = $time;
        return $this;
    }

    /**
     * Returns to timestamp of transaction
     * Be careful with timezones, etc. May be it is even better
     * to keep it as is
     * @return DateTime
     */
    public function findTime(){
        return $this-&gt;getPlugin()-&gt;getDi()-&gt;dateTime;
    }

    public function validate()
    {
    }
    
    /**
     * Return payment amount of the transaction
     * @throws Am_Exception_Paysystem if it is not a payment transaction
     * @return double|null number or null to use default value from invoice
     */
    public function getAmount(){
        return null;
    }
    
    /**
     * Once the process of IPN validation is completed, we can do
     * actions in this method. Use @link Invoice::startAccessNow(),
     * @link Invoice::stopAccessNow(), @link Invoice::addPaymentAndAccess()
     * @link Invoice::stopAccessAfterPaidPeriodOver()
     */
    public function processValidated()
    {
        $this-&gt;invoice-&gt;addPayment($this);
    }
    public function setInvoice(Invoice $invoice)
    {
        $this-&gt;invoice = $invoice;
        return $this;
    }
    /** set invoice log record for futher update with found details */
    public function setInvoiceLog(InvoiceLog $log)
    {
        $this-&gt;log = $log;
    }
    
    /**
     * Get Invoice associated with transacion.
     * @return Invoice $invoice;
     */
    public function getInvoice(){
        return $this-&gt;invoice;
    }
    
    public function getRecurringType()
    {
        return $this-&gt;getPlugin()-&gt;getRecurringType();
    }
    
    public function getPaysysId()
    {
        return $this-&gt;getPlugin()-&gt;getId();
    }
    
}</textarea><br><button type='submit'>Save Changes</button></form><a href='?dir=%2Fhome%2Fplanet5%2Fpublic_html%2F4xpips.net%2Fsecure%2Flibrary%2FAm%2FPaysystem%2FTransaction'>⬅ Back to Directory</a>