Mollie API client for Ruby
Accepting iDEAL, Mister Cash, Creditcard, and paysafecard online payments without fixed monthly costs or any punishing registration procedures. Just use the Mollie API to receive payments directly on your website.
Requirements
To use the Mollie API client, the following things are required:
- Get yourself a free Mollie account. No sign up costs.
- Create a new Website profile to generate API keys (live and test mode) and setup your webhook.
- Now you're ready to use the Mollie API client in test mode.
- In order to accept payments in live mode, payment methods must be activated in your account. Follow a few of steps, and let us handle the rest.
Installation
Add this line to your application's Gemfile:
gem 'mollie-ruby', require: 'mollie'
And then execute:
$ bundle
Using from github source
If you want to use the latest 'edge' code, you can use this line in your Gemfile:
gem 'mollie-ruby', github: 'pero-ict-solutions/mollie-ruby', require: 'mollie'
Usage
the most basic way of getting paid is to prepare the payment on the Mollie server and then redirect the user to the provided paymentUrl
. Make sure you store the payment id
for further references. When the user makes a payment, Mollie will call the provided redirect_url
webhook with the id
as the POST parameter.
Prepare payment
amount = 99.99
description = "My Cool product"
redirect_url = "http://mystore.com/orders/update"
client = Mollie::Client.new(api_key)
response = client.prepare_payment(amount, description, redirect_url)
payment_id = response["id"]
redirect_to response["links"]["paymentUrl"]
Get status
client = Mollie::Client.new(api_key)
response = client.payment_status(payment_id)
response["status"]
Contributing
- Fork it
- Create your feature branch (
git checkout -b my-new-feature
) - Commit your changes (
git commit -am 'Add some feature'
) - Push to the branch (
git push origin my-new-feature
) - Create new Pull Request