Skip to content
Package to simplify including the Adyen payments services into a Ruby application.
Ruby JavaScript HTML
Latest commit e3203af May 17, 2016 @wvanbergen Final release of 2.0.0

Adyen Build Status

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

Note: this library is corrently undergoing a major rewrite. Information in this README is about the still unreleased version of this library. If you want information about the last released version, check out version 1.6.0.

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

  • Client-to-Adyen communication using Hosted Payment Pages (HPP).
  • Server-to-Adyen communication using their REST webservice.
  • Adyen-to-server communications using notifications.

This library aims to ease the implementation of all these modes into your Rack 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.


  • See the project wiki to get started.
  • Check out the example server for an example implementation of the HPP payment flow, and an implementation of self-hosted a payment flow that uses the REST webservice. To start the example server, run bundle exec rackup in the root of this project.
  • Complete RDoc documentation can be found on
  • For more information about Adyen, see
  • For more information about integrating Adyen, see their manuals. Of primary interest are the HPP integration manual for Adyen::Form, and the API integration manual for Adyen::REST.

The library doesn't have any dependencies, but making Nokogiri available in your environment will greatly improve the speed of any XML and HTML processing.


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

  • documents the changes between releases.
  • Check out if you want to help out with this project.
Something went wrong with that request. Please try again.