subscription = $subscription; } /* Performs the initial purchase of a one time or recurring product */ public function completePurchase(PaymentHash $payment_hash) { if (!property_exists($payment_hash->data, 'billing_context')) { throw new \Exception("Illegal entrypoint into method, payload must contain billing context"); } // if we have a recurring product - then generate a recurring invoice if(strlen($this->subscription->recurring_product_ids) >=1){ $recurring_invoice = $this->convertInvoiceToRecurring($payment_hash->payment->client_id); $recurring_invoice_repo = new RecurringInvoiceRepository(); $recurring_invoice->next_send_date = now(); $recurring_invoice = $recurring_invoice_repo->save([], $recurring_invoice); $recurring_invoice->next_send_date = $recurring_invoice->nextSendDate(); /* Start the recurring service */ $recurring_invoice->service() ->start() ->save(); //execute any webhooks $context = [ 'context' => 'recurring_purchase', 'recurring_invoice' => $recurring_invoice->hashed_id, 'invoice' => $this->encodePrimaryKey($payment_hash->fee_invoice_id), 'client' => $recurring_invoice->client->hashed_id, 'subscription' => $this->subscription->hashed_id, ]; $response = $this->triggerWebhook($context); nlog($response); if(array_key_exists('post_purchase_url', $this->subscription->webhook_configuration) && strlen($this->subscription->webhook_configuration['post_purchase_url']) >=1) return redirect($this->subscription->webhook_configuration['post_purchase_url']); return redirect('/client/recurring_invoices/'.$recurring_invoice->hashed_id); } else { $invoice = Invoice::find($payment_hash->fee_invoice_id); $context = [ 'context' => 'single_purchase', 'invoice' => $this->encodePrimaryKey($payment_hash->fee_invoice_id), 'client' => $invoice->client->hashed_id, 'subscription' => $this->subscription->hashed_id, ]; //execute any webhooks $this->triggerWebhook($context); if(array_key_exists('post_purchase_url', $this->subscription->webhook_configuration) && strlen($this->subscription->webhook_configuration['post_purchase_url']) >=1) return redirect($this->subscription->webhook_configuration['post_purchase_url']); return redirect('/client/invoices/'.$this->encodePrimaryKey($payment_hash->fee_invoice_id)); } } /* Hits the client endpoint to determine whether the user is able to access this subscription */ public function isEligible($contact) { $context = [ 'context' => 'is_eligible', 'subscription' => $this->subscription->hashed_id, 'contact' => $contact->hashed_id, 'contact_email' => $contact->email, 'client' => $contact->client->hashed_id, ]; $response = $this->triggerWebhook($context); nlog($response); return $response; } /* Starts the process to create a trial - we create a recurring invoice, which is has its next_send_date as now() + trial_duration - we then hit the client API end point to advise the trial payload - we then return the user to either a predefined user endpoint, OR we return the user to the recurring invoice page. */ public function startTrial(array $data) { // Redirects from here work just fine. Livewire will respect it. $client_contact = ClientContact::find($data['contact_id']); if(!$this->subscription->trial_enabled) return new \Exception("Trials are disabled for this product"); //create recurring invoice with start date = trial_duration + 1 day $recurring_invoice_repo = new RecurringInvoiceRepository(); $recurring_invoice = $this->convertInvoiceToRecurring($client_contact->client_id); $recurring_invoice->next_send_date = now()->addSeconds($this->subscription->trial_duration); $recurring_invoice->backup = 'is_trial'; if(array_key_exists('coupon', $data) && ($data['coupon'] == $this->subscription->promo_code) && $this->subscription->promo_discount > 0) { $recurring_invoice->discount = $this->subscription->promo_discount; $recurring_invoice->is_amount_discount = $this->subscription->is_amount_discount; } $recurring_invoice = $recurring_invoice_repo->save($data, $recurring_invoice); /* Start the recurring service */ $recurring_invoice->service() ->start() ->save(); $context = [ 'context' => 'trial', 'recurring_invoice' => $recurring_invoice->hashed_id, 'client' => $recurring_invoice->client->hashed_id, 'subscription' => $this->subscription->hashed_id, ]; //execute any webhooks $response = $this->triggerWebhook($context); if(array_key_exists('return_url', $this->subscription->webhook_configuration) && strlen($this->subscription->webhook_configuration['return_url']) >=1){ return redirect($this->subscription->webhook_configuration['return_url']); } return redirect('/client/recurring_invoices/'.$recurring_invoice->hashed_id); } public function calculateUpgradePrice(RecurringInvoice $recurring_invoice, Subscription $target) :?float { //calculate based on daily prices $current_amount = $recurring_invoice->amount; $currency_frequency = $recurring_invoice->frequency_id; $outstanding = $recurring_invoice->invoices() ->where('is_deleted', 0) ->whereIn('status_id', [Invoice::STATUS_SENT, Invoice::STATUS_PARTIAL]) ->where('balance', '>', 0); $outstanding_amounts = $outstanding->sum('balance'); // $outstanding_invoices = $outstanding->get(); $outstanding_invoices = $outstanding; if ($outstanding->count() == 0){ //nothing outstanding return $target->price; } elseif ($outstanding->count() == 1){ //user has multiple amounts outstanding return $target->price - $this->calculateProRataRefund($outstanding->first()); } elseif ($outstanding->count() > 1) { //user is changing plan mid frequency cycle //we cannot handle this if there are more than one invoice outstanding. return null; } return null; } private function calculateProRataRefund($invoice) :float { //determine the start date $start_date = Carbon::parse($invoice->date); $current_date = now(); $days_to_refund = $start_date->diffInDays($current_date); $days_in_frequency = $this->getDaysInFrequency(); $pro_rata_refund = round(($days_to_refund/$days_in_frequency) * $invoice->amount ,2); return $pro_rata_refund; } public function createChangePlanInvoice($data) { //Data array structure /** * [ * 'recurring_invoice' => RecurringInvoice::class, * 'subscription' => Subscription::class, * 'target' => Subscription::class * ] */ $outstanding_invoice = $recurring_invoice->invoices() ->where('is_deleted', 0) ->whereIn('status_id', [Invoice::STATUS_SENT, Invoice::STATUS_PARTIAL]) ->where('balance', '>', 0) ->first(); $pro_rata_refund = null; // we calculate the pro rata refund for this invoice. if($outstanding_invoice) { // $pro_rata_refund = $this->calculateProRataRefund($out } //logic // Is the user paid up to date? ie are there any outstanding invoices for this subscription // User in arrears. // User paid up to date (in credit!) //generate credit amount. // //generate new billable amount // //if billable amount is LESS than 0 -> generate a credit and pass through. // //if billable amoun is GREATER than 0 -> gener return Invoice::where('status_id', Invoice::STATUS_SENT)->first(); } public function createInvoice($data): ?\App\Models\Invoice { $invoice_repo = new InvoiceRepository(); $subscription_repo = new SubscriptionRepository(); $invoice = InvoiceFactory::create($this->subscription->company_id, $this->subscription->user_id); $invoice->line_items = $subscription_repo->generateLineItems($this->subscription); $invoice->subscription_id = $this->subscription->id; if(strlen($data['coupon']) >=1 && ($data['coupon'] == $this->subscription->promo_code) && $this->subscription->promo_discount > 0) { $invoice->discount = $this->subscription->promo_discount; $invoice->is_amount_discount = $this->subscription->is_amount_discount; } return $invoice_repo->save($data, $invoice); } private function convertInvoiceToRecurring($client_id) :RecurringInvoice { $subscription_repo = new SubscriptionRepository(); $recurring_invoice = RecurringInvoiceFactory::create($this->subscription->company_id, $this->subscription->user_id); $recurring_invoice->client_id = $client_id; $recurring_invoice->line_items = $subscription_repo->generateLineItems($this->subscription, true); $recurring_invoice->subscription_id = $this->subscription->id; $recurring_invoice->frequency_id = $this->subscription->frequency_id ?: RecurringInvoice::FREQUENCY_MONTHLY; $recurring_invoice->date = now(); $recurring_invoice->remaining_cycles = -1; return $recurring_invoice; } public function triggerWebhook($context) { /* If no webhooks have been set, then just return gracefully */ if(!array_key_exists('post_purchase_url', $this->subscription->webhook_configuration) || !array_key_exists('post_purchase_rest_method', $this->subscription->webhook_configuration)) { return true; } $response = false; $body = array_merge($context, [ 'company_key' => $this->subscription->company->company_key, 'account_key' => $this->subscription->company->account->key, 'db' => $this->subscription->company->db, ]); $response = $this->sendLoad($this->subscription, $body); /* Append the response to the system logger body */ if(is_array($response)){ $body = $response; } else { $status = $response->getStatusCode(); $response_body = $response->getBody(); $body = array_merge($body, ['status' => $status, 'response_body' => $response_body]); } $client = \App\Models\Client::find($this->decodePrimaryKey($body['client'])); SystemLogger::dispatch( $body, SystemLog::CATEGORY_WEBHOOK, SystemLog::EVENT_WEBHOOK_RESPONSE, SystemLog::TYPE_WEBHOOK_RESPONSE, $client, ); return $response; } public function fireNotifications() { //scan for any notification we are required to send } /** * Get the single charge products for the * subscription * * @return ?Product Collection */ public function products() { return Product::whereIn('id', $this->transformKeys(explode(",", $this->subscription->product_ids)))->get(); } /** * Get the recurring products for the * subscription * * @return ?Product Collection */ public function recurring_products() { return Product::whereIn('id', $this->transformKeys(explode(",", $this->subscription->recurring_product_ids)))->get(); } /** * Get available upgrades & downgrades for the plan. * * @return \Illuminate\Database\Eloquent\Builder[]|\Illuminate\Database\Eloquent\Collection */ public function getPlans() { return Subscription::query() ->where('company_id', $this->subscription->company_id) ->where('group_id', $this->subscription->group_id) ->where('id', '!=', $this->subscription->id) ->get(); } public function completePlanChange(PaymentHash $paymentHash) { // .. handle redirect, after upgrade redirects, etc.. } public function handleCancellation() { dd('Cancelling using SubscriptionService'); // .. } /** * Get pro rata calculation between subscriptions. * * @param Subscription $current * @param Subscription $target */ public function getPriceBetweenSubscriptions(Subscription $current, Subscription $target): int { // Calculate the pro rata. Return negative value if credits needed. return 1; } private function getDaysInFrequency() { switch ($this->subscription->frequency_id) { case self::FREQUENCY_DAILY: return 1; case self::FREQUENCY_WEEKLY: return 7; case self::FREQUENCY_TWO_WEEKS: return 14; case self::FREQUENCY_FOUR_WEEKS: return now()->diffInDays(now()->addWeeks(4)); case self::FREQUENCY_MONTHLY: return now()->diffInDays(now()->addMonthNoOverflow()); case self::FREQUENCY_TWO_MONTHS: return now()->diffInDays(now()->addMonthNoOverflow(2)); case self::FREQUENCY_THREE_MONTHS: return now()->diffInDays(now()->addMonthNoOverflow(3)); case self::FREQUENCY_FOUR_MONTHS: return now()->diffInDays(now()->addMonthNoOverflow(4)); case self::FREQUENCY_SIX_MONTHS: return now()->diffInDays(now()->addMonthNoOverflow(6)); case self::FREQUENCY_ANNUALLY: return now()->diffInDays(now()->addYear()); case self::FREQUENCY_TWO_YEARS: return now()->diffInDays(now()->addYears(2)); case self::FREQUENCY_THREE_YEARS: return now()->diffInDays(now()->addYears(3)); default: return 0; } } }