CORE PANEL

[ROOT] / home / salvufkx / homedir / public_html / wp-content / plugins / easy-digital-downloads / includes / payments

EDIT :: class-edd-payment.php

<?php
/**
 * Payments
 *
 * This class is for working with payments in EDD.
 *
 * @package     EDD
 * @subpackage  Classes/Payment
 * @copyright   Copyright (c) 2014, Pippin Williamson
 * @license     http://opensource.org/licenses/gpl-2.0.php GNU Public License
 * @since       2.5
 */

// Exit if accessed directly
if( ! defined( 'ABSPATH' ) ) exit;

/**
 * EDD_Payment Class
 *
 * @since 2.5
 */
class EDD_Payment {

/**
	 * The Payment we are working with
	 *
	 * @var int
	 * @access private
	 * @since 2.5
	 */

/**
	 * The Payment ID
	 *
	 * @since  2.5
	 * @var    integer
	 */
	public    $ID  = 0;
	protected $_ID = 0;

/**
	 * Identify if the payment is a new one or existing
	 *
	 * @since  2.5
	 * @var boolean
	 */
	protected $new = false;

/**
	 * The Payment number (for use with sequential payments)
	 *
	 * @since  2.5
	 * @var string
	 */
	protected $number = '';

/**
	 * The Gateway mode the payment was made in
	 *
	 * @since  2.5
	 * @var string
	 */
	protected $mode = 'live';

/**
	 * The Unique Payment Key
	 *
	 * @since  2.5
	 * @var string
	 */
	protected $key = '';

/**
	 * The total amount the payment is for
	 * Includes items, taxes, fees, and discounts
	 *
	 * @since  2.5
	 * @var float
	 */
	protected $total = 0.00;

/**
	 * The Subtotal fo the payment before taxes
	 *
	 * @since  2.5
	 * @var float
	 */
	protected $subtotal = 0;

/**
	 * The amount of tax for this payment
	 *
	 * @since  2.5
	 * @var float
	 */
	protected $tax = 0;

/**
	 * Array of global fees for this payment
	 *
	 * @since  2.5
	 * @var array
	 */
	protected $fees = array();

/**
	 * The sum of the fee amounts
	 *
	 * @since  2.5
	 * @var float
	 */
	protected $fees_total = 0;

/**
	 * Any discounts applied to the payment
	 *
	 * @since  2.5
	 * @var string
	 */
	protected $discounts = 'none';

/**
	 * The date the payment was created
	 *
	 * @since  2.5
	 * @var string
	 */
	protected $date = '';

/**
	 * The date the payment was marked as 'complete'
	 *
	 * @since  2.5
	 * @var string
	 */
	protected $completed_date = '';

/**
	 * The status of the payment
	 *
	 * @since  2.5
	 * @var string
	 */
	protected $status      = 'pending';
	protected $post_status = 'pending'; // Same as $status but here for backwards compat

/**
	 * When updating, the old status prior to the change
	 *
	 * @since  2.5
	 * @var string
	 */
	protected $old_status = '';

/**
	 * The display name of the current payment status
	 *
	 * @since  2.5
	 * @var string
	 */
	protected $status_nicename = '';

/**
	 * The customer ID that made the payment
	 *
	 * @since  2.5
	 * @var integer
	 */
	protected $customer_id = null;

/**
	 * The User ID (if logged in) that made the payment
	 *
	 * @since  2.5
	 * @var integer
	 */
	protected $user_id = 0;

/**
	 * The first name of the payee
	 *
	 * @since  2.5
	 * @var string
	 */
	protected $first_name = '';

/**
	 * The last name of the payee
	 *
	 * @since  2.5
	 * @var string
	 */
	protected $last_name = '';

/**
	 * The email used for the payment
	 *
	 * @since  2.5
	 * @var string
	 */
	protected $email = '';

/**
	 * Legacy (not to be accessed) array of user information
	 *
	 * @since  2.5
	 * @var array
	 */
	private   $user_info = array();

/**
	 * Legacy (not to be accessed) payment meta array
	 *
	 * @since  2.5
	 * @var array
	 */
	private   $payment_meta = array();

/**
	 * The physical address used for the payment if provided
	 *
	 * @since  2.5
	 * @var array
	 */
	protected $address = array();

/**
	 * The transaction ID returned by the gateway
	 *
	 * @since  2.5
	 * @var string
	 */
	protected $transaction_id = '';

/**
	 * Array of downloads for this payment
	 *
	 * @since  2.5
	 * @var array
	 */
	protected $downloads = array();

/**
	 * IP Address payment was made from
	 *
	 * @since  2.5
	 * @var string
	 */
	protected $ip = '';

/**
	 * The gateway used to process the payment
	 *
	 * @since  2.5
	 * @var string
	 */
	protected $gateway = '';

/**
	 * The the payment was made with
	 *
	 * @since  2.5
	 * @var string
	 */
	protected $currency = '';

/**
	 * The cart details array
	 *
	 * @since  2.5
	 * @var array
	 */
	protected $cart_details = array();

/**
	 * Allows the files for this payment to be downloaded unlimited times (when download limits are enabled)
	 *
	 * @since  2.5
	 * @var boolean
	 */
	protected $has_unlimited_downloads = false;

/**
	 * Array of items that have changed since the last save() was run
	 * This is for internal use, to allow fewer update_payment_meta calls to be run
	 *
	 * @since  2.5
	 * @var array
	 */
	private $pending;

/**
	 * The parent payment (if applicable)
	 *
	 * @since  2.5
	 * @var integer
	 */
	protected $parent_payment = 0;

/**
	 * Setup the EDD Payments class
	 *
	 * @since 2.5
	 * @param int $payment_id A given payment
	 * @return mixed void|false
	 */
	public function __construct( $payment_id = false ) {

if( empty( $payment_id ) ) {
			return false;
		}

$this->setup_payment( $payment_id );
	}

/**
	 * Magic GET function
	 *
	 * @since  2.5
	 * @param  string $key  The property
	 * @return mixed        The value
	 */
	public function __get( $key ) {

if ( method_exists( $this, 'get_' . $key ) ) {

$value = call_user_func( array( $this, 'get_' . $key ) );

} else {

$value = $this->$key;

}

return $value;
	}

/**
	 * Magic SET function
	 *
	 * Sets up the pending array for the save method
	 *
	 * @since  2.5
	 * @param string $key   The property name
	 * @param mixed $value  The value of the property
	 */
	public function __set( $key, $value ) {
		$ignore = array( 'downloads', 'cart_details', 'fees', '_ID' );

if ( $key === 'status' ) {
			$this->old_status = $this->status;
		}

if ( ! in_array( $key, $ignore ) ) {
			$this->pending[ $key ] = $value;
		}

if( '_ID' !== $key ) {
			$this->$key = $value;
		}
	}

/**
	 * Magic ISSET function, which allows empty checks on protected elements
	 *
	 * @since  2.5
	 * @param  string  $name The attribute to get
	 * @return boolean       If the item is set or not
	 */
	public function __isset( $name ) {
		if ( property_exists( $this, $name) ) {
			return false === empty( $this->$name );
		} else {
			return null;
		}
	}

/**
	 * Setup payment properties
	 *
	 * @since  2.5
	 * @param  int $payment_id The payment ID
	 * @return bool            If the setup was successful or not
	 */
	private function setup_payment( $payment_id ) {
		$this->pending = array();

if ( empty( $payment_id ) ) {
			return false;
		}

$payment = get_post( $payment_id );

if( ! $payment || is_wp_error( $payment ) ) {
			return false;
		}

if( 'edd_payment' !== $payment->post_type ) {
			return false;
		}

// Allow extensions to perform actions before the payment is loaded
		do_action( 'edd_pre_setup_payment', $this, $payment_id );

// Primary Identifier
		$this->ID              = absint( $payment_id );

// Protected ID that can never be changed
		$this->_ID             = absint( $payment_id );

// We have a payment, get the generic payment_meta item to reduce calls to it
		$this->payment_meta    = $this->get_meta();

// Status and Dates
		$this->date            = $payment->post_date;
		$this->completed_date  = $this->setup_completed_date();
		$this->status          = $payment->post_status;
		$this->post_status     = $this->status;
		$this->mode            = $this->setup_mode();
		$this->parent_payment  = $payment->post_parent;

$all_payment_statuses  = edd_get_payment_statuses();
		$this->status_nicename = array_key_exists( $this->status, $all_payment_statuses ) ? $all_payment_statuses[ $this->status ] : ucfirst( $this->status );

// Items
		$this->fees            = $this->setup_fees();
		$this->cart_details    = $this->setup_cart_details();
		$this->downloads       = $this->setup_downloads();

// Currency Based
		$this->total           = $this->setup_total();
		$this->tax             = $this->setup_tax();
		$this->fees_total      = $this->setup_fees_total();
		$this->subtotal        = $this->setup_subtotal();
		$this->currency        = $this->setup_currency();

// Gateway based
		$this->gateway         = $this->setup_gateway();
		$this->transaction_id  = $this->setup_transaction_id();

// User based
		$this->ip              = $this->setup_ip();
		$this->customer_id     = $this->setup_customer_id();
		$this->user_id         = $this->setup_user_id();
		$this->email           = $this->setup_email();
		$this->user_info       = $this->setup_user_info();
		$this->address         = $this->setup_address();
		$this->discounts       = $this->user_info['discount'];
		$this->first_name      = $this->user_info['first_name'];
		$this->last_name       = $this->user_info['last_name'];

// Other Identifiers
		$this->key             = $this->setup_payment_key();
		$this->number          = $this->setup_payment_number();

// Additional Attributes
		$this->has_unlimited_downloads = $this->setup_has_unlimited();

// Allow extensions to add items to this object via hook
		do_action( 'edd_setup_payment', $this, $payment_id );

return true;
	}

/**
	 * Create the base of a payment.
	 *
	 * @since  2.5
	 * @return int|bool False on failure, the payment ID on success.
	 */
	private function insert_payment() {

// Construct the payment title
		$payment_title = '';

if ( ! empty( $this->first_name ) && ! empty( $this->last_name ) ) {
			$payment_title = $this->first_name . ' ' . $this->last_name;
		} else if ( ! empty( $this->first_name ) && empty( $this->last_name ) ) {
			$payment_title = $this->first_name;
		} else if ( ! empty( $this->email ) && is_email( $this->email ) ) {
			$payment_title = $this->email;
		}

if ( empty( $this->key ) ) {

$auth_key  = defined( 'AUTH_KEY' ) ? AUTH_KEY : '';
			$this->key = strtolower( md5( $this->email . date( 'Y-m-d H:i:s' ) . $auth_key . uniqid( 'edd', true ) ) );  // Unique key
			$this->pending['key'] = $this->key;
		}

if ( empty( $this->ip ) ) {

$this->ip = edd_get_ip();
			$this->pending['ip'] = $this->ip;

}

$payment_data = array(
			'price'        => $this->total,
			'date'         => $this->date,
			'user_email'   => $this->email,
			'purchase_key' => $this->key,
			'currency'     => $this->currency,
			'downloads'    => $this->downloads,
			'user_info' => array(
				'id'         => $this->user_id,
				'email'      => $this->email,
				'first_name' => $this->first_name,
				'last_name'  => $this->last_name,
				'discount'   => $this->discounts,
				'address'    => $this->address,
			),
			'cart_details' => $this->cart_details,
			'status'       => $this->status,
			'fees'         => $this->fees,
		);

$args = apply_filters( 'edd_insert_payment_args', array(
			'post_title'    => $payment_title,
			'post_status'   => $this->status,
			'post_type'     => 'edd_payment',
			'post_date'     => ! empty( $this->date ) ? $this->date : null,
			'post_date_gmt' => ! empty( $this->date ) ? get_gmt_from_date( $this->date ) : null,
			'post_parent'   => $this->parent_payment,
		), $payment_data );

// Create a blank payment
		$payment_id = wp_insert_post( $args );

if ( ! empty( $payment_id ) ) {

$this->ID  = $payment_id;
			$this->_ID = $payment_id;

$customer = new stdClass;

if ( did_action( 'edd_pre_process_purchase' ) && is_user_logged_in() ) {

$customer = new EDD_customer( get_current_user_id(), true );

// Customer is logged in but used a different email to purchase with so assign to their customer record
				if( ! empty( $customer->id ) && $this->email != $customer->email ) {
					$customer->add_email( $this->email );
				}

}

if ( empty( $customer->id ) ) {
				$customer = new EDD_Customer( $this->email );
			}

if ( empty( $customer->id ) ) {

$customer_data = array(
					'name'        => ! is_email( $payment_title ) ? $this->first_name . ' ' . $this->last_name : '',
					'email'       => $this->email,
					'user_id'     => $this->user_id,
				);

$customer->create( $customer_data );

}

$this->customer_id            = $customer->id;
			$this->pending['customer_id'] = $this->customer_id;
			$customer->attach_payment( $this->ID, false );

$this->payment_meta = apply_filters( 'edd_payment_meta', $this->payment_meta, $payment_data );
			if ( ! empty( $this->payment_meta['fees'] ) ) {
				$this->fees = array_merge( $this->fees, $this->payment_meta['fees'] );
				foreach( $this->fees as $fee ) {
					$this->increase_fees( $fee['amount'] );
				}
			}

if ( edd_get_option( 'enable_sequential' ) ) {
				$number       = edd_get_next_payment_number();
				$this->number = edd_format_payment_number( $number );
				$this->update_meta( '_edd_payment_number', $this->number );
				update_option( 'edd_last_payment_number', $number );
			}

$this->update_meta( '_edd_payment_meta', $this->payment_meta );
			$this->new          = true;
		}

return $this->ID;

}

/**
	 * One items have been set, an update is needed to save them to the database.
	 *
	 * @return bool  True of the save occurred, false if it failed or wasn't needed
	 */
	public function save() {

global $edd_logs;

$saved = false;

if ( empty( $this->ID ) ) {

$payment_id = $this->insert_payment();

if ( false === $payment_id ) {
				$saved = false;
			} else {
				$this->ID = $payment_id;
			}

}

if( $this->ID !== $this->_ID ) {
			$this->ID = $this->_ID;
		}

// If we have something pending, let's save it
		if ( ! empty( $this->pending ) ) {

$total_increase = 0;
			$total_decrease = 0;

foreach ( $this->pending as $key => $value ) {
				switch( $key ) {
					case 'downloads':
						// Update totals for pending downloads
						foreach ( $this->pending[ $key ] as $item ) {

switch( $item['action'] ) {

case 'add':
									$price = $item['price'];
									$taxes = $item['tax'];

if ( 'publish' === $this->status || 'complete' === $this->status || 'revoked' === $this->status ) {

// Add sales logs
										$log_date =  date_i18n( 'Y-m-d G:i:s', current_time( 'timestamp' ) );
										$price_id = isset( $item['item_number']['options']['price_id'] ) ? $item['item_number']['options']['price_id'] : 0;

$y = 0;
										while ( $y < $item['quantity'] ) {
											edd_record_sale_in_log( $item['id'], $this->ID, $price_id, $log_date );
											$y++;
										}

$increase_earnings = $price;
										if ( ! empty( $item['fees'] ) ) {
											foreach ( $item['fees'] as $fee ) {
												// Only let negative fees affect the earnings
												if ( $fee['amount'] > 0 ) {
													continue;
												}
												$increase_earnings += (float) $fee['amount'];
											}
										}

$download = new EDD_Download( $item['id'] );
										$download->increase_sales( $item['quantity'] );
										$download->increase_earnings( $increase_earnings );

$total_increase += $price;
									}
									break;

case 'remove':

$meta_query = array();
										$meta_query[] = array(
											'key'     => '_edd_log_payment_id',
											'value'   => $this->ID,
											'compare' => '=',
										);

if( ! empty( $item['price_id'] ) || 0 === (int) $item['price_id'] ) {
											$meta_query[] = array(
												'key'     => '_edd_log_price_id',
												'value'   => (int) $item['price_id'],
												'compare' => '='
											);
										}

$log_args = array(
											'post_parent'    => $item['id'],
											'posts_per_page' => $item['quantity'],
											'meta_query'     => $meta_query,
											'log_type'       => 'sale'
										);

$found_logs = $edd_logs->get_connected_logs( $log_args );

if( $found_logs ) {
											foreach ( $found_logs as $log ) {
												wp_delete_post( $log->ID, true );
											}
										}

if ( 'publish' === $this->status || 'complete' === $this->status || 'revoked' === $this->status ) {
											$download = new EDD_Download( $item['id'] );
											$download->decrease_sales( $item['quantity'] );

$decrease_amount = $item['amount'];
											if ( ! empty( $item['fees'] ) ) {
												foreach( $item['fees'] as $fee ) {
													// Only let negative fees affect the earnings
													if ( $fee['amount'] > 0 ) {
														continue;
													}
													$decrease_amount += $fee['amount'];
												}
											}
											$download->decrease_earnings( $decrease_amount );

$total_decrease += $item['amount'];
										}
										break;

}

}
						break;

case 'fees':

if ( 'publish' !== $this->status && 'complete' !== $this->status && 'revoked' !== $this->status ) {
							break;
						}

if ( empty( $this->pending[ $key ] ) ) {
							break;
						}

foreach ( $this->pending[ $key ] as $fee ) {

switch( $fee['action'] ) {

case 'add':
									$total_increase += $fee['amount'];
									break;

case 'remove':
									$total_decrease += $fee['amount'];
									break;

}

break;

case 'status':
						$this->update_status( $this->status );
						break;

case 'gateway':
						$this->update_meta( '_edd_payment_gateway', $this->gateway );
						break;

case 'mode':
						$this->update_meta( '_edd_payment_mode', $this->mode );
						break;

case 'transaction_id':
						$this->update_meta( '_edd_payment_transaction_id', $this->transaction_id );
						break;

case 'ip':

$this->update_meta( '_edd_payment_user_ip', $this->ip );
						break;

case 'customer_id':
						$this->update_meta( '_edd_payment_customer_id', $this->customer_id );
						break;

case 'user_id':
						$this->update_meta( '_edd_payment_user_id', $this->user_id );
						break;

case 'first_name':
						$this->user_info['first_name'] = $this->first_name;
						break;

case 'last_name':
						$this->user_info['last_name'] = $this->last_name;
						break;

case 'discounts':
						if ( ! is_array( $this->discounts ) ) {
							$this->discounts = explode( ',', $this->discounts );
						}

$this->user_info['discount'] = implode( ',', $this->discounts );
						break;

case 'address':
						$this->user_info['address'] = $this->address;
						break;

case 'email':
						$this->update_meta( '_edd_payment_user_email', $this->email );
						break;

case 'key':
						$this->update_meta( '_edd_payment_purchase_key', $this->key );
						break;

case 'number':
						$this->update_meta( '_edd_payment_number', $this->number );
						break;

case 'date':
						$args = array(
							'ID'        => $this->ID,
							'post_date' => $this->date,
							'edit_date' => true,
						);

wp_update_post( $args );
						break;

case 'completed_date':
						$this->update_meta( '_edd_completed_date', $this->completed_date );
						break;

case 'has_unlimited_downloads':
						$this->update_meta( '_edd_payment_unlimited_downloads', $this->has_unlimited_downloads );
						break;

case 'parent_payment':
						$args = array(
							'ID'          => $this->ID,
							'post_parent' => $this->parent_payment,
						);

wp_update_post( $args );
						break;

default:
						/**
						 * Used to save non-standard data. Developers can hook here if they want to save
						 * specific payment data when $payment->save() is run and their item is in the $pending array
						 */
						do_action( 'edd_payment_save', $this, $key );
						break;
				}
			}

if ( 'pending' !== $this->status ) {

$customer = new EDD_Customer( $this->customer_id );

$total_change = $total_increase - $total_decrease;
				if ( $total_change < 0 ) {

$total_change = -( $total_change );
					// Decrease the customer's purchase stats
					$customer->decrease_value( $total_change );
					edd_decrease_total_earnings( $total_change );

} else if (  $total_change > 0 ) {

// Increase the customer's purchase stats
					$customer->increase_value( $total_change );
					edd_increase_total_earnings( $total_change );

}

$this->update_meta( '_edd_payment_total', $this->total );
			$this->update_meta( '_edd_payment_tax', $this->tax );

$this->downloads    = array_values( $this->downloads );

$new_meta = array(
				'downloads'     => $this->downloads,
				'cart_details'  => $this->cart_details,
				'fees'          => $this->fees,
				'currency'      => $this->currency,
				'user_info'     => is_array( $this->user_info ) ? array_filter( $this->user_info ) : array(),
				'date'          => $this->date
			);

// Do some merging of user_info before we merge it all, to honor the edd_payment_meta filter
			if ( ! empty( $this->payment_meta['user_info'] ) ) {

$stored_discount = ! empty( $new_meta['user_info']['discount'] ) ? $new_meta['user_info']['discount'] : '';

$new_meta[ 'user_info' ] = array_replace_recursive( (array) $this->payment_meta[ 'user_info' ], $new_meta[ 'user_info' ] );

if ( 'none' !== $stored_discount ) {
					$new_meta['user_info']['discount'] = $stored_discount;
				}

}

$meta        = $this->get_meta();
			$merged_meta = array_merge( $meta, $new_meta );

// Only save the payment meta if it's changed
			if ( md5( serialize( $meta ) ) !== md5( serialize( $merged_meta) ) ) {
				$updated     = $this->update_meta( '_edd_payment_meta', $merged_meta );
				if ( false !== $updated ) {
					$saved = true;
				}
			}

$this->pending = array();
			$saved         = true;
		}

if ( true === $saved ) {
			$this->setup_payment( $this->ID );

/**
			 * This action fires anytime that $payment->save() is run, allowing developers to run actions
			 * when a payment is updated
			 */
			do_action( 'edd_payment_saved', $this->ID, $this );
		}

return $saved;
	}

/**
	 * Add a download to a given payment
	 *
	 * @since 2.5
	 * @param int   $download_id The download to add
	 * @param array $args Other arguments to pass to the function
	 * @param array $options List of download options
	 * @return bool True when successful, false otherwise
	 */
	public function add_download( $download_id = 0, $args = array(), $options = array() ) {
		$download = new EDD_Download( $download_id );

// Bail if this post isn't a download
		if( ! $download || $download->post_type !== 'download' ) {
			return false;
		}

// Set some defaults
		$defaults = array(
			'quantity'    => 1,
			'price_id'    => false,
			'item_price'  => false,
			'discount'    => 0,
			'tax'         => 0.00,
			'fees'        => array(),
		);

$args = wp_parse_args( apply_filters( 'edd_payment_add_download_args', $args, $download->ID ), $defaults );

// Allow overriding the price
		if( false !== $args['item_price'] ) {
			$item_price = $args['item_price'];
		} else {
			// Deal with variable pricing
			if( edd_has_variable_prices( $download->ID ) ) {
				$prices = get_post_meta( $download->ID, 'edd_variable_prices', true );

if( $args['price_id'] && array_key_exists( $args['price_id'], (array) $prices ) ) {
					$item_price = $prices[$args['price_id']]['amount'];
				} else {
					$item_price       = edd_get_lowest_price_option( $download->ID );
					$args['price_id'] = edd_get_lowest_price_id( $download->ID );
				}
			} else {
				$item_price = edd_get_download_price( $download->ID );
			}
		}

// Sanitizing the price here so we don't have a dozen calls later
		$item_price = edd_sanitize_amount( $item_price );
		$quantity   = edd_item_quantities_enabled() ? absint( $args['quantity'] ) : 1;
		$amount     = round( $item_price * $quantity, edd_currency_decimal_filter() );

// Setup the downloads meta item
		$new_download = array(
			'id'       => $download->ID,
			'quantity' => $quantity,
		);

$default_options = array(
			'quantity' => $quantity,
		);

if ( false !== $args['price_id'] ) {
			$default_options['price_id'] = (int) $args['price_id'];
		}

$options                 = wp_parse_args( $options, $default_options );
		$new_download['options'] = $options;

$this->downloads[] = $new_download;

$discount   = $args['discount'];
		$subtotal   = $amount;
		$tax        = $args['tax'];

if ( edd_prices_include_tax() ) {
			$subtotal -= round( $tax, edd_currency_decimal_filter() );
		}

$total      = $subtotal - $discount + $tax;

// Do not allow totals to go negative
		if( $total < 0 ) {
			$total = 0;
		}

// Silly item_number array
		$item_number = array(
			'id'        => $download->ID,
			'quantity'  => $quantity,
			'options'   => $options,
		);

$this->cart_details[] = array(
			'name'        => $download->post_title,
			'id'          => $download->ID,
			'item_number' => $item_number,
			'item_price'  => round( $item_price, edd_currency_decimal_filter() ),
			'quantity'    => $quantity,
			'discount'    => $discount,
			'subtotal'    => round( $subtotal, edd_currency_decimal_filter() ),
			'tax'         => round( $tax, edd_currency_decimal_filter() ),
			'fees'        => $args['fees'],
			'price'       => round( $total, edd_currency_decimal_filter() ),
		);

$added_download = end( $this->cart_details );
		$added_download['action']  = 'add';

$this->pending['downloads'][] = $added_download;
		reset( $this->cart_details );

$this->increase_subtotal( $subtotal - $discount );
		$this->increase_tax( $tax );

return true;

}

/**
	 * Remove a download from the payment
	 *
	 * @since  2.5
	 * @param  int   $download_id The download ID to remove
	 * @param  array $args        Arguments to pass to identify (quantity, amount, price_id)
	 * @return bool               If the item was removed or not
	 */
	public function remove_download( $download_id, $args = array() ) {

// Set some defaults
		$defaults = array(
			'quantity'   => 1,
			'item_price' => false,
			'price_id'   => false,
			'cart_index' => false,
		);
		$args = wp_parse_args( $args, $defaults );

$download = new EDD_Download( $download_id );

// Bail if this post isn't a download
		if( ! $download || $download->post_type !== 'download' ) {
			return false;
		}

foreach ( $this->downloads as $key => $item ) {

if ( (int) $download_id !== (int) $item['id'] ) {
				continue;
			}

if ( false !== $args['price_id'] ) {

if ( isset( $item['options']['price_id'] ) && (int) $args['price_id'] !== (int) $item['options']['price_id'] ) {
					continue;
				}

} elseif ( false !== $args['cart_index'] ) {

$cart_index = absint( $args['cart_index'] );
				$cart_item  = ! empty( $this->cart_details[ $cart_index ] ) ? $this->cart_details[ $cart_index ] : false;

if ( ! empty( $cart_item ) ) {

// If the cart index item isn't the same download ID, don't remove it
					if ( $cart_item['id'] != $item['id'] ) {
						continue;
					}

// If this item has a price ID, make sure it matches the cart indexed item's price ID before removing
					if ( isset( $item['options']['price_id'] ) && (int) $item['options']['price_id'] !== (int) $cart_item['item_number']['options']['price_id'] ) {
						continue;
					}

}

$item_quantity = $this->downloads[ $key ]['quantity'];

if ( $item_quantity > $args['quantity'] ) {

$this->downloads[ $key ]['quantity'] -= $args['quantity'];
				break;

} else {

unset( $this->downloads[ $key ] );
				break;

}

$found_cart_key = false;

if ( false === $args['cart_index'] ) {

foreach ( $this->cart_details as $cart_key => $item ) {

if ( $download_id != $item['id'] ) {
					continue;
				}

if ( false !== $args['price_id'] ) {
					if ( isset( $item['item_number']['options']['price_id'] ) && (int) $args['price_id'] !== (int) $item['item_number']['options']['price_id'] ) {
						continue;
					}
				}

if ( false !== $args['item_price'] ) {
					if ( isset( $item['item_price'] ) && (float) $args['item_price'] != (float) $item['item_price'] ) {
						continue;
					}
				}

$found_cart_key = $cart_key;
				break;
			}

} else {

$cart_index = absint( $args['cart_index'] );

if ( ! array_key_exists( $cart_index, $this->cart_details ) ) {
				return false; // Invalid cart index passed.
			}

if ( (int) $this->cart_details[ $cart_index ]['id'] !== (int) $download_id ) {
				return false; // We still need the proper Download ID to be sure.
			}

$found_cart_key = $cart_index;
		}

$orig_quantity = $this->cart_details[ $found_cart_key ]['quantity'];

if ( $orig_quantity > $args['quantity'] ) {

$this->cart_details[ $found_cart_key ]['quantity'] -= $args['quantity'];

$item_price   = $this->cart_details[ $found_cart_key ]['item_price'];
			$tax          = $this->cart_details[ $found_cart_key ]['tax'];
			$discount     = ! empty( $this->cart_details[ $found_cart_key ]['discount'] ) ? $this->cart_details[ $found_cart_key ]['discount'] : 0;

// The total reduction equals the number removed * the item_price
			$total_reduced = round( $item_price * $args['quantity'], edd_currency_decimal_filter() );
			$tax_reduced   = round( ( $tax / $orig_quantity ) * $args['quantity'], edd_currency_decimal_filter() );

$new_quantity = $this->cart_details[ $found_cart_key ]['quantity'];
			$new_tax      = $this->cart_details[ $found_cart_key ]['tax'] - $tax_reduced;
			$new_subtotal = $new_quantity * $item_price;
			$new_discount = 0;
			$new_total    = 0;

$this->cart_details[ $found_cart_key ]['subtotal'] = $new_subtotal;
			$this->cart_details[ $found_cart_key ]['discount'] = $new_discount;
			$this->cart_details[ $found_cart_key ]['tax']      = $new_tax;
			$this->cart_details[ $found_cart_key ]['price']    = $new_subtotal - $new_discount + $new_tax;

} else {

$total_reduced = $this->cart_details[ $found_cart_key ]['item_price'];
			$tax_reduced   = $this->cart_details[ $found_cart_key ]['tax'];

$found_fees = array();

if ( ! empty( $this->cart_details[ $found_cart_key ]['fees'] ) ) {

$found_fees = $this->cart_details[ $found_cart_key ]['fees'];

foreach ( $found_fees as $key => $fee ) {
					$this->remove_fee( $key );
				}

}

unset( $this->cart_details[ $found_cart_key ] );

}

$pending_args             = $args;
		$pending_args['id']       = $download_id;
		$pending_args['amount']   = $total_reduced;
		$pending_args['price_id'] = false !== $args['price_id'] ? $args['price_id'] : false;
		$pending_args['quantity'] = $args['quantity'];
		$pending_args['action']   = 'remove';
		$pending_args['fees']     = isset( $found_fees ) ? $found_fees : array();

$this->pending['downloads'][] = $pending_args;

$this->decrease_subtotal( $total_reduced );
		$this->decrease_tax( $tax_reduced );

return true;
	}

/**
	 * Add a fee to a given payment
	 *
	 * @since  2.5
	 * @param  array $args Array of arguments for the fee to add
	 * @param bool $global
	 * @return bool If the fee was added
	 */
	public function add_fee( $args, $global = true ) {

$default_args = array(
			'label'       => '',
			'amount'      => 0,
			'type'        => 'fee',
			'id'          => '',
			'no_tax'      => false,
			'download_id' => 0,
		);

$fee = wp_parse_args( $args, $default_args );
		$this->fees[] = $fee;

$added_fee               = $fee;
		$added_fee['action']     = 'add';
		$this->pending['fees'][] = $added_fee;
		reset( $this->fees );

$this->increase_fees( $fee['amount'] );
		return true;
	}

/**
	 * Remove a fee from the payment
	 *
	 * @since  2.5
	 * @param  int $key The array key index to remove
	 * @return bool     If the fee was removed successfully
	 */
	public function remove_fee( $key ) {
		$removed = $this->remove_fee_by( 'index', $key );

return $removed;
	}

/**
	 * Remove a fee by the defined attributed
	 *
	 * @since  2.5
	 * @param  string      $key    The key to remove by
	 * @param  int|string  $value  The value to search for
	 * @param  boolean $global     False - removes the first value it fines, True - removes all matches
	 * @return boolean             If the item is removed
	 */
	public function remove_fee_by( $key, $value, $global = false ) {

$allowed_fee_keys = apply_filters( 'edd_payment_fee_keys', array(
			'index', 'label', 'amount', 'type',
		) );

if ( ! in_array( $key, $allowed_fee_keys ) ) {
			return false;
		}

$removed = false;
		if ( 'index' === $key && array_key_exists( $value, $this->fees ) ) {

$removed_fee             = $this->fees[ $value ];
			$removed_fee['action']   = 'remove';
			$this->pending['fees'][] = $removed_fee;

$this->decrease_fees( $removed_fee['amount'] );

unset( $this->fees[ $value ] );
			$removed = true;

} else if ( 'index' !== $key ) {

foreach ( $this->fees as $index => $fee ) {

if ( isset( $fee[ $key ] ) && $fee[ $key ] == $value ) {

$removed_fee             = $fee;
					$removed_fee['action']   = 'remove';
					$this->pending['fees'][] = $removed_fee;

$this->decrease_fees( $removed_fee['amount'] );

unset( $this->fees[ $index ] );
					$removed = true;

if ( false === $global ) {
						break;
					}

}

if ( true === $removed ) {
			$this->fees = array_values( $this->fees );
		}

return $removed;
	}

/**
	 * Get the fees, filterable by type
	 *
	 * @since  2.5
	 * @param  string $type All, item, fee
	 * @return array        The Fees for the type specified
	 */
	public function get_fees( $type = 'all' ) {
		$fees    = array();

if ( ! empty( $this->fees ) && is_array( $this->fees ) ) {

foreach ( $this->fees as $fee_id => $fee ) {

if( 'all' != $type && ! empty( $fee['type'] ) && $type != $fee['type'] ) {
					continue;
				}

$fee['id'] = $fee_id;
				$fees[]    = $fee;

}
		}

return apply_filters( 'edd_get_payment_fees', $fees, $this->ID, $this );
	}

/**
	 * Add a note to a payment
	 *
	 * @since 2.5
	 * @param string $note The note to add
	 * @return void
	 */
	public function add_note( $note = false ) {
		// Bail if no note specified
		if( ! $note ) {
			return false;
		}

edd_insert_payment_note( $this->ID, $note );
	}

/**
	 * Increase the payment's subtotal
	 *
	 * @since  2.5
	 * @param  float  $amount The amount to increase the payment subtotal by
	 * @return void
	 */
	private function increase_subtotal( $amount = 0.00 ) {
		$amount          = (float) $amount;
		$this->subtotal += $amount;