refactoring

Author: Mostafa Kamal

src/StripeCoupon.php

@@ -7,10 +7,11 @@
  * @copyright Kawsar Soft. (http://kawsarsoft.com)
  */
 
+use Illuminate\Support\Str;
  use Stripe\Stripe;
  use Stripe\Coupon;
  use Config;
- 
+
 /**
  * Coupon class
  * @source https://stripe.com/docs/api/coupons
@@ -84,6 +85,14 @@ public function setup($data)
         return $this;
     }
 
+    /**
+     * Coupon amount
+     * @param  int|float $amount
+     * @param  string $type     [fixed,per]
+     * @param  string $currency  fixed amount purpose
+     * @source https://stripe.com/docs/api/coupons/object#coupon_object-amount_off
+     * @return $this
+     */
     public function amount($amount,$type,$currency = 'usd')
     {
         if ($type === 'fixed') {
@@ -94,10 +103,16 @@ public function amount($amount,$type,$currency = 'usd')
             $this->amount = $amount;
             $this->type = 'per';
         }
-
       return $this;
     }
 
+    /**
+     * Coupon duration
+     * @param  string  $type  [forever,once,repeating]
+     * @param  integer $month
+     * @source https://stripe.com/docs/api/coupons/create#create_coupon-duration
+     * @return $this
+     */
     public function duration($type,$month = 1)
     {
         //forever, once, or repeating.
@@ -108,12 +123,21 @@ public function duration($type,$month = 1)
       return $this;
     }
 
+    /**
+     * Coupon name & id
+     * @param  string $name snake_case
+     * @return $this
+     */
     public function name($name)
     {
-      $this->name = $name;
+      $this->name = Str::snake($name);
       return $this;
     }
 
+    /**
+     * Create coupon & retrieve data
+     * @return  object
+     */
     public function get()
     {
         if ($this->type === 'per') {
@@ -127,6 +151,7 @@ public function get()
             $this->couponData['name'] = $this->name;
             $this->couponData['id'] = $this->name;
         }
+
         if ($this->duration === 'forever' || $this->duration === 'once') {
             $this->couponData['duration'] = $this->duration;
         } else {
@@ -139,10 +164,15 @@ public function get()
          $coupon = Coupon::create($this->couponData);
          return $coupon;
        } catch (\Exception $e) {
-         return (object)['isError' => 'true','message'=> $e->getMessage()];
+         return (object)['isError' => 'true','message'=> $e->getMessage(),'stripe' => $e->getJsonBody()['error']];
        }
     }
-    
+
+    /**
+     * Delete a coupon
+     * @param  string $id coupon id
+     * @return object
+     */
     public function delete($id)
     {
         try {
@@ -151,9 +181,7 @@ public function delete($id)
           $coupon->delete();
           return $coupon;
         } catch (\Exception $e) {
-          return (object)['isError' => 'true','message'=> $e->getMessage()];
+          return (object)['isError' => 'true','message'=> $e->getMessage(),'stripe' => $e->getJsonBody()['error']];
         }
     }
-
-
 }

src/StripePlans.php

@@ -7,7 +7,7 @@
  * @copyright Kawsar Soft. (http://kawsarsoft.com)
  */
 
- use Stripe\Product;
+use Stripe\Product;
 use Stripe\Stripe;
 use Stripe\Plan;
 use Config;
@@ -23,10 +23,6 @@ class StripePlans
      * @var string
      */
     private $secretKey;
-    /**
-     * Customer all data after create
-     * @var object
-     */
 
     /**
      * Set currency for plan.
@@ -35,8 +31,8 @@ class StripePlans
     private $currency;
 
     /**
-     * [private description]
-     * @var [type]
+     * plan billing recurring interval
+     * @var string
      */
     private $interval;
 
@@ -46,8 +42,16 @@ class StripePlans
      */
     private $amount;
 
+    /**
+     * Plan products
+     * @var array
+     */
     private $product = [];
 
+    /**
+     * Plan extra properties
+     * @var array
+     */
     private $extra = [];
 
     /**
@@ -75,30 +79,56 @@ public function setup($data)
         return $this;
     }
 
+    /**
+     * Plan products
+     * @param  aray $data
+     * @source https://stripe.com/docs/api/plans/create#create_plan-product
+     * @return $this
+     */
     public function product($data)
     {
       $this->product = $data;
       return $this;
     }
 
+    /**
+     * Plan price
+     * @param  int|float $amount
+     * @return $this
+     */
     public function amount($amount)
     {
       $this->amount = round($amount,2) * 100;
       return $this;
     }
 
+    /**
+     * Plan recurring interval
+     * @param  string $type [day,week,month,year]
+     * @return $this
+     */
     public function interval($type)
     {
       $this->interval = $type;
       return $this;
     }
 
+    /**
+     * Plan currency
+     * @param   $currency
+     * @return $this
+     */
     public function currency($currency)
     {
       $this->currency = $currency;
       return $this;
     }
 
+    /**
+     * Plan extra properties
+     * @param  array $data associate array
+     * @return $this
+     */
     public function extra ($data)
     {
         $this->extra = $data;
@@ -130,7 +160,7 @@ public function get()
            'interval' => $this->interval,
            'product' => $this->product,
            'trial_period_days' => $this->trial,
-           // $this->extra
+           $this->extra
          ]);
          return $plan;
        } catch (\Exception $e) {
@@ -155,20 +185,18 @@ public function retrieve($id)
     }
 
     /**
-     * Delete a plan and same time delete product.
+     * Active a plan
      * @param  string $id
      * @return object
      */
-    public function delete($id)
+    public function active($id)
     {
         try {
             Stripe::setApiKey($this->secretKey);
-            $plan = Plan::retrieve($id);
-            $product = $plan->product;
-            $plan->delete();
-
-            $getProduct = Product::retrieve($product);
-            $getProduct->delete();
+            $plan = Plan::update(
+                $id,
+                ['active' => true]
+            );
 
             return $plan;
         } catch (\Exception $e) {
@@ -177,38 +205,40 @@ public function delete($id)
     }
 
     /**
-     * Active a plan
+     * Deactive a plan.
      * @param  string $id
-     * @return object
+     * @return $this
      */
-    public function active($id)
+    public function deactive($id)
     {
         try {
             Stripe::setApiKey($this->secretKey);
             $plan = Plan::update(
                 $id,
-                ['active' => true]
+                ['active' => false]
             );
-
             return $plan;
         } catch (\Exception $e) {
             return (object)['isError' => 'true','message'=> $e->getMessage()];
         }
     }
 
     /**
-     * Deactive a plan.
+     * Delete a plan and same time delete product.
      * @param  string $id
-     * @return $this
+     * @return object
      */
-    public function deactive($id)
+    public function delete($id)
     {
         try {
             Stripe::setApiKey($this->secretKey);
-            $plan = Plan::update(
-                $id,
-                ['active' => false]
-            );
+            $plan = Plan::retrieve($id);
+            $product = $plan->product;
+            $plan->delete();
+
+            $getProduct = Product::retrieve($product);
+            $getProduct->delete();
+
             return $plan;
         } catch (\Exception $e) {
             return (object)['isError' => 'true','message'=> $e->getMessage()];

src/StripeSubscription.php

@@ -23,8 +23,9 @@ class StripeSubscription
      * @var string
      */
     private $secretKey;
+
     /**
-     * Customer all data after create.
+     * Subscription Customer
      * @var object
      */
     private $customer;
@@ -60,6 +61,12 @@ class StripeSubscription
      */
     private $trial;
 
+    /**
+     * Card source
+     * @var string
+     */
+    private $source;
+
     /**
      * Subcription with coupon.
      * @var string
@@ -141,6 +148,16 @@ public function trial($day) {
         return $this;
     }
 
+    /**
+     * set customer card source
+     * @param  string $code
+     * @return $this
+     */
+    public function source($code) {
+        $this->source = $code;
+        return $this;
+    }
+
     /**
      * Coupon apply
      * @param  string $code
@@ -168,6 +185,9 @@ public function get()
         if ($this->coupon) {
             $this->createSubscriptionData['coupon'] = $this->coupon;
         }
+        if ($this->source) {
+            $this->createSubscriptionData['default_source'] = $this->source;
+        }
         $subsData = array_merge($this->createSubscriptionData,$this->extra);
 
        try {