woocommerce/includes/payment-tokens/class-wc-payment-token-cc.php

<?php

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

/**
 * WooCommerce Credit Card Payment Token
 *
 * Representation of a payment token for credit cards
 * Extends from WC_Payment_Token_eCheck since both types contain last4 digits.
 *
 * @class 		WC_Payment_Token_CC
 * @since		2.6.0
 * @category 	PaymentTokens
 * @package 	WooCommerce/PaymentTokens
 * @author		WooThemes
 */
class WC_Payment_Token_CC extends WC_Payment_Token {

	/** @protected string Token Type String */
	protected $type = 'CC';

 	/**
	 * Validate credit card payment tokens
	 *
	 * These fields are required by all credit card payment tokens:
	 * expiry_month  - string Expiration date (MM) for the card
	 * expiry_year   - string Expiration date (YYYY) for the card
	 * last4         - string Last 4 digits of the card
	 * card_type     - string Card type (visa, mastercard, etc)
	 *
	 * @since 2.6.0
	 * @return boolean True if the passed data is valid
	 */
	public function validate() {
		if ( false === parent::validate() ) {
			return false;
		}

		if ( empty( $this->meta['last4'] ) ) {
			return false;
		}

		if ( empty( $this->meta['expiry_year'] ) ) {
			return false;
		}

		if ( empty( $this->meta['expiry_month'] ) ) {
			return false;
		}

		if ( empty ( $this->meta['card_type'] ) ) {
			return false;
		}

		if ( 4 !== strlen( $this->meta['expiry_year'] ) ) {
			return false;
		}

		if ( 2 !== strlen( $this->meta['expiry_month'] ) ) {
			return false;
		}

		return true;
	}

	/**
	 * Returns the card type (mastercard, visa, ...)
	 *
	 * @since 2.6.0
	 * @return string Card type
	 */
	public function get_card_type() {
		return isset( $this->meta['card_type'] ) ? $this->meta['card_type'] : null;
	}

	/**
	 * Set the card type (mastercard, visa, ...)
	 *
	 * @since 2.6.0
	 * @param string $type
	 */
	public function set_card_type( $type ) {
		$this->meta['card_type'] = $type;
	}

	/**
	 * Returns the card expiration year (YYYY)
	 *
	 * @since 2.6.0
	 * @return string Expiration year
	 */
	public function get_expiry_year() {
		return isset( $this->meta['expiry_year'] ) ? $this->meta['expiry_year'] : null;
	}

	/**
	 * Set the expiration year for the card (YYYY format)
	 *
	 * @since 2.6.0
	 * @param string $year
	 */
	public function set_expiry_year( $year ) {
		$this->meta['expiry_year'] = $year;
	}

	/**
	 * Returns the card expiration month (MM)
	 *
	 * @since 2.6.0
	 * @return string Expiration month
	 */
	public function get_expiry_month() {
		return isset( $this->meta['expiry_month'] ) ? $this->meta['expiry_month'] : null;
	}

	/**
	 * Set the expiration month for the card (MM format)
	 *
	 * @since 2.6.0
	 * @param string $month
	 */
	public function set_expiry_month( $month ) {
		$this->meta['expiry_month'] = $month;
	}

	/**
	 * Returns the last four digits
	 *
	 * @since 2.6.0
	 * @return string Last 4 digits
	 */
	public function get_last4() {
		return isset( $this->meta['last4'] ) ? $this->meta['last4'] : null;
	}

	/**
	 * Set the last four digits
	 *
	 * @since 2.6.0
	 * @param string $last4
	 */
	public function set_last4( $last4 ) {
		$this->meta['last4'] = $last4;
	}

}