dreamable / payola

Drop-in Rails engine for accepting payments with Stripe

Payola

Payments with Stripe for your Rails application.

What is my changes?

This is a fork of https://github.com/payolapayments/payola, which is not maintained by owners. It has following changes:

• Use the latest code, to fix the "undefined method `event_retriever=' for StripeEvent:Module" error.
• Make PDF receipt works
  • add the "docverter" dependency to gemspec which is to convert html to PDF
  • Removing missing file ApplicationHelper from receipt_mailer.rb
  • Remove @sale.guid from Receipt
• Update the configuration template: initializer.rb
  • Add more commonly used configuration & examples
  • Add template for endpoint handling.
  • Add PDF receipt configuration by default.
• Combine & Clean DB migration files
• Make checkout form support custom_fields, similar with checkout button.

What does this do?

Payola is a drop-in Rails engine that lets you sell one or more products by just including a module in your models. It includes:

• An easy to embed, easy to customize, async Stripe Checkout button
• Asynchronous payments, usable with any background processing system
• Full webhook integration
• Easy extension hooks for adding your own functionality
• Customizable emails

To see Payola in action, check out the site for Mastering Modern Payments: Using Stripe with Rails. Read the book to find out the whys behind Payola's design.

Installation

Add Payola to your Gemfile:

gem 'payola-payments'
gem 'payola-payments', :git => 'https://github.com/dreamable/payola.git' # to use this branch

Run the installer:

$ rails g payola:install
$ rake db:migrate

(Note: do not run rake payola:install:migrations. Payola's migrations live inside the gem and do not get copied into your application.)

Optionally, tell Stripe about your application. Add this as a webhook in your Stripe dashboard:

https://your.website.example.com/payola/events

Additional Setup Resources

One-time payments

Configuration options

Subscriptions

TODO

• Multiple subscriptions per customer
• Affiliate tracking
• Easy metered billing

License

Please see the LICENSE file for licensing details.

Changelog

Please see CHANGELOG.md.

Contributing

1. Fork the project
2. Make your changes, including tests that exercise the code
3. Summarize your changes in CHANGELOG.md
4. Make a pull request

Version announcements happen on the Payola Payments Google group and @payolapayments.

Author

Pete Keen, @zrail, https://www.petekeen.net