Add Source::allSourceTransactions and SubscriptionItem::allUsageRecordSummaries

lib/Source.php

@@ -51,6 +51,7 @@ class Source extends ApiResource
     const OBJECT_NAME = 'source';
 
     use ApiOperations\Create;
+    use ApiOperations\NestedResource;
     use ApiOperations\Retrieve;
     use ApiOperations\Update;
 
@@ -118,6 +119,8 @@ public function detach($params = null, $opts = null)
     }
 
     /**
+     * @deprecated sourceTransactions is deprecated. Please use Source::allSourceTransactions instead.
+     *
      * @param array|null $params
      * @param array|string|null $opts
      *
@@ -134,6 +137,20 @@ public function sourceTransactions($params = null, $opts = null)
         return $obj;
     }
 
+    /**
+     * @param string $id
+     * @param array|null $params
+     * @param array|string|null $opts
+     *
+     * @throws \Stripe\Exception\ApiErrorException if the request fails
+     *
+     * @return Collection The list of source transactions.
+     */
+    public static function allSourceTransactions($id, $params = null, $opts = null)
+    {
+        return self::_allNestedResources($id, '/source_transactions', $params, $opts);
+    }
+
     /**
      * @param array|null $params
      * @param array|string|null $opts

lib/SubscriptionItem.php

@@ -45,6 +45,8 @@ public static function createUsageRecord($id, $params = null, $opts = null)
     }
 
     /**
+     * @deprecated usageRecordSummaries is deprecated. Please use SubscriptionItem::allUsageRecordSummaries instead.
+     *
      * @param array|null $params
      * @param array|string|null $opts
      *
@@ -60,4 +62,18 @@ public function usageRecordSummaries($params = null, $opts = null)
         $obj->setLastResponse($response);
         return $obj;
     }
+
+    /**
+     * @param string $id
+     * @param array|null $params
+     * @param array|string|null $opts
+     *
+     * @throws \Stripe\Exception\ApiErrorException if the request fails
+     *
+     * @return Collection The list of usage record summaries.
+     */
+    public static function allUsageRecordSummaries($id, $params = null, $opts = null)
+    {
+        return self::_allNestedResources($id, '/usage_record_summaries', $params, $opts);
+    }
 }

tests/Stripe/SourceTest.php

@@ -109,7 +109,7 @@ public function testIsNotDetachableWhenUnattached()
         $resource->detach();
     }
 
-    public function testCanListSourceTransactions()
+    public function testCanListSourceTransactionsDeprecated()
     {
         $source = Source::retrieve(self::TEST_RESOURCE_ID);
         $this->expectsRequest(
@@ -121,6 +121,18 @@ public function testCanListSourceTransactions()
         $this->assertInstanceOf(\Stripe\SourceTransaction::class, $resources->data[0]);
     }
 
+    public function testCanListSourceTransactions()
+    {
+        $source_id = self::TEST_RESOURCE_ID;
+        $this->expectsRequest(
+            'get',
+            '/v1/sources/' . $source_id . "/source_transactions"
+        );
+        $resources = Source::allSourceTransactions($source_id);
+        $this->assertTrue(is_array($resources->data));
+        $this->assertInstanceOf(\Stripe\SourceTransaction::class, $resources->data[0]);
+    }
+
     public function testCanVerify()
     {
         $resource = Source::retrieve(self::TEST_RESOURCE_ID);

tests/Stripe/SubscriptionItemTest.php

@@ -93,7 +93,7 @@ public function testCanCreateUsageRecord()
         ]);
     }
 
-    public function testCanListUsageRecordSummaries()
+    public function testCanListUsageRecordSummariesDeprecated()
     {
         $resource = SubscriptionItem::retrieve(self::TEST_RESOURCE_ID);
         $this->expectsRequest(
@@ -104,4 +104,15 @@ public function testCanListUsageRecordSummaries()
         $this->assertTrue(is_array($resources->data));
         $this->assertInstanceOf(\Stripe\UsageRecordSummary::class, $resources->data[0]);
     }
+
+    public function testCanListUsageRecordSummaries()
+    {
+        $this->expectsRequest(
+            'get',
+            '/v1/subscription_items/' . self::TEST_RESOURCE_ID . "/usage_record_summaries"
+        );
+        $resources =SubscriptionItem::allUsageRecordSummaries(self::TEST_RESOURCE_ID);
+        $this->assertTrue(is_array($resources->data));
+        $this->assertInstanceOf(\Stripe\UsageRecordSummary::class, $resources->data[0]);
+    }
 }