Jumpstart docs logo Back to the app

Payments & Billing

Jumpstart Pro uses the Pay gem for handling payments and billing.

Accepting Payments

Jumpstart Pro supports using several payment processors depending on your needs and location of your business.

Subscriptions are associated with Accounts, which allows you to offer separate billing for each group of users. You'll commonly see this in apps that support multiple accounts like GitHub Organizations, Heroku Teams, etc.

One-time payments are also supported by Jumpstart Pro too.

Payment Processors

Stripe

Processing payments with Stripe is as simple as adding your Stripe credentials, enabling the Stripe configuration, and adding plans with Stripe IDs on them.

Stripe is integrated using Embedded Checkout which supports promo codes, calculating sales tax, and any payment methods enabled on your Stripe account.

Stripe Webhooks

The /webhooks/stripe endpoint is available in your application for handling webhooks from Stripe. Add this URL to Stripe to process activity from your account.

Stripe CLI

Stripe now requires webhooks in development and provides the Stripe CLI to forward webhooks to your local Rails server. After enabling Stripe in Jumpstart Pro, you will need to install the Stripe CLI and login. Jumpstart Pro will add the stripe listen process to Procfile.dev to forward webhooks while your Rails application is running.

stripe login
stripe listen --forward-to localhost:3000/webhooks/stripe

Once stripe CLI is running it should display your signing secret. Add it to your credentials to make sure your server can receive stripe events.

Alternatively, you can use ngrok or localtunnel to expose your Rails server to the internet so it can receive webhooks.

Paddle

Processing payments with Paddle is as simple as adding your credentials, enabling the payment processor, and adding Plans with Paddle IDs on them.

Paddle comes in two versions currently: Paddle Classic and Paddle Billing. You'll need to determine which version your Paddle account is and enable the correct version.

Paddle Webhooks

The /webhooks/paddle_billing endpoint is available in your application for handling webhooks from Paddle Billing. Add this URL to Paddle Billing to process activity from your account.

The /webhooks/paddle_classic endpoint is available in your application for handling webhooks from Paddle Classic. Add this URL to Paddle Classic to process activity from your account.

Braintree

Processing payments with Braintree is as simple as adding your credentials, enabling the payment processor, and adding Plans with the Braintree IDs on them. We handle all the heavy lifting such as calculation proration discounts to allow users to swap between monthly and yearly plans which Braintree does not support out of the box.

Braintree Webhooks

The /webhooks/braintree endpoint is available in your application for handling webhooks from Braintree. Add this URL to Braintree to process activity from your account.

Plan Credit Discount

Before using Braintree, you will need to define a plan-credit discount in your Braintree control panel. This discount will be used to properly prorate subscriptions that change from yearly to monthly billing, or from monthly to yearly billing.

The discount amount configured in the Braintree control panel can be any value you wish, as Pay will override the defined amount with our own custom amount each time we apply the coupon. This coupon is needed since Braintree does not natively support prorating subscriptions across subscription frequencies.

PayPal

PayPal is supported out of the box using Braintree for processing.

To enable PayPal in Jumpstart Pro, you'll first need to enable it in your Braintree account under the Processing Options section.