Class: Pay::Subscription

Inherits:
ApplicationRecord show all
Defined in:
app/models/pay/subscription.rb

Constant Summary collapse

STATUSES = 
%w[incomplete incomplete_expired trialing active past_due canceled unpaid paused]

Class Method Summary collapse

Instance Method Summary collapse

Class Method Details

.find_by_processor_and_id(processor, processor_id) ⇒ Object 



46
47
48
 
# File 'app/models/pay/subscription.rb', line 46

def self.find_by_processor_and_id(processor, processor_id)
  joins(:customer).find_by(processor_id: processor_id, pay_customers: {processor: processor})
end

Instance Method Details

#active? ⇒ Boolean

If you cancel during a trial, you should still retain access until the end of the trial Otherwise a subscription is active unless it has ended or is currently paused Check the subscription status so we don’t accidentally consider “incomplete”, “unpaid”, or other statuses as active

Returns:

  • (Boolean) 


97
98
99
100
 
# File 'app/models/pay/subscription.rb', line 97

def active?
  ["trialing", "active"].include?(status) &&
    (!(canceled? || paused?) || on_trial? || on_grace_period?)
end

#canceled? ⇒ Boolean

Returns:

  • (Boolean) 


78
79
80
 
# File 'app/models/pay/subscription.rb', line 78

def canceled?
  ends_at?
end

#cancelled? ⇒ Boolean

Returns:

  • (Boolean) 


82
83
84
 
# File 'app/models/pay/subscription.rb', line 82

def cancelled?
  canceled?
end

#ended? ⇒ Boolean

Returns:

  • (Boolean) 


86
87
88
 
# File 'app/models/pay/subscription.rb', line 86

def ended?
  ends_at? && ends_at <= Time.current
end

#generic_trial? ⇒ Boolean

Returns:

  • (Boolean) 


59
60
61
 
# File 'app/models/pay/subscription.rb', line 59

def generic_trial?
  fake_processor? && trial_ends_at?
end

#has_incomplete_payment? ⇒ Boolean

Returns:

  • (Boolean) 


114
115
116
 
# File 'app/models/pay/subscription.rb', line 114

def has_incomplete_payment?
  past_due? || incomplete?
end

#has_trial? ⇒ Boolean

Returns:

  • (Boolean) 


63
64
65
 
# File 'app/models/pay/subscription.rb', line 63

def has_trial?
  trial_ends_at?
end

#incomplete? ⇒ Boolean

Returns:

  • (Boolean) 


110
111
112
 
# File 'app/models/pay/subscription.rb', line 110

def incomplete?
  status == "incomplete"
end

#on_grace_period? ⇒ Boolean

Returns:

  • (Boolean) 


90
91
92
 
# File 'app/models/pay/subscription.rb', line 90

def on_grace_period?
  ends_at? && ends_at > Time.current
end

#on_trial? ⇒ Boolean

Does not include the last second of the trial

Returns:

  • (Boolean) 


68
69
70
71
 
# File 'app/models/pay/subscription.rb', line 68

def on_trial?
  return false if ended?
  trial_ends_at? && trial_ends_at > Time.current
end

#past_due? ⇒ Boolean

Returns:

  • (Boolean) 


102
103
104
 
# File 'app/models/pay/subscription.rb', line 102

def past_due?
  status == "past_due"
end

#skip_trial ⇒ Object 



55
56
57
 
# File 'app/models/pay/subscription.rb', line 55

def skip_trial
  self.trial_ends_at = nil
end

#swap_and_invoice(plan) ⇒ Object 



118
119
120
121
 
# File 'app/models/pay/subscription.rb', line 118

def swap_and_invoice(plan)
  swap(plan)
  customer.invoice!(subscription: processor_id)
end

#sync!(**options) ⇒ Object 



50
51
52
53
 
# File 'app/models/pay/subscription.rb', line 50

def sync!(**options)
  self.class.sync(processor_id, **options)
  reload
end

#trial_ended? ⇒ Boolean

Returns:

  • (Boolean) 


73
74
75
76
 
# File 'app/models/pay/subscription.rb', line 73

def trial_ended?
  return true if ended?
  trial_ends_at? && trial_ends_at <= Time.current
end

#unpaid? ⇒ Boolean

Returns:

  • (Boolean) 


106
107
108
 
# File 'app/models/pay/subscription.rb', line 106

def unpaid?
  status == "unpaid"
end