https://github.com/payolapayments/payola

Drop-in Rails engine for accepting payments with Stripe
https://github.com/payolapayments/payola

Last synced: 2 months ago
JSON representation

Drop-in Rails engine for accepting payments with Stripe

• Host: GitHub
• URL: https://github.com/payolapayments/payola
• Owner: payolapayments
• License: other
• Archived: true
• Created: 2014-10-01T19:00:40.000Z (over 10 years ago)
• Default Branch: master
• Last Pushed: 2018-10-15T21:22:33.000Z (about 6 years ago)
• Last Synced: 2024-05-21T01:05:28.137Z (8 months ago)
• Language: Ruby
• Homepage: http://www.payola.io
• Size: 636 KB
• Stars: 820
• Watchers: 22
• Forks: 157
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-ruby - Payola - Drop-in Rails engine for accepting payments with Stripe. (E-Commerce and Payments)

README

        
# Payola

[![Gem Version](https://badge.fury.io/rb/payola-payments.svg)](http://badge.fury.io/rb/payola-payments) [![CircleCI](https://circleci.com/gh/payolapayments/payola.svg?style=shield)](https://circleci.com/gh/payolapayments/payola) [![Code Climate](https://codeclimate.com/github/payolapayments/payola/badges/gpa.svg)](https://codeclimate.com/github/payolapayments/payola) [![Test Coverage](https://codeclimate.com/github/payolapayments/payola/badges/coverage.svg)](https://codeclimate.com/github/payolapayments/payola) [![Dependency Status](https://gemnasium.com/badges/github.com/payolapayments/payola.svg)](https://gemnasium.com/github.com/payolapayments/payola)

Payments with Stripe for your Rails application.

## 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](https://www.masteringmodernpayments.com). Read the book to find out the whys behind Payola's design.

## Installation

Add Payola to your Gemfile:

```ruby

gem 'payola-payments'

```

Run the installer:

```bash

$ 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://dashboard.stripe.com/account/webhooks):

```

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

```

## Additional Setup Resources

[One-time payments](https://github.com/payolapayments/payola/wiki/One-time-payments)

[Configuration options](https://github.com/payolapayments/payola/wiki/Configuration-options)

[Subscriptions](https://github.com/payolapayments/payola/wiki/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](CHANGELOG.md).

## Contributing

1. Fork the project

2. Make your changes, including tests that exercise the code

3. Summarize your changes in [CHANGELOG.md](CHANGELOG.md)

4. Make a pull request

Version announcements happen on the [Payola Payments Google group](https://groups.google.com/forum/#!forum/payola-payments) and [@payolapayments](https://twitter.com/payolapayments).

## Author

Pete Keen, [@zrail](https://twitter.com/zrail), [https://www.petekeen.net](https://www.petekeen.net)