Fetching contributors…
Cannot retrieve contributors at this time
52 lines (33 sloc) 2 KB


Package to simplify including the Adyen payments services into a Ruby on Rails application.

Adyen integration relies on three modes of communication between Adyen, your server and your client/customer:

  • Client-to-Adyen communication using forms and redirects.

  • Adyen-to-server communications using notifications.

  • Server-to-Adyen communication using SOAP services.

This library aims to ease the implementation of all these modes into your application. Moreover, it provides matchers, assertions and mocks to make it easier to implement an automated test suite to assert the integration is working correctly.


Bundler / Rails 3: Add the following line to your Gemfile:

gem 'adyen'

Rails 2.x: Add the following line to your environment.rb and run rake gems:install to make the Adyen functionality available in your Rails project:

config.gem 'adyen'

The Adyen gem will happily use REXML for communication with Adyen’s SOAP API, however, if you have the Nokogiri gem installed and required the gem will use that for performance.


The gem ships with a generator for Rails 3. To create an ActiveRecord migration, mode, and ActionController for the notifications send by Adyen, run the following:

$ rails generate adyen:notification


See the project wiki on to get started. Complete RDoc documentation for the project can be found on


This package is written by Michel Barbosa and Willem van Bergen for, and made public under the MIT license (see LICENSE). Its is currently maintained by Willem van Bergen, Stefan Borsje and Eloy Duran. We are not affiliated with Adyen B.V. The software comes without warranty of any kind, so use at your own risk.