acts_as_subscription 0.0.1

data/.autotest

@@ -0,0 +1,2 @@
+require 'autotest/growl'
+require 'autotest/fsevent'

data/.rspec

@@ -0,0 +1,3 @@
+--format nested
+--color
+--drb

data/.rvmrc

@@ -0,0 +1 @@
+rvm 1.8.7@acts_as_subscription

data/Gemfile

@@ -0,0 +1,22 @@
+source :gemcutter
+
+gem 'activemerchant',         '~> 1.9.3'
+gem 'chargify_api_ares',      '~> 0.3.7'
+gem 'hpricot',                '>= 0.6'
+gem 'mousetrap',              '~> 0.5.0'
+gem 'rails',                  '~> 3.0.3'
+gem 'uuidtools'
+
+group :development do
+  gem 'bundler',              '~> 1.0.0'
+  gem 'jeweler',              '~> 1.5.2'
+  gem 'rcov',                 '>= 0.9.9'
+end
+
+group :test do
+  gem 'autotest',             '4.4.6'
+  gem 'autotest-fsevent',     '0.2.4'
+  gem 'autotest-growl',       '0.2.9'
+  gem 'rspec',                '2.0.0.rc'
+  gem 'sqlite3-ruby',         :require => 'sqlite3'
+end

data/LICENSE.txt

@@ -0,0 +1,19 @@
+Copyright (c) 2010 Dave Perrett, http://recursive-design.com/
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.rdoc

@@ -0,0 +1,21 @@
+= acts_as_subscription
+
+Description goes here.
+
+== Note on Patches/Pull Requests
+ 
+* Fork the project.
+* Make your feature addition or bug fix.
+* Add tests for it. This is important so I don't break it in a
+  future version unintentionally.
+* Commit, do not mess with rakefile, version, or history.
+  (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
+* Send me a pull request. Bonus points for topic branches.
+
+== Copyright
+
+Copyright (c) 2010 Dave Perrett. See LICENSE for details.
+
+== Notes
+
+* Make sure 'Require Credit Card at signup?' is *unchecked* for free plans on Chargify.

data/Rakefile

@@ -0,0 +1,54 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name              = "acts_as_subscription"
+    gem.summary           = "ActsAsSubscription is a plugin for rails that provides recurring subscription capabilities to a model."
+    gem.description       = "With ActsAsSubscription, you can hook your model into several subscription services, such as CheddarGetter."
+    gem.email             = "mail@recursive-design.com"
+    gem.homepage          = "http://recursive-design.com/"
+    gem.authors           = ["Dave Perrett"]
+    gem.rubyforge_project = 'nowarning'
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: gem install jeweler"
+end
+
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new('spec')
+task :default => :spec
+
+def version
+  File.exist?('VERSION') ? File.read('VERSION') : ""
+end
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "acts_as_subscription #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+namespace :gem do  
+
+  desc 'Clean build products'
+  task :clean do
+    rm_f 'pkg'
+  end
+
+  desc 'Build the gem'
+  task :build => :clean do
+    system 'rake gemspec'
+    system 'rake build'
+  end
+
+  desc 'Push the gem to rubygems'
+  task :publish => [:clean, :build] do
+    system "gem push pkg/acts_as_subscription-#{version}.gem"
+  end
+  
+end

data/VERSION

@@ -0,0 +1 @@
+0.0.1

data/acts_as_subscription.gemspec

@@ -0,0 +1,104 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{acts_as_subscription}
+  s.version = "0.0.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Dave Perrett"]
+  s.date = %q{2011-02-01}
+  s.description = %q{With ActsAsSubscription, you can hook your model into several subscription services, such as CheddarGetter.}
+  s.email = %q{mail@recursive-design.com}
+  s.extra_rdoc_files = [
+    "LICENSE.txt",
+    "README.rdoc"
+  ]
+  s.files = [
+    ".autotest",
+    ".rspec",
+    ".rvmrc",
+    "Gemfile",
+    "LICENSE.txt",
+    "README.rdoc",
+    "Rakefile",
+    "VERSION",
+    "acts_as_subscription.gemspec",
+    "autotest/discover.rb",
+    "lib/acts_as_subscription.rb",
+    "lib/acts_as_subscription/backend.rb",
+    "lib/acts_as_subscription/backend/chargify_client.rb",
+    "lib/acts_as_subscription/backend/cheddar_getter_client.rb",
+    "lib/acts_as_subscription/backend/dummy_client.rb",
+    "lib/acts_as_subscription/backend/recurly_client.rb",
+    "lib/acts_as_subscription/error.rb",
+    "lib/acts_as_subscription/railtie.rb",
+    "lib/acts_as_subscription/subscription.rb",
+    "lib/acts_as_subscription/subscription_plan.rb",
+    "spec/backend/backend/chargify_client_spec.rb",
+    "spec/backend/backend/cheddar_getter_client_spec.rb",
+    "spec/backend/backend_spec.rb",
+    "spec/models/subscription_plan_spec.rb",
+    "spec/models/subscription_spec.rb",
+    "spec/spec_helper.rb",
+    "spec/support/backend.yml.example",
+    "spec/support/database.yml",
+    "spec/support/models.rb",
+    "spec/support/schema.rb"
+  ]
+  s.homepage = %q{http://recursive-design.com/}
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{nowarning}
+  s.rubygems_version = %q{1.3.7}
+  s.summary = %q{ActsAsSubscription is a plugin for rails that provides recurring subscription capabilities to a model.}
+  s.test_files = [
+    "spec/backend/backend/chargify_client_spec.rb",
+    "spec/backend/backend/cheddar_getter_client_spec.rb",
+    "spec/backend/backend_spec.rb",
+    "spec/models/subscription_plan_spec.rb",
+    "spec/models/subscription_spec.rb",
+    "spec/spec_helper.rb",
+    "spec/support/models.rb",
+    "spec/support/schema.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<activemerchant>, ["~> 1.9.3"])
+      s.add_runtime_dependency(%q<chargify_api_ares>, ["~> 0.3.7"])
+      s.add_runtime_dependency(%q<hpricot>, [">= 0.6"])
+      s.add_runtime_dependency(%q<mousetrap>, ["~> 0.5.0"])
+      s.add_runtime_dependency(%q<rails>, ["~> 3.0.3"])
+      s.add_runtime_dependency(%q<uuidtools>, [">= 0"])
+      s.add_development_dependency(%q<bundler>, ["~> 1.0.0"])
+      s.add_development_dependency(%q<jeweler>, ["~> 1.5.2"])
+      s.add_development_dependency(%q<rcov>, [">= 0.9.9"])
+    else
+      s.add_dependency(%q<activemerchant>, ["~> 1.9.3"])
+      s.add_dependency(%q<chargify_api_ares>, ["~> 0.3.7"])
+      s.add_dependency(%q<hpricot>, [">= 0.6"])
+      s.add_dependency(%q<mousetrap>, ["~> 0.5.0"])
+      s.add_dependency(%q<rails>, ["~> 3.0.3"])
+      s.add_dependency(%q<uuidtools>, [">= 0"])
+      s.add_dependency(%q<bundler>, ["~> 1.0.0"])
+      s.add_dependency(%q<jeweler>, ["~> 1.5.2"])
+      s.add_dependency(%q<rcov>, [">= 0.9.9"])
+    end
+  else
+    s.add_dependency(%q<activemerchant>, ["~> 1.9.3"])
+    s.add_dependency(%q<chargify_api_ares>, ["~> 0.3.7"])
+    s.add_dependency(%q<hpricot>, [">= 0.6"])
+    s.add_dependency(%q<mousetrap>, ["~> 0.5.0"])
+    s.add_dependency(%q<rails>, ["~> 3.0.3"])
+    s.add_dependency(%q<uuidtools>, [">= 0"])
+    s.add_dependency(%q<bundler>, ["~> 1.0.0"])
+    s.add_dependency(%q<jeweler>, ["~> 1.5.2"])
+    s.add_dependency(%q<rcov>, [">= 0.9.9"])
+  end
+end
+

data/autotest/discover.rb

@@ -0,0 +1 @@
+Autotest.add_discovery { "rspec2" }

data/lib/acts_as_subscription/backend/chargify_client.rb

@@ -0,0 +1,173 @@
+require 'chargify_api_ares'
+
+module ActsAsSubscription::Subscription::Backend
+  
+  # A backend for the Chargify recurring billing service.
+  #
+  # http://chargify.com
+  class ChargifyClient
+    
+    # Initializes the backend, and authenticates with the subscription service.
+    #
+    # Required parameters are :
+    # * <tt>user</tt> :         The login used to connect to the remote API.
+    # * <tt>password</tt> :     The password used to connect to the remote API.
+    # * <tt>product_code</tt> : The code for the product being sold.
+    def initialize(user, password, product_code)
+      Chargify.configure do |c|
+        c.subdomain = user
+        c.api_key   = password
+      end
+    end
+      
+    # Creates a customer on the backend subscription service, using the settings from the given
+    # <tt>subscription</tt> instance.
+    #
+    # <tt>subscription</tt> should be a subclass of <tt>ActiveRecord::Base</tt> that implements
+    # <tt>acts_as_subscription</tt> :
+    #
+    #   class Subscription < ActiveRecord::Base
+    #     acts_as_subscription
+    #   end
+    #
+    # Returns true if the operation was successful, otherwise an error message.
+    def create_subscription(subscription)
+      customer_attributes = self.get_customer_attributes(subscription)
+      customer            = Chargify::Customer.create(customer_attributes)
+      if customer.errors.length == 0
+        subscription_attributes = self.get_subscription_attributes(subscription)
+        subscription            = Chargify::Subscription.create(subscription_attributes)
+        if subscription.errors.length > 0
+          return subscription.errors[:base][0]
+        else
+          return true
+        end
+      else
+        return customer.errors[:base][0]
+      end
+      return 'An unknown error occurred.'
+    rescue Exception => error
+      return error.message
+    end
+      
+    # Updates a customer on the backend subscription service, using the settings from the given
+    # <tt>subscription</tt> instance.
+    #
+    # <tt>subscription</tt> should be a subclass of <tt>ActiveRecord::Base</tt> that implements
+    # <tt>acts_as_subscription</tt> :
+    #
+    #   class Subscription < ActiveRecord::Base
+    #     acts_as_subscription
+    #   end
+    #
+    # Returns true if the update was successful, otherwise an error message.
+    def update_subscription(subscription)
+      customer              = Chargify::Customer.find_by_reference(subscription.customer_code)
+      customer.first_name   = subscription.first_name,
+      customer.last_name    = subscription.last_name,
+      customer.email        = subscription.email,
+      customer.reference    = subscription.customer_code
+      if customer.save
+        sub                     = Chargify::Subscription.find_by_customer_reference(subscription.customer_code)
+        sub.product_handle      = subscription.plan_code
+        subscription_attributes = self.get_subscription_attributes(subscription)
+        # If the user is down-grading to a free plan, credit_card_attributes may not be available.
+        if subscription_attributes[:credit_card_attributes]
+          sub.credit_card_attributes = subscription_attributes[:credit_card_attributes] 
+        end
+        if sub.save
+          return true
+        else
+          return sub.errors[:base][0]
+        end
+      else
+        return customer.errors[:base][0]
+      end
+    rescue Exception => error
+      return error.message
+    end
+      
+    # Cancels the customer with the given <tt>customer_code</tt> on the backend subscription service.
+    #
+    # Returns true if the cancellation was successful, or false otherwise.
+    def cancel_subscription!(customer_code)
+      sub      = Chargify::Subscription.find_by_customer_reference(customer_code)
+      response = sub.cancel
+      doc      = Hpricot::XML(response.body)
+      return (response.code == "200" and (doc/:subscription/:state).text == 'canceled')
+    rescue Exception => error
+      return false
+    end
+    
+    # Returns a list of subscription plans registered with the backend subscription service.
+    def plans
+      result = []
+      Chargify::Product.all.each do |product|
+        result << {
+          :name              => product.name,
+          :code              => product.handle,
+          :active            => true, # Doesn't seem to be an option to make inactive.
+          :description       => product.description,
+          :billing_frequency => product.interval_unit,
+          :recurring_charge  => product.price_in_cents.to_f
+        }
+      end
+      
+      return result
+    end
+    
+    protected
+    
+    # Converts a Subscription instance into a hash of parameters used to update a customer on
+    # the remote subscription service. 
+    #
+    # <tt>subscription</tt> should be a subclass of <tt>ActiveRecord::Base</tt> that implements
+    # <tt>acts_as_subscription</tt> :
+    #
+    #   class Subscription < ActiveRecord::Base
+    #     acts_as_subscription
+    #   end
+    def get_customer_attributes(subscription)
+      attributes = {
+        :first_name   => subscription.first_name,
+        :last_name    => subscription.last_name,
+        :email        => subscription.email,
+        :reference    => subscription.customer_code
+      }
+      
+      return attributes
+    end
+    
+    # Converts a Subscription instance into a hash of parameters used to update a subscription on
+    # the remote subscription service. 
+    #
+    # <tt>subscription</tt> should be a subclass of <tt>ActiveRecord::Base</tt> that implements
+    # <tt>acts_as_subscription</tt> :
+    #
+    #   class Subscription < ActiveRecord::Base
+    #     acts_as_subscription
+    #   end
+    def get_subscription_attributes(subscription)
+      attributes = {
+        :customer_reference      => subscription.customer_code,
+        :product_handle          => subscription.plan_code.downcase,
+      }
+      
+      unless subscription.is_free_plan? 
+        attributes[:credit_card_attributes] = {
+          :first_name            => subscription.first_name,
+          :last_name             => subscription.last_name,
+          :full_number           => subscription.cc_number,
+          :expiration_month      => subscription.cc_expiration_month,
+          :expiration_year       => subscription.cc_expiration_year,
+          :billing_zip_code      => subscription.zip_code,
+        }
+      end
+      
+      return attributes
+    end
+    
+  end
+  
+end
+    

data/lib/acts_as_subscription/backend/cheddar_getter_client.rb

@@ -0,0 +1,151 @@
+module ActsAsSubscription::Subscription::Backend
+  
+  # A backend for the CheddarGetter recurring billing service.
+  #
+  # https://cheddargetter.com
+  class CheddarGetterClient
+    
+    # Initializes the backend, and authenticates with the subscription service.
+    #
+    # Required parameters are :
+    # * <tt>user</tt> :         The login used to connect to the remote API.
+    # * <tt>password</tt> :     The password used to connect to the remote API.
+    # * <tt>product_code</tt> : The code for the product being sold.
+    def initialize(user, password, product_code)
+      Mousetrap.product_code = product_code
+      Mousetrap.authenticate(user, password)
+    end
+      
+    # Creates a customer on the backend subscription service, using the settings from the given
+    # <tt>subscription</tt> instance.
+    #
+    # <tt>subscription</tt> should be a subclass of <tt>ActiveRecord::Base</tt> that implements
+    # <tt>acts_as_subscription</tt> :
+    #
+    #   class Subscription < ActiveRecord::Base
+    #     acts_as_subscription
+    #   end
+    #
+    # Returns true if the operation was successful, otherwise an error message.
+    def create_subscription(subscription)
+      customer_attributes = self.get_customer_attributes(subscription)
+      Mousetrap::Customer.create customer_attributes
+      return true
+    rescue Exception => error
+      return error.message
+    end
+      
+    # Updates a customer on the backend subscription service, using the settings from the given
+    # <tt>subscription</tt> instance.
+    #
+    # <tt>subscription</tt> should be a subclass of <tt>ActiveRecord::Base</tt> that implements
+    # <tt>acts_as_subscription</tt> :
+    #
+    #   class Subscription < ActiveRecord::Base
+    #     acts_as_subscription
+    #   end
+    #
+    # Returns true if the update was successful, otherwise an error message.
+    def update_subscription(subscription)
+      customer_attributes = self.get_customer_attributes(subscription)
+      customer = Mousetrap::Customer.new(customer_attributes)
+      customer.save
+      return true
+    rescue Exception => error
+      return error.message
+    end
+      
+    # Cancels the customer with the given <tt>customer_code</tt> on the backend subscription service.
+    #
+    # Returns true if the cancellation was successful, or false otherwise.
+    def cancel_subscription!(customer_code)
+      customer = Mousetrap::Customer[customer_code]
+      result = customer.try(:cancel) 
+      return (result != nil)
+    end
+    
+    # Returns a list of subscription plans registered with the backend subscription service.
+    def plans
+      result = []
+      Mousetrap::Plan.all.each do |plan|
+        result << {
+          :name              => plan.name,
+          :code              => plan.code,
+          :active            => (plan.active == "1"),
+          :description       => plan.description,
+          # CheddarGetter returns 'monthly' etc instead of 'month' - remove trailing 'ly'.
+          :billing_frequency => plan.billing_frequency.sub(/ly$/i, ''), 
+          :recurring_charge  => plan.recurring_charge.to_f
+        }
+      end
+      
+      return result
+    end
+    
+    protected
+    
+    # Converts a Subscription instance into a hash of parameters used to update the remote 
+    # subscription service. 
+    #
+    # <tt>subscription</tt> should be a subclass of <tt>ActiveRecord::Base</tt> that implements
+    # <tt>acts_as_subscription</tt> :
+    #
+    #   class Subscription < ActiveRecord::Base
+    #     acts_as_subscription
+    #   end
+    def get_customer_attributes(subscription)
+      customer_attributes = {
+        :email                   => subscription.email,
+        :code                    => subscription.customer_code,
+        :first_name              => subscription.first_name,
+        :last_name               => subscription.last_name,
+        :subscription_attributes => {
+          :plan_code             => subscription.plan_code,
+          :billing_first_name    => subscription.first_name,
+          :billing_last_name     => subscription.last_name,
+        }
+      }
+      
+      customer_attributes[:subscription_attributes][:credit_card_number]             = subscription.cc_number             if subscription.cc_number
+      customer_attributes[:subscription_attributes][:credit_card_expiration_month]   = subscription.cc_expiration_month   if subscription.cc_expiration_month
+      customer_attributes[:subscription_attributes][:credit_card_expiration_year]    = subscription.cc_expiration_year    if subscription.cc_expiration_year
+      customer_attributes[:subscription_attributes][:billing_zip_code]               = subscription.zip_code              if subscription.zip_code
+      
+      # The mousetrap gem doesn't actually support :credit_card_verification_value for some reason - try to send in a patch sometime.
+      #customer_attributes[:subscription_attributes][:credit_card_verification_value] = subscription.cc_verification_code if subscription.cc_verification_code
+      
+      return customer_attributes
+    end
+    
+  end
+  
+end
+    
+
+# Need to patch Mousetrap::Plan to allow us some extra information about 
+# subscription plans. By default it only returns :name and :code.
+module Mousetrap # :nodoc:
+  class Plan < Resource # :nodoc:
+    attr_accessor \
+      :active,
+      :code,
+      :name,
+      :description,
+      :billing_frequency,
+      :recurring_charge
+
+    protected
+
+    def self.attributes_from_api(attributes)
+      {
+        :active            => attributes['isActive'],
+        :code              => attributes['code'],
+        :name              => attributes['name'],
+        :description       => attributes['description'],
+        :billing_frequency => attributes['billingFrequency'],
+        :recurring_charge  => attributes['recurringChargeAmount']
+      }
+    end
+  end
+end
+

data/lib/acts_as_subscription/backend/dummy_client.rb

@@ -0,0 +1,49 @@
+module ActsAsSubscription::Subscription::Backend
+  
+  class DummyClient # :nodoc:
+    
+    def initialize(user, password, product_code)
+      true
+    end
+    
+    def create_subscription(options)
+      true
+    end
+    
+    def update_subscription(options)
+      true
+    end
+    
+    def cancel_subscription!(customer_code)
+      true
+    end
+    
+    def plans
+      [{
+        :code               =>'FREE', 
+        :name               =>'Free',  
+        :active             =>true, 
+        :description        =>'The price is right!', 
+        :billing_frequency  =>'month',
+        :recurring_charge   =>0.0
+      }, {
+        :code               =>'PERSONAL', 
+        :name               =>'Personal', 
+        :active             =>true, 
+        :description        =>'Single-user. can access calendars, reminders and to-dos.', 
+        :billing_frequency  =>'month', 
+        :recurring_charge   =>9.95
+      }, {
+        :code               =>'PRO', 
+        :name               =>'Pro', 
+        :active             =>true, 
+        :description        =>'All the bells and whistles.', 
+        :billing_frequency  =>'month', 
+        :recurring_charge   =>19.95
+      }]
+    end
+    
+  end
+  
+end
+    

data/lib/acts_as_subscription/backend/recurly_client.rb

@@ -0,0 +1,58 @@
+module ActsAsSubscription::Subscription::Backend
+  
+  # A backend for the Recurly recurring billing service.
+  #
+  # http://recurly.com
+  class RecurlyClient
+    
+    # Initializes the backend, and authenticates with the subscription service.
+    #
+    # Required parameters are :
+    # * <tt>user</tt> :         The login used to connect to the remote API.
+    # * <tt>password</tt> :     The password used to connect to the remote API.
+    # * <tt>product_code</tt> : The code for the product being sold.
+    def initialize(user, password, product_code)
+      false
+    end
+      
+    # Creates a customer on the backend subscription service, using the settings from the given
+    # <tt>subscription</tt> instance.
+    #
+    # <tt>subscription</tt> should be a subclass of <tt>ActiveRecord::Base</tt> that implements
+    # <tt>acts_as_subscription</tt> :
+    #
+    #   class Subscription < ActiveRecord::Base
+    #     acts_as_subscription
+    #   end
+    #
+    # Returns true if the operation was successful, otherwise an error message.
+    def create_subscription(subscription)
+      false
+    end
+      
+    # Updates a customer on the backend subscription service, using the settings from the given
+    # <tt>subscription</tt> instance.
+    #
+    # <tt>subscription</tt> should be a subclass of <tt>ActiveRecord::Base</tt> that implements
+    # <tt>acts_as_subscription</tt> :
+    #
+    #   class Subscription < ActiveRecord::Base
+    #     acts_as_subscription
+    #   end
+    #
+    # Returns true if the update was successful, otherwise an error message.
+    def update_subscription(subscription)
+      false
+    end
+      
+    # Cancels the customer with the given <tt>customer_code</tt> on the backend subscription service.
+    #
+    # Returns true if the cancellation was successful, or false otherwise.
+    def cancel_subscription!(customer_code)
+      false
+    end
+    
+  end
+  
+end
+