I created a simple rails SaaS site using paymill. You can check out the code on github, or keep reading for more details on using paymill with ruby and rails.

Paymill with ruby

We’ll be using the paymill-ruby gem (github), a ruby wrapper for the Paymill API. Right now it’s in a very early stage, but it works fine for the basics. To install it: gem install paymill.

The steps for accepting payments are very simple. First, create a paymill account and get the test API keys in “My Account -> Settings”. The public key is used to generate credit card tokens via paymill’s javascript bridge. For our testing, we’ll use a basic html form to get valid tokens (live demo here):

Each time we submit the form paymill gives us a new token that we can use in the terminal to do our testing. Tokens are strings beginning with tok_ and are only valid for a single transaction.

Once we have the token supply we can now fire up irb and start testing the API. For example, making a 10€ transaction with the description “Testing paymill-ruby”:

1
2
3

require 'paymill'
Paymill.api_key = "your_private_paymill_key" # private key from paymill settings
Paymill::Transaction.create amount: 1000, currency:'EUR', token: 'tok_c05cfc4f1e1b8a7cf1f5', description: 'Testing paymill-ruby'

Hopefully the transaction will appear immediately in our paymill Dashboard. For more information about what is possible with the API and the gem, check out the Paymill API Reference and the paymill-ruby source code and documentation.

Subscriptions

The paymill control panel lets you create Offers, which are how Subscription Plans are called in paymill. Once created, the plans can be used to subscribe clients via the API. Offers have names beginning with offer_. These are the plan IDs that will be needed to setup the subscription with a client and credit card.

1
2
3

client = Paymill::Client.create email: 'test@example.com', description: 'Subscription test'
payment = Paymill::Payment.create token: 'tok_2cf2314e1c619b588668', client: client.id
Paymill::Subscription.create offer: 'offer_20b8398c8d06e697bd1a', client: client.id, payment: payment.id

Rails app

Integrating paymill subscriptions in a rails app is simple. I created a sample app based on Railscast #288 Billing with stripe (code), but since the APIs are very similar it shouldn’t be difficult to convert some other stripe-based site.

First, extract the actual font from the resources fork of the file. Fondu can help with that. You can install fondu using homebrew (brew install fondu) or following this easy steps to install from source.

Once fondu is installed we need to extract the font resources:

> fondu path/to/fontfile/..namedfork/rsrc
# or
> fondu path/to/fontfile/..namedfork
# or
> fondu path/to/fontfile

Some people have found that they have to remove the /..namedfork/rsrc or the /rsrc part for it to work, It may depend on the way the font is packaged.

If the extracted font is a .ttf or .otf file, then you are done! In some cases it will be a .pfb or .bdf file, which will have to be converted. There’s a lot of resources for that, I used freefontconverter.com and worked perfectly.

–

More info on Fonts in Mac OS X

Possible resource for .dfont files (I haven’t tried it): DfontSplitter

That may cause problem with shell commands that use square brackets, such as some rake tasks. The error message is a cryptic zsh: no matches found.

The solution, found in the zsh FAQ (section 3.4), is simply adding a line in ~/.zshrc that disables globbing for a single command:

1

alias rake="noglob rake"