TrustPayRails
A simple implementation of the Trustpay payment platform to integrate into Rails apps.
Installation
Add this line to your application's Gemfile:
gem 'trust_pay_rails'
And then execute:
$ bundle
Or install it yourself as:
$ gem install trust_pay_rails
Usage
To configure the gem you can provide the following environment variables:
TRUSTPAY_ENV - [testing|production|fake_bank_url] select an environment
TRUSTPAY_AID - your identifier received after registering with Trustpay
TRUSTPAY_KEY - your key received after registering with TrustPay
You can also configure the gem with an initializer:
TrustPayRails.environment = (ENV['TRUSTPAY_ENV'] || :testing).to_sym
TrustPayRails.aid = ENV['TRUSTPAY_AID']
TrustPayRails.key = ENV['TRUSTPAY_KEY']
After configuring the gem you can create a TrustPay form using one of the provided view helpers.
<%= trust_pay_form(amt: '123.45',
cur: 'EUR',
ref: '1234567890',
rurl: trust_pay_return_url,
curl: trust_pay_cancel_url,
eurl: trust_pay_error_url,
nurl: trust_pay_notification_url,
dsc: 'a description no longer than 200 chars',
lng: I18n.locale)
%>
<%= trust_pay_card_form(amt: '123.45',
cur: 'EUR',
ref: '1234567890',
rurl: trust_pay_return_url,
curl: trust_pay_cancel_url,
eurl: trust_pay_error_url,
nurl: trust_pay_notification_url,
dsc: 'a description no longer than 200 chars',
lng: I18n.locale)
%>
To generate the TrustPay notification urls use the provided generator:
rails g trust_pay_rails:routes
Now go and fill in the generated TrustPayRails controller with your custom application callback logic.
Development
After checking out the repo, run bin/setup
to install dependencies. Then, run bin/console
for an interactive prompt that will allow you to experiment.
To install this gem onto your local machine, run bundle exec rake install
. To release a new version, update the version number in version.rb
, and then run bundle exec rake release
to create a git tag for the version, push git commits and tags, and push the .gem
file to rubygems.org.
Contributing
- Fork it ( https://github.com/[my-github-username]/trust_pay_rails/fork )
- 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 a new Pull Request