= Active Merchant for Mollie iDeal

This gem contains an extension of ActiveMerchant [http://www.activemerchant.org] with support for the Dutch payment service provider Mollie [http://www.mollie.nl]. The extension allows you to make iDeal transactions based on the Mollie iDeal API.

== Installation

To install as a gem using Bundler, add the following to your Gemfile:

gem "active_merchant_mollie"

Run bundle install to install the gem.

You can also install as a Rails plugin:

./script/plugin install git://github.com/bluetools/active_merchant_mollie.git

== Usage

Before you start using this gem, please read the API documentation of Mollie on their website: https://www.mollie.nl/beheer/betaaldiensten/documentatie/ideal. Make sure you have a Mollie account and know your 'partner id'.

=== Create a new purchase

@gateway = ActiveMerchant::Billing::MollieIdealGateway.new(:partner_id => your_partner_id) @response = @gateway.setup_purchase(1000, { :return_url => "http://yourwebsite.com/ideal/return", :report_url => "http://yourwebsite.com/ideal/report", :bank_id => bank_id, :description => "Description of this transaction" })

Store the transaction id in your database with a reference to the original order

@transaction_id = @response.token

Now redirect the user to the selected bank

redirect_to @gateway.redirect_url_for( @response.token )

=== Receive details of purchase

After the user returns on your website or Mollie requests you report URL, you should check the state of the purchase. Based in the transaction id you can update the state of your order in your database.

The token usually sits in the transaction_id GET parameter

@token = params[:transaction_id]

@gateway = ActiveMerchant::Billing::MollieIdealGateway.new(:partner_id => your_partner_id) @details_response = @gateway.details_for( @token )

if @details_response.success? # The payment was successfull, update the state in your database else # Something went wrong, inspect the error message puts @details_response.message end

== Maintainer

This gem is based on ActiveMerchant and abstracted from the MoneyBird [http://www.moneybird.nl] project. For more information ask the MoneyBird team via mailto:[email protected]