Arcanedev\Stripe\Bases\ExternalAccount

Complexity

Total Complexity

9

Size/Duplication

Total Lines	103
Duplicated Lines	0 %

Coupling/Cohesion

Components	1
Dependencies	3

Test Coverage

Coverage

71.43%

Importance

Changes

0

4 Methods

Rating	Name	Duplication	Size	Complexity
B	instanceUrl()	0	37	5
A	delete()	0	4	1
A	save()	0	4	1
A	verify()	0	11	2

<?php namespace Arcanedev\Stripe\Bases;

use Arcanedev\Stripe\Exceptions\ApiException;
use Arcanedev\Stripe\Exceptions\InvalidRequestException;
use Arcanedev\Stripe\Resources;
use Arcanedev\Stripe\StripeResource;

/**
 * Class     ExternalAccount
 *
 * @package  Arcanedev\Stripe\Bases
 * @author   ARCANEDEV <arcanedev.maroc@gmail.com>
 *
 * @property  string     id
 * @property  bool|null  deleted
 */
abstract class ExternalAccount extends StripeResource
{
    /* ------------------------------------------------------------------------------------------------
     |  Getters & Setters
     | ------------------------------------------------------------------------------------------------
     */
    /**
     * Get The instance URL for this resource.
     * It needs to be special cased because it doesn't fit into the standard resource pattern.
     *
     * @throws InvalidRequestException
     *
     * @return string
     */
    public function instanceUrl()
    {
        $id = $this['id'];

        if ( ! $id) {
            $class = get_class($this);
            throw new InvalidRequestException(
                "Could not determine which URL to request: $class instance has invalid ID: $id", null
            );
        }

        if ($this['account']) {
            $parent = $this['account'];
            $class  = Resources\Account::class;
            $path   = 'external_accounts';
        }
        elseif ($this['customer']) {
            $parent = $this['customer'];
            $class  = Resources\Customer::class;
            $path   = 'sources';
        }
        elseif ($this['recipient']) {
            $parent = $this['recipient'];
            $class  = 'Arcanedev\\Stripe\\Resources\\Recipient';
            $path   = 'cards';
        }
        else {
            return null;
        }

        return implode('/', [
            self::classUrl($class),
            urlencode(str_utf8($parent)),
            $path,
            str_utf8($id),
        ]);
    }

    /* ------------------------------------------------------------------------------------------------
     |  Main Functions
     | ------------------------------------------------------------------------------------------------
     */
    /**
     * Delete an external account.
     *
     * @param  array|null         $params
     * @param  array|string|null  $options
     *
     * @return self
     */
    public function delete($params = [], $options = null)
    {
        return $this->scopedDelete($params, $options);
    }

    /**
     * Save an external account.
     *
     * @param  array|string|null  $options
     *
     * @return self
     */
    public function save($options = null)
    {
        return $this->scopedSave($options);
    }

    /**
     * Verify the external account.
     *
     * @param  array|null         $params
     * @param  array|string|null  $options
     *
     * @return self
     *
     * @throws \Arcanedev\Stripe\Exceptions\ApiException
     */
    public function verify($params = [], $options = null)
    {
        if ( ! $this['customer'])
            throw new ApiException('Only customer external accounts can be verified in this manner.');

        $url = $this->instanceUrl() . '/verify';
        list($response, $options) = $this->request('post', $url, $params, $options);
        $this->refreshFrom($response, $options);

        return $this;
    }
}