Checkout Client Quickstart Beta
Use Checkout to sell products and subscriptions defined in the Dashboard.
Use the following steps to create a Checkout page that lets a customer purchase products and plans:
Step 1: Configure your Checkout settings
To begin using Checkout, log into the Stripe Dashboard, navigate to the Checkout settings. From here you will be able to enable the client integration and customize the look and feel of your checkout page.
Step 2: Configure products and plans
Before you start configuring products, first make sure you are in test mode by toggling the “View test data” button at the bottom of your dashboard menu. Next, define the goods and services you plan to sell in the Products section of the Dashboard. To create a new product, navigate to the Products section, click the New button, and select the type of product you would like to sell. The unique name and image that you supply is displayed to customers on Checkout.
One-time purchase products
When you create a product in the Dashboard, Stripe creates a default SKU with the same name as the product and generates an ID for the SKU. This SKU ID is how you refer to the product that the customer is purchasing when you start the payment process with Checkout.
Subscriptions
When you create a recurring product in the Dashboard, you are prompted to define a pricing plan. You can define multiple pricing plans with different parameters for each recurring product. Each plan has a generated ID that you can use to refer to the plan during the checkout process. You can also define free trials from here.
Step 3: Integrate Checkout on your website
To integrate Checkout on your website, you must add a snippet of code that includes the desired SKU or plan ID. You can use the Dashboard to generate the necessary code, or you can write it yourself.
In the Products section of the Dashboard, select the product that you wish to sell. In the product detail view, click the Use with Checkout button next to a SKU or plan to generate a code snippet that you can add to your website.
Copy and paste the snippet into the body of a web page to add a payment button that redirects the customer to Checkout.
The snippet adds a button to the page that, when clicked, redirects the customer to Checkout.
When your customer successfully completes their payment, they are redirected to the success URL that you specified when configuring the code snippet. Typically, this is a page on your website that informs the customer that their payment was successful. The cancel URL is the page where Checkout redirects customers when they cancel the payment process.
Checkout relies on Stripe.js. To get started, include the following script tag on your website—it should always be loaded directly from https://js.stripe.com:
<script src="https://js.stripe.com/v3/"></script>
Next, create an instance of the Stripe object by providing your publishable API key as the first parameter:
var stripe = Stripe(
'pk_test_TYooMQauvdEDq54NiTphI7jx',
{
betas: ['checkout_beta_4']
}
);When your customer is ready to pay, call
redirectToCheckout
to begin the checkout process. Pass it an array of objects that specify the
SKU or plan ID and the quantity of each item that the customer wishes to
purchase:
stripe.redirectToCheckout({
items: [
// Replace with the ID of your SKU
{sku: 'sku_123', quantity: 1}
],
successUrl: 'https://your-website.com/success',
cancelUrl: 'https://your-website.com/canceled',
}).then(function (result) {
// Display result.error.message to your customer
});The snippet calls a function that when invoked redirects the customer to
Checkout. When your customer successfully completes their payment, they are
redirected to the success URL that you specified when calling
redirectToCheckout. Typically, this is a page on your website that informs
the customer that their payment was successful. The cancel URL is the page
where Checkout redirects customers when they cancel the payment process.
The snippet adds a button to the page that, when clicked, redirects the customer to Checkout. When your customer successfully completes their payment, they are redirected to the success URL that you specified when configuring the code snippet. Typically, this is a page on your website that informs the customer that their payment was successful. The cancel URL is the page where Checkout redirects customers when they cancel the payment process.
Once payment is successful, you should fulfill the customer’s purchase.
You can use webhooks to fulfill the purchase when the
checkout.session.completed event triggers. For more details about
handling purchase fulfillment with Checkout, refer to the
documentation.
Prefilling data
You may already have collected information about your customer that you want to
prefill in the Checkout page to avoid your customers needing to enter their
payment information twice. You can prefill the customer email on the Checkout
page by providing customerEmail in the redirectToCheckout call.
stripe.redirectToCheckout({
items: [
// Replace with the ID of your SKU
{sku: 'sku_123', quantity: 1}
],
successUrl: 'https://your-website.com/success',
cancelUrl: 'https://your-website.com/canceled',
customerEmail: 'customer@domain.com'
}).then(function (result) {
// Display result.error.message to your customer
});
Next steps
Congrats! You now have a complete Checkout client integration using SKUs and plans created in the dashboard. When testing your integration with your test API key, you can use a test card number to ensure that it works correctly.