Postfinance Checkout

Short description and motivation.

Usage

Add a transaction_id field to your orders model:

rails generate migration AddTransactionIdToOrders transaction_id:string

Configure the gem and set the callbacks:

Postfinancecheckout.configure do |config|
  config.space_id = 12345
  config.app_user_id = 56789
  config.app_user_key = "my_secret_key"

  config.on_success = -> (transaction_id) do
    order = Order.find_by(transaction_id: transaction_id)
    order.update(status: :paid)

    PaymentSuccessMailer.deliver_later(order)
  end

  config.on_failure = -> (transaction_id) do
    order = Order.find_by(transaction_id: transaction_id)
    order.update(status: :failed)

    PaymentFailedMailer.deliver_later(order)
  end
end

Create a transaction and store the transaction ID:

transaction = Postfinancecheckout::Transaction.new(
  amount: 34.5,
  order_number: '1234',
  email: 'test@example.com',
  address: {
    first_name: 'Testbenutzer',
    last_name: 'Muster',
    street: 'Hauptstrasse 123',
    post_code: 3019,
    city: 'Chäs und Brot',
    state: 'BE',
    country_code: 'CH'
  }
)
transaction.save

@order.update(transaction_id: transaction.id)

Once you have saved the transaction, generate the payment URL and redirect the user:

redirect_to transaction.payment_url

Installation

Add this line to your application's Gemfile:

gem "postfinancecheckout-rails"

And then execute:

$ bundle

Or install it yourself as:

$ gem install postfinancecheckout-rails

Development

Build the gem:

rake build

Push it to rubygems.org:

rake release

Contributing

Contribution directions go here.

License

The gem is available as open source under the terms of the MIT License.