Add support for TaxId resource and APIs

stripe · Apr 12, 2019 · 498788c · 498788c
1 parent 22f6696
commit 498788c
Show file tree

Hide file tree

Showing 6 changed files with 191 additions and 0 deletions.
diff --git a/init.php b/init.php
@@ -118,6 +118,7 @@
 require(dirname(__FILE__) . '/lib/SubscriptionItem.php');
 require(dirname(__FILE__) . '/lib/SubscriptionSchedule.php');
 require(dirname(__FILE__) . '/lib/SubscriptionScheduleRevision.php');
+require(dirname(__FILE__) . '/lib/TaxId.php');
 require(dirname(__FILE__) . '/lib/Terminal/ConnectionToken.php');
 require(dirname(__FILE__) . '/lib/Terminal/Location.php');
 require(dirname(__FILE__) . '/lib/Terminal/Reader.php');

diff --git a/lib/Customer.php b/lib/Customer.php
@@ -51,6 +51,7 @@ public static function getSavedNestedResources()
     }
 
     const PATH_SOURCES = '/sources';
+    const PATH_TAX_IDS = '/tax_ids';
 
     /**
      * @param array|null $params
@@ -202,4 +203,54 @@ public static function allSources($id, $params = null, $opts = null)
     {
         return self::_allNestedResources($id, static::PATH_SOURCES, $params, $opts);
     }
+
+    /**
+     * @param string|null $id The ID of the customer on which to create the tax id.
+     * @param array|null $params
+     * @param array|string|null $opts
+     *
+     * @return ApiResource
+     */
+    public static function createTaxId($id, $params = null, $opts = null)
+    {
+        return self::_createNestedResource($id, static::PATH_TAX_IDS, $params, $opts);
+    }
+
+    /**
+     * @param string|null $id The ID of the customer to which the tax id belongs.
+     * @param string|null $taxIdId The ID of the tax id to retrieve.
+     * @param array|null $params
+     * @param array|string|null $opts
+     *
+     * @return ApiResource
+     */
+    public static function retrieveTaxId($id, $taxIdId, $params = null, $opts = null)
+    {
+        return self::_retrieveNestedResource($id, static::PATH_TAX_IDS, $taxIdId, $params, $opts);
+    }
+
+    /**
+     * @param string|null $id The ID of the customer to which the tax id belongs.
+     * @param string|null $taxIdId The ID of the tax id to delete.
+     * @param array|null $params
+     * @param array|string|null $opts
+     *
+     * @return ApiResource
+     */
+    public static function deleteTaxId($id, $taxIdId, $params = null, $opts = null)
+    {
+        return self::_deleteNestedResource($id, static::PATH_TAX_IDS, $taxIdId, $params, $opts);
+    }
+
+    /**
+     * @param string|null $id The ID of the customer on which to retrieve the tax ids.
+     * @param array|null $params
+     * @param array|string|null $opts
+     *
+     * @return Collection The list of tax ids.
+     */
+    public static function allTaxIds($id, $params = null, $opts = null)
+    {
+        return self::_allNestedResources($id, static::PATH_TAX_IDS, $params, $opts);
+    }
 }
diff --git a/lib/TaxId.php b/lib/TaxId.php
@@ -0,0 +1,71 @@
+<?php
+
+namespace Stripe;
+
+/**
+ * Class TaxId
+ *
+ * @package Stripe
+ *
+ * @property string $id
+ * @property string $object
+ * @property string $country
+ * @property int $created
+ * @property string $customer
+ * @property bool $deleted
+ * @property bool $livemode
+ * @property type $type
+ * @property string $value
+ * @property mixed $verification
+ */
+class TaxId extends ApiResource
+{
+
+    const OBJECT_NAME = "tax_id";
+
+    use ApiOperations\Delete;
+
+    /**
+     * Possible string representations of a tax id's type.
+     * @link https://stripe.com/docs/api/customers/tax_id_object#tax_id_object-type
+     */
+    const TYPE_AU_ABN  = 'au_abn';
+    const TYPE_EU_VAT  = 'eu_vat';
+    const TYPE_NZ_GST  = 'nz_gst';
+    const TYPE_UNKNOWN = 'unknown';
+
+    /**
+     * @return string The API URL for this tax id.
+     */
+    public function instanceUrl()
+    {
+        $id = $this['id'];
+        $customer = $this['customer'];
+        if (!$id) {
+            throw new Error\InvalidRequest(
+                "Could not determine which URL to request: class instance has invalid ID: $id",
+                null
+            );
+        }
+        $id = Util\Util::utf8($id);
+        $customer = Util\Util::utf8($customer);
+
+        $base = Account::classUrl();
+        $customerExtn = urlencode($customer);
+        $extn = urlencode($id);
+        return "$base/$customerExtn/tax_ids/$extn";
+    }
+
+    /**
+     * @param array|string $_id
+     * @param array|string|null $_opts
+     *
+     * @throws \Stripe\Error\InvalidRequest
+     */
+    public static function retrieve($_id, $_opts = null)
+    {
+        $msg = "Tax Ids cannot be accessed without a customer ID. " .
+               "Retrieve a Tax Id using \$account->retrieveTaxId('tax_id') instead.";
+        throw new Error\InvalidRequest($msg, null);
+    }
+}
diff --git a/lib/Util/Util.php b/lib/Util/Util.php
@@ -131,6 +131,7 @@ public static function convertToStripeObject($resp, $opts)
             \Stripe\SubscriptionItem::OBJECT_NAME => 'Stripe\\SubscriptionItem',
             \Stripe\SubscriptionSchedule::OBJECT_NAME => 'Stripe\\SubscriptionSchedule',
             \Stripe\SubscriptionScheduleRevision::OBJECT_NAME => 'Stripe\\SubscriptionScheduleRevision',
+            \Stripe\TaxId::OBJECT_NAME => 'Stripe\\TaxId',
             \Stripe\ThreeDSecure::OBJECT_NAME => 'Stripe\\ThreeDSecure',
             \Stripe\Terminal\ConnectionToken::OBJECT_NAME => 'Stripe\\Terminal\\ConnectionToken',
             \Stripe\Terminal\Location::OBJECT_NAME => 'Stripe\\Terminal\\Location',

diff --git a/tests/Stripe/CustomerTest.php b/tests/Stripe/CustomerTest.php
@@ -6,6 +6,7 @@ class CustomerTest extends TestCase
 {
     const TEST_RESOURCE_ID = 'cus_123';
     const TEST_SOURCE_ID = 'ba_123';
+    const TEST_TAX_ID = 'txi_123';
 
     public function testIsListable()
     {
@@ -263,4 +264,44 @@ public function testSerializeSourceMap()
         ];
         $this->assertSame($expected, $obj->serializeParameters());
     }
+
+    public function testCanCreateTaxId()
+    {
+        $this->expectsRequest(
+            'post',
+            '/v1/customers/' . self::TEST_RESOURCE_ID . '/tax_ids'
+        );
+        $resource = Customer::createTaxId(self::TEST_RESOURCE_ID, [
+            "type" => TaxId::TYPE_EU_VAT,
+            "value" => "11111",
+        ]);
+    }
+
+    public function testCanRetrieveTaxId()
+    {
+        $this->expectsRequest(
+            'get',
+            '/v1/customers/' . self::TEST_RESOURCE_ID . '/tax_ids/' . self::TEST_TAX_ID
+        );
+        $resource = Customer::retrieveTaxId(self::TEST_RESOURCE_ID, self::TEST_TAX_ID);
+    }
+
+    public function testCanDeleteTaxId()
+    {
+        $this->expectsRequest(
+            'delete',
+            '/v1/customers/' . self::TEST_RESOURCE_ID . '/tax_ids/' . self::TEST_TAX_ID
+        );
+        $resource = Customer::deleteTaxId(self::TEST_RESOURCE_ID, self::TEST_TAX_ID);
+    }
+
+    public function testCanListTaxIds()
+    {
+        $this->expectsRequest(
+            'get',
+            '/v1/customers/' . self::TEST_RESOURCE_ID . '/tax_ids'
+        );
+        $resources = Customer::allTaxIds(self::TEST_RESOURCE_ID);
+        $this->assertTrue(is_array($resources->data));
+    }
 }
diff --git a/tests/Stripe/TaxIdTest.php b/tests/Stripe/TaxIdTest.php
@@ -0,0 +1,26 @@
+<?php
+
+namespace Stripe;
+
+class TaxIdTest extends TestCase
+{
+    const TEST_CUSTOMER_ID = 'cus_123';
+    const TEST_RESOURCE_ID = 'txi_123';
+
+    public function testHasCorrectUrl()
+    {
+        $resource = \Stripe\Account::retrieveTaxId(self::TEST_CUSTOMER_ID, self::TEST_RESOURCE_ID);
+        $this->assertSame(
+            "/v1/customers/" . self::TEST_CUSTOMER_ID . "/tax_ids/" . self::TEST_RESOURCE_ID,
+            $resource->instanceUrl()
+        );
+    }
+
+    /**
+     * @expectedException \Stripe\Error\InvalidRequest
+     */
+    public function testIsNotDirectlyRetrievable()
+    {
+        TaxId::retrieve(self::TEST_RESOURCE_ID);
+    }
+}