Add some methods for pending updates

src/Invoice.php

@@ -452,6 +452,19 @@ public function downloadAs($filename, array $data)
         ]);
     }
 
+    /**
+     * Void the Stripe invoice.
+     *
+     * @param  array  $options
+     * @return $this
+     */
+    public function void(array $options = [])
+    {
+        $this->invoice = $this->invoice->voidInvoice($options, $this->owner->stripeOptions());
+
+        return $this;
+    }
+
     /**
      * Get the Stripe model instance.
      *

src/Subscription.php

@@ -898,6 +898,16 @@ public function resume()
         return $this;
     }
 
+    /**
+     * Determine if the subscription has pending updates.
+     *
+     * @return bool
+     */
+    public function pending()
+    {
+        return $this->asStripeSubscription()->pending_update !== null;
+    }
+
     /**
      * Invoice the subscription outside of the regular billing cycle.
      *
@@ -920,6 +930,18 @@ public function invoice(array $options = [])
         }
     }
 
+    /**
+     * Get the latest invoice for the subscription.
+     *
+     * @return \Laravel\Cashier\Invoice
+     */
+    public function latestInvoice()
+    {
+        $stripeSubscription = $this->asStripeSubscription(['latest_invoice']);
+
+        return new Invoice($this->owner, $stripeSubscription->latest_invoice);
+    }
+
     /**
      * Sync the tax percentage of the user to the subscription.
      *

tests/Feature/MultiplanSubscriptionsTest.php

@@ -287,7 +287,6 @@ public function test_subscription_items_can_swap_plans()
         $this->assertSame(3, $item->quantity);
     }
 
-    /** @group Prorate */
     public function test_subscription_item_changes_can_be_prorated()
     {
         $user = $this->createCustomer('subscription_item_changes_can_be_prorated');

tests/Feature/PendingUpdatesTest.php

@@ -133,6 +133,15 @@ public function test_subscription_can_be_pending_if_incomplete()
 
             // Assert subscription is active.
             $this->assertTrue($subscription->active());
+
+            // Assert subscription has pending updates.
+            $this->assertTrue($subscription->pending());
+
+            // Void the last invoice to cancel any pending updates.
+            $subscription->latestInvoice()->void();
+
+            // Assert subscription has no more pending updates.
+            $this->assertFalse($subscription->pending());
         }
     }
 }

tests/Feature/SubscriptionsTest.php

@@ -477,6 +477,7 @@ public function test_creating_subscription_with_explicit_trial()
         $this->assertEquals(Carbon::tomorrow()->hour(3)->minute(15), $subscription->trial_ends_at);
     }
 
+    /** @group Prorate */
     public function test_subscription_changes_can_be_prorated()
     {
         $user = $this->createCustomer('subscription_changes_can_be_prorated');
@@ -489,15 +490,18 @@ public function test_subscription_changes_can_be_prorated()
 
         // Assert that no new invoice was created because of no prorating.
         $this->assertEquals($invoice->id, $user->invoices()->first()->id);
+        $this->assertEquals(1000, $user->upcomingInvoice()->rawTotal());
 
         $subscription->swapAndInvoice(static::$premiumPlanId);
 
         // Assert that a new invoice was created because of immediate invoicing.
-        $this->assertNotSame($invoice->id, $user->invoices()->first()->id);
+        $this->assertNotSame($invoice->id, ($invoice = $user->invoices()->first())->id);
+        $this->assertEquals(1000, $invoice->rawTotal());
+        $this->assertEquals(2000, $user->upcomingInvoice()->rawTotal());
 
         $subscription->prorate()->swap(static::$planId);
 
-        // Get back from unused time on premium plan.
+        // Get back from unused time on premium plan on next invoice.
         $this->assertEquals(0, $user->upcomingInvoice()->rawTotal());
     }