Paymill subscriptions on Rails 4.0.1 and ruby-2.0.0-p247, deployed on Heroku. This code is adapted from Railscast #288 and based on ruby wrapper for the Paymill API gem paymill-ruby. See also Paymill API reference: Paymill API/v2 documentation
Important information for the credit card data in your HTML form:
With the payment form, it is essential that you do not put a name attribute with the <input> tags for credit card data! In this way, the credit card data will not be returned to your server, and you will stay outside the legal provisions concerning the storage of such data (PCI compliance). The only data which Paymill on Rails stores locally infact, are Plans and Subscriptions, which are not sensible and absolutely PCI compliant.
See current Paymill on Rails data model
ActiveRecord::Schema.define(version: 20121207103300) do
create_table "plans", force: true do |t|
t.string "paymill_id"
t.string "name"
t.float "price"
t.datetime "created_at"
t.datetime "updated_at"
end
create_table "subscriptions", force: true do |t|
t.integer "plan_id"
t.string "email"
t.string "name"
t.string "paymill_id"
t.datetime "created_at"
t.datetime "updated_at"
end
end
For further reading see also payment form and security standards
Since the release of paymill_on_rails gem 0.0.5, PaymillOnRails becomes a Mountable Rails Engine for Rails 4. Set up a subscription payment integrating it with your existing Rails application service is now very simple just following nex steps:
1) register for a test account at paymill.com and create the subscription plans, also called Offers (read more, which are how Subscription Plans are called in Paymill.
$ rails new myapp && cd myapp
$ echo "gem 'paymill_on_rails'" >> Gemfile
$ bundle update
$ rake paymill_on_rails:install:migrations
$ rake db:migrate
Myapp::Application.routes.draw do
root 'paymill_on_rails/plans#index' #(or use another path)
mount PaymillOnRails::Engine => "/paymill_on_rails"
end
4) Login in with your Paymill account and follow Dasboard --> My Account --> Settings --> APY Keys, to see your keys and set PAYMILL_PUBLIC_KEY/API_KEY accordingly.
$ env | grep _KEY
PAYMILL_PUBLIC_KEY=11111111111111111111111
API_KEY=a1b2c3d4e5f6g7h8i9l1i2m3
$ rake paymill_on_rails:import_plans
In your rails app run
# if new rails app (not initialized by git)
$ git init
$ git add .
$ git commit -am "first commit"
# then create & push on Heroku
$ heroku create
$ heroku config:add BUNDLE_WITHOUT="development:test"
$ git push heroku master
# set up DB and import Paymill's plans
$ heroku rake db:migrate
$ heroku rake paymill_on_rails:import_plans
# set up Heroku environment variables
$ heroku config:add API_KEY='your-own-api-key'
$ heroku config:add PAYMILL_PUBLIC_KEY='your-own-public-key'
PATH
remote: .
specs:
paymill_on_rails (0.0.6)
paymill (~> 0.4.0)
rails (~> 4.0.0)
GEM
remote: https://rubygems.org/
specs:
actionmailer (4.0.1)
actionpack (= 4.0.1)
mail (~> 2.5.4)
actionpack (4.0.1)
activesupport (= 4.0.1)
builder (~> 3.1.0)
erubis (~> 2.7.0)
rack (~> 1.5.2)
rack-test (~> 0.6.2)
activemodel (4.0.1)
activesupport (= 4.0.1)
builder (~> 3.1.0)
activerecord (4.0.1)
activemodel (= 4.0.1)
activerecord-deprecated_finders (~> 1.0.2)
activesupport (= 4.0.1)
arel (~> 4.0.0)
activerecord-deprecated_finders (1.0.3)
activesupport (4.0.1)
i18n (~> 0.6, >= 0.6.4)
minitest (~> 4.2)
multi_json (~> 1.3)
thread_safe (~> 0.1)
tzinfo (~> 0.3.37)
arel (4.0.1)
atomic (1.1.14)
builder (3.1.4)
erubis (2.7.0)
hike (1.2.3)
i18n (0.6.5)
json (1.8.1)
mail (2.5.4)
mime-types (~> 1.16)
treetop (~> 1.4.8)
mime-types (1.25)
minitest (4.7.5)
multi_json (1.8.2)
paymill (0.4.0)
json
polyglot (0.3.3)
rack (1.5.2)
rack-test (0.6.2)
rack (>= 1.0)
rails (4.0.1)
actionmailer (= 4.0.1)
actionpack (= 4.0.1)
activerecord (= 4.0.1)
activesupport (= 4.0.1)
bundler (>= 1.3.0, < 2.0)
railties (= 4.0.1)
sprockets-rails (~> 2.0.0)
railties (4.0.1)
actionpack (= 4.0.1)
activesupport (= 4.0.1)
rake (>= 0.8.7)
thor (>= 0.18.1, < 2.0)
rake (10.1.0)
sprockets (2.10.0)
hike (~> 1.2)
multi_json (~> 1.0)
rack (~> 1.0)
tilt (~> 1.1, != 1.3.0)
sprockets-rails (2.0.1)
actionpack (>= 3.0)
activesupport (>= 3.0)
sprockets (~> 2.8)
sqlite3 (1.3.8)
thor (0.18.1)
thread_safe (0.1.3)
atomic
tilt (1.4.1)
treetop (1.4.15)
polyglot
polyglot (>= 0.3.1)
tzinfo (0.3.38)
PLATFORMS
ruby 2.0.0
DEPENDENCIES
paymill_on_rails!
sqlite3
See apalancat gem paymill-rails. More in general see the Search repository results on github.
(The MIT License)
Copyright (c) 2013 Luca G. Soave
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.