Set up your development environment

First, create a Stripe account or sign in.

Install

From the command-line, use an install script or download and extract a versioned archive file for your operating system to install the CLI.

brew install stripe/stripe-cli/stripe

brew install stripe-cli

Authenticate

Log in and authenticate your Stripe user account to generate a set of restricted keys. To learn more, see Stripe CLI keys and permissions.

stripe login

Press Enter on your keyboard to complete the authentication process in your browser.

Your pairing code is: enjoy-enough-outwit-win
This pairing code verifies your authentication with Stripe.
Press Enter to open the browser or visit https://dashboard.stripe.com/stripecli/confirm_auth?t=THQdJfL3x12udFkNorJL8OF1iFlN8Az1 (^C to quit)

Confirm setup

Now that you’ve installed the CLI, you can make a single API request to Create a product.

stripe products create \
--name="My First Product" \
--description="Created with the Stripe CLI"

Look for the product identifier (in id) in the response object. Save it for the next step.

If everything worked, the command-line displays the following response.

{
  "id": 
"prod_LTenIrmp8Q67sa",
  "object": "product",

Next, call Create a price to attach a price of 30 USD. Swap the placeholder in product with your product identifier (for example, prod_LTenIrmp8Q67sa).

stripe prices create \
  --unit-amount=3000 \
  --currency=usd \
  --product=
"{{PRODUCT_ID}}"

If everything worked, the command-line displays the following response.

{
  "id": 
"price_1KzlAMJJDeE9fu01WMJJr79o",
  "object": "price",

We recommend managing third-party dependencies using the RubyGems command-line tool, which allows you to add new libraries and include them in your Ruby projects. Check whether RubyGems is installed:

Install RubyGems

gem --version

If you get gem: command not found, download RubyGems from their downloads page.

The latest version of the Stripe Ruby server-side SDK is v19.0.0. It supports Ruby versions 2.3+.

Check your Ruby version:

ruby -v

Install the library

Create a gem file and install the generated gem using a bundler with RubyGems.

Add the latest version of the Stripe gem to a project:

bundle add stripe

Install the required gems from your specified sources:

bundle install

Now that you have the Ruby SDK installed, you can create a subscription Product and attach a Price with a couple API requests. We’re using the product identifier returned in the response to create the price in this example.

require 'rubygems'
require 'stripe'

# Don't embed any keys in production code. This is an example.
# See https://docs.stripe.com/keys-best-practices.
client = Stripe::StripeClient.new("sk_test_BQokikJOvBiI2HlWgH4olfQ2")

starter_subscription = client.v1.products.create(
  name: 'Starter Subscription',
  description: '$12/Month subscription',
)

starter_subscription_price = client.v1.prices.create(
  currency: 'usd',
  unit_amount: 1200,
  recurring: {interval: 'month'},
  product: starter_subscription['id'],
)

puts "Success! Here is your starter subscription product id: #{starter_subscription.id}"
puts "Success! Here is your starter subscription price id: #{starter_subscription_price.id}"

Save the file as create_price.rb. From the command line, cd to the directory containing the file you just saved and run:

ruby create_price.rb

If everything worked, the command line shows the following response. Save these identifiers so you can use them while building your integration.

Success! Here is your starter subscription product id: prod_0KxBDl589O8KAxCG1alJgiA6
Success! Here is your starter subscription price id: price_0KxBDm589O8KAxCGMgG7scjb