Skip to content

Latest commit

 

History

History
56 lines (36 loc) · 2.26 KB

README.rdoc

File metadata and controls

56 lines (36 loc) · 2.26 KB
Raw

Active Merchant for Mollie iDeal ↑

This gem contains an extension of ActiveMerchant [www.activemerchant.org] with support for the Dutch payment service provider Mollie [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: 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 [www.moneybird.nl] project. For more information ask the MoneyBird team via [email protected]