Package to simplify including the Adyen payments services into a Ruby application.
Ruby JavaScript HTML
Latest commit 49a98d2 Dec 22, 2016 @mvz mvz committed on GitHub Merge pull request #164 from wvanbergen/fix-integration-tests
Use HPP::Request instead of missing HPP::Client in integration test

Adyen Build Status

Package to simplify including 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 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.