Create account
Sign in
Support
Overview
Testing
checkout
·
HomePayments

Checkout migration guide

Learn how to migrate from the legacy version of Checkout to the new version.

The legacy version of Checkout presented customers with a modal dialog that collected card information, and returned a token or a source to your website. In contrast, the new version of Checkout is a smart payment page hosted by Stripe that creates payments or subscriptions. It supports Apple Pay, Dynamic 3D Secure, and many other features.

The new version of Checkout provides maximum flexibility, with support for dynamic line items, Connect, re-using existing Customers, and advanced subscription features. You can also use the client-only integration which is quicker to get started with and is suitable for simpler product catalogs.

To migrate from the legacy version to the new version, follow the guide that most closely represents your business model. Each guide recommends an integration path along with example code.

As you follow the relevant migration guide, you can also reference the conversion table for a mapping of specific parameters and configuration options between the two versions of Checkout.

Dynamic product catalog and pricing

If you are selling products where the amount or line items are determined dynamically (say, with a large product catalog or for donations), see accepting one-time payments.

You may have used the legacy version of Checkout to create a token or source on the client, and passed it to your server to create a charge. The new version of Checkout’s server integration, however, reverses this flow. You first create a Session on your server, pass its ID to your client, redirect your customer to Checkout, who then gets redirected back to your application upon success.

Before

With the legacy version of Checkout, you would display the dynamic amount and description and collect card information from your customer.

<form action="/purchase" method="POST">
  <script
    src="https://checkout.stripe.com/checkout.js"
    class="stripe-button"
    data-key="pk_test_TYooMQauvdEDq54NiTphI7jx"
    data-name="Custom t-shirt"
    data-description="Your custom designed t-shirt"
    data-amount="{{ORDER_AMOUNT}}"
    data-currency="usd">
  </script>
</form>

Next, you would send the resulting token or source to your server and charge it.

curl https://api.stripe.com/v1/customers \
  -u sk_test_4eC39HqLyjWDarjtT1zdp7dc: \
  -d email="customer@example.com" \
  -d source="{{STRIPE_TOKEN}}"

curl https://api.stripe.com/v1/charges \
  -u sk_test_4eC39HqLyjWDarjtT1zdp7dc: \
  -d customer="{{CUSTOMER_ID}}" \
  -d description="Custom t-shirt" \
  -d amount="{{ORDER_AMOUNT}}" \
  -d currency=usd

customer = Stripe::Customer.create(
  email: 'customer@example.com',
  source: data['stripeToken'],
)

charge = Stripe::Charge.create(
  customer: customer.id,
  description: 'Custom t-shirt',
  amount: order.amount,
  currency: 'usd',
)
customer = stripe.Customer.create(
  email='customer@example.com',
  source=data['stripeToken'],
)

charge = stripe.Charge.create(
  customer=customer.id,
  description='Custom t-shirt',
  amount=order.amount,
  currency='usd',
)
$customer = \Stripe\Customer::create([
  'email' => 'customer@example.com',
  'source' => $_POST['stripeToken'],
]);

$charge = \Stripe\Charge::create([
  'customer' => $customer->id,
  'description' => 'Custom t-shirt',
  'amount' => $order->amount,
  'currency' => 'usd',
]);
Map<String, Object> customerParams = new HashMap<String, Object>();
customerParams.put("email", "customer@example.com");
customerParams.put("source", request.stripeToken);
Customer customer = Customer.create(customerParams);

Map<String, Object> chargeParams = new HashMap<String, Object>();
chargeParams.put("customer", customer.id);
chargeParams.put("description", "Custom t-shirt");
chargeParams.put("amount", order.amount);
chargeParams.put("currency", "usd");
Charge charge = Charge.create(chargeParams);
const customer = await stripe.customers.create({
  email: 'customer@example.com',
  source: request.body.stripeToken,
});

const charge = await stripe.charges.create({
  customer: customer.id,
  description: 'Custom t-shirt',
  amount: order.amount,
  currency: 'usd',
});
customerParams := &stripe.CustomerParams{
    Email: stripe.String("customer@example.com"),
}
customerParams.SetSource(*request.stripeToken)
customer, _ := customer.New(customerParams)

chargeParams := &stripe.ChargeParams{
    Customer: stripe.String(customer.Id),
    Description: stripe.String("Custom t-shirt"),
    Amount: stripe.Int64(order.amount),
    Currency: stripe.String(string(stripe.CurrencyUSD)),
}
charge, _ := charge.New(chargeParams)
var customerOptions = new CustomerCreateOptions {
    Email = "customer@example.com",
    Source = request.stripeToken,
};
var customerService = new CustomerService();
Customer customer = customerService.Create(customerOptions);

var chargeOptions = new ChargeCreateOptions {
    Customer = customer.Id,
    Description = "Custom t-shirt",
    Amount = order.amount,
    Currency = "usd",
};
var chargeService = new ChargeService();
Charge charge = chargeService.Create(chargeOptions);

After

With the new version of Checkout, first create a Checkout Session on your server.

curl https://api.stripe.com/v1/checkout/sessions \
  -u sk_test_4eC39HqLyjWDarjtT1zdp7dc: \
  -d "payment_method_types[]"=card \
  -d "line_items[][price_data][product]"="{{PRODUCT_ID}}" \
  -d "line_items[][price_data][unit_amount]"=1500 \
  -d "line_items[][price_data][currency]"=usd \
  -d "line_items[][quantity]"=1 \
  -d mode=payment \
  -d success_url="https://example.com/success" \
  -d cancel_url="https://example.com/cancel"

session = Stripe::Checkout::Session.create({
  payment_method_types: ['card'],
  line_items: [
    price_data: {
      product: '{{PRODUCT_ID}}',
      unit_amount: 1500,
      currency: 'usd',
    },
    quantity: 1,
  ],
  mode: 'payment',
  success_url: 'https://example.com/success',
  cancel_url: 'https://example.com/cancel',
})
session = stripe.checkout.Session.create(
  payment_method_types=['card'],
  line_items=[{
    'price_data': {
      'product': '{{PRODUCT_ID}}',
      'unit_amount': 1500,
      'currency': 'usd',
    },
    'quantity': 1,
  }],
  mode='payment',
  success_url='https://example.com/success',
  cancel_url='https://example.com/cancel',
)
$session = \\Stripe\\Checkout\\Session::create([
  'payment_method_types' => ['card'],
  'line_items' => [[
    'price_data' => [
      'product' => '{{PRODUCT_ID}}',
      'unit_amount' => 1500,
      'currency' => 'usd',
    ],
    'quantity' => 1,
  ]],
  'mode' => 'payment',
  'success_url' => 'https://example.com/success',
  'cancel_url' => 'https://example.com/cancel',
]);
SessionCreateParams params =
  SessionCreateParams.builder()
    .addPaymentMethodType(SessionCreateParams.PaymentMethodType.CARD)
    .addLineItem(
      SessionCreateParams.LineItem.builder()
        .setPriceData(
          SessionCreateParams.LineItem.PriceData.builder()
            .setProduct(prod)
            .setUnitAmount(1500L)
            .setCurrency("usd")
            .build())
        .setQuantity(1L)
        .build())
    .setMode(SessionCreateParams.Mode.PAYMENT)
    .setSuccessUrl("https://example.com/success")
    .setCancelUrl("https://example.com/cancel")
    .build();
Session session = Session.create(params);
const session = await stripe.checkout.sessions.create({
  payment_method_types: ['card'],
  line_items: [{
    price_data: {
      product: '{{PRODUCT_ID}}',
      unit_amount: 1500,
      currency: 'usd',
    },
    quantity: 1,
  }],
  mode: 'payment',
  success_url: 'https://example.com/success',
  cancel_url: 'https://example.com/cancel',
});
params := &stripe.CheckoutSessionParams{
  PaymentMethodTypes: stripe.StringSlice([]string{
    "card",
  }),
  LineItems: []*stripe.CheckoutSessionLineItemParams{
    &stripe.CheckoutSessionLineItemParams{
      PriceData: &stripe.CheckoutSessionLineItemPriceDataParams{
        Product: stripe.String("{{PRODUCT_ID}}"),
        UnitAmount: stripe.Int64(1500),
        Currency: stripe.String(string(stripe.CurrencyUSD)),
      },
      Quantity: stripe.Int64(1),
    },
  },
  Mode: stripe.String("payment"),
  SuccessURL: stripe.String("https://example.com/success"),
  CancelURL: stripe.String("https://example.com/cancel"),
}

s, _ := session.New(params)
var options = new SessionCreateOptions
{
  PaymentMethodTypes = new List<string>
  {
    "card",
  },
  LineItems = new List<SessionLineItemOptions>
  {
    new SessionLineItemOptions
    {
      PriceData = new SessionLineItemPriceDataOptions
      {
        Product = "{{PRODUCT_ID}}",
        UnitAmount = 1500,
        Currency = "usd",
      },
      Quantity = 1,
    },
  },
  Mode = "payment",
  SuccessUrl = "https://example.com/success",
  CancelUrl = "https://example.com/cancel",
};

var service = new SessionService();
Session session = service.Create(options);

Next, pass the Session ID to your client and redirect your customer to Checkout to complete payment.

var stripe = Stripe('pk_test_TYooMQauvdEDq54NiTphI7jx');

var checkoutButton = document.getElementById('checkout-button');

checkoutButton.addEventListener('click', function() {
  stripe.redirectToCheckout({
    // Make the id field from the Checkout Session creation API response
    // available to this file, so you can provide it as argument here
    // instead of the {{CHECKOUT_SESSION_ID}} placeholder.
    sessionId: '{{CHECKOUT_SESSION_ID}}'
  }).then(function (result) {
    // If `redirectToCheckout` fails due to a browser or network
    // error, display the localized error message to your customer
    // using `result.error.message`.
  });
});
const stripe = Stripe('pk_test_TYooMQauvdEDq54NiTphI7jx');

const checkoutButton = document.getElementById('checkout-button');

checkoutButton.addEventListener('click', () => {
  stripe.redirectToCheckout({
    // Make the id field from the Checkout Session creation API response
    // available to this file, so you can provide it as argument here
    // instead of the {{CHECKOUT_SESSION_ID}} placeholder.
    sessionId: '{{CHECKOUT_SESSION_ID}}'
  })
  // If `redirectToCheckout` fails due to a browser or network
  // error, display the localized error message to your customer
  // using `error.message`.
});

The customer will be redirected to the success_url once they complete payment.

If you need to fulfill purchased goods after the payment, refer to Checkout Purchase Fulfillment.

Dynamic subscriptions

If you are providing subscription services that are dynamically determined or require support for other advanced features, see setting up a subscription.

You may have used the legacy version of Checkout to create a token or source on the client, and passed it to your server to create a customer and subscription. The new version of Checkout’s server integration, however, reverses this flow. You first create a Session on your server, pass its ID to your client, redirect your customer to Checkout, who then gets redirected back to your application upon success.

Before

With the legacy version of Checkout, you would display the subscription information and collect card information from your customer.

<form action="/subscribe" method="POST">
  <script
    src="https://checkout.stripe.com/checkout.js"
    class="stripe-button"
    data-key="pk_test_TYooMQauvdEDq54NiTphI7jx"
    data-name="Gold Tier"
    data-description="Monthly subscription with 30 days trial"
    data-amount="2000"
    data-label="Subscribe">
  </script>
</form>

Next, you would send the resulting token or source to your server to create a customer and a subscription.

curl https://api.stripe.com/v1/customers \
  -u sk_test_4eC39HqLyjWDarjtT1zdp7dc: \
  -d email="customer@example.com" \
  -d source="{{STRIPE_TOKEN}}"

curl https://api.stripe.com/v1/subscriptions \
  -u sk_test_4eC39HqLyjWDarjtT1zdp7dc: \
  -d customer="{{CUSTOMER_ID}}" \
  -d "items[0][price]"="{PRICE_ID}" \
  -d trial_period_days=30

customer = Stripe::Customer.create({
  email: 'customer@example.com',
  source: data['stripeToken'],
})

subscription = Stripe::Subscription.create({
  customer: customer.id,
  items: [{
    price: '{PRICE_ID}',
  }],
  trial_period_days: 30,
})
customer = stripe.Customer.create(
  email='customer@example.com',
  source=data['stripeToken'],
)

subscription = stripe.Subscription.create(
  customer=customer.id,
  items=[{
    'price': '{PRICE_ID}',
  }],
  trial_period_days=30,
)
$customer = \Stripe\Customer::create([
  'email' => 'customer@example.com',
  'source' => $_POST['stripeToken'],
]);

$subscription = \Stripe\Subscription::create([
  'customer' => $customer->id,
  'items' => [[
    'price' => '{PRICE_ID}',
  ]],
  'trial_period_days' => 30,
]);
Map<String, Object> customerParams = new HashMap<String, Object>();
customerParams.put("email", "customer@example.com");
customerParams.put("source", request.stripeToken);
Customer customer = Customer.create(customerParams);

Map<String, Object> subscriptionParams = new HashMap<String, Object>();
subscriptionParams.put("customer", customer.id);
HashMap<String, Object> items = new HashMap<String, Object>();
HashMap<String, Object> item = new HashMap<String, Object>();
item.put("price", "{PRICE_ID}");
items.put("0", item);
subscriptionParams.put("items", items);
subscriptionParams.put("trial_period_days", 30);
Subscription subscription = Subscription.create(subscriptionParams);
const customer = await stripe.customers.create({
  email: 'customer@example.com',
  source: request.body.stripeToken,
});

const subscription = await stripe.subscriptions.create({
  customer: customer.id,
  items: [{
    price: '{PRICE_ID}',
  }],
  trial_period_days: 30,
});
customerParams := &stripe.CustomerParams{
    Email: stripe.String("customer@example.com"),
}
customerParams.SetSource(*request.stripeToken)
customer, _ := customer.New(customerParams)

subscriptionParams := &stripe.SubscriptionParams{
    Customer: stripe.String(customer.Id),
    Items: []*stripe.SubscriptionItemsParams{
        &stripe.SubscriptionItemsParams{
            Price: stripe.String("{PRICE_ID}"),
        },
    },
    TrialPeriodDays: stripe.Int64(30),
}
subscription, _ := sub.New(subscriptionParams)
var customerOptions = new CustomerCreateOptions {
    Email = "customer@example.com",
    Source = request.stripeToken,
};
var customerService = new CustomerService();
var customer = customerService.Create(customerOptions);

var subscriptionOptions = new SubscriptionCreateOptions {
    Customer = customer.Id,
    Items = new List<SubscriptionItemOptions> {
        new SubscriptionItemOptions {
            Price = "{PRICE_ID}",
        },
    },
    TrialPeriodDays = 30,
};
var subscriptionService = new SubscriptionService();
var subscription = subscriptionService.Create(subscriptionOptions);

After

With the new version of Checkout, first create a Checkout Session on your server.

curl https://api.stripe.com/v1/checkout/sessions \
  -u sk_test_4eC39HqLyjWDarjtT1zdp7dc: \
  -d "payment_method_types[]"=card \
  -d "subscription_data[trial_period_days]"=30 \
  -d "line_items[][price]"="{PRICE_ID}" \
  -d "line_items[][quantity]"=1 \
  -d mode=subscription \
  -d success_url="https://example.com/success" \
  -d cancel_url="https://example.com/cancel"

session = Stripe::Checkout::Session.create({
  payment_method_types: ['card'],
  subscription_data: {
    trial_period_days: 30,
  },
  line_items: [{
    price: '{PRICE_ID}',
    quantity: 1,
  }],
  mode: 'subscription',
  success_url: 'https://example.com/success',
  cancel_url: 'https://example.com/cancel',
})
session = stripe.checkout.Session.create(
  payment_method_types=['card'],
  subscription_data={
    'trial_period_days': 30,
  },
  line_items=[{
    'price': '{PRICE_ID}',
    'quantity': 1,
  }],
  mode='subscription',
  success_url='https://example.com/success',
  cancel_url='https://example.com/cancel',
)
$session = \\Stripe\\Checkout\\Session::create([
  'payment_method_types' => ['card'],
  'subscription_data' => [
    'trial_period_days' => 30,
  ],
  'line_items' => [[
    'price' => '{PRICE_ID}',
    'quantity' => 1,
  ]],
  'mode' => 'subscription',
  'success_url' => 'https://example.com/success',
  'cancel_url' => 'https://example.com/cancel',
]);
Map<String, Object> params = new HashMap<String, Object>();

ArrayList<String> paymentMethodTypes = new ArrayList<>();
paymentMethodTypes.add("card");
params.put("payment_method_types", paymentMethodTypes);

HashMap<String, Object> subscriptionData = new HashMap<String, Object>();
ArrayList<HashMap<String, Object>> lineItems = new ArrayList<>();
HashMap<String, Object> lineItem = new HashMap<String, Object>();

lineItem.put("price", "{PRICE_ID}");
lineItem.put("quantity", 1);
params.put("line_items", lineItems);
params.put("mode", "subscription");

subscriptionData.put("trial_period_days", 30);
params.put("subscription_data", subscriptionData);

params.put("success_url", "https://example.com/success");
params.put("cancel_url", "https://example.com/cancel");

Session session = Session.create(params);
const session = await stripe.checkout.sessions.create({
  payment_method_types: ['card'],
  subscription_data: {
    trial_period_days: 30,
  },
  line_items: [{
    price: '{PRICE_ID}',
    quantity: 1,
  }],
  mode: 'subscription',
  success_url: 'https://example.com/success',
  cancel_url: 'https://example.com/cancel',
});
params := &stripe.CheckoutSessionParams{
    PaymentMethodTypes: stripe.StringSlice([]string{
        "card",
    }),
    SubscriptionData: &stripe.CheckoutSessionSubscriptionDataParams{
        TrialPeriodDays: stripe.Int64(30),
    },
    LineItems: []*stripe.CheckoutSessionLineItemsParams{
        &stripe.CheckoutSessionLineItemsParams{
            Price: stripe.String("{PRICE_ID}"),
            Quantity: stripe.Int64(1),
        },
    },
    Mode: stripe.String("subscription"),
    SuccessURL: stripe.String("https://example.com/success"),
    CancelURL: stripe.String("https://example.com/cancel"),
}

session, err := session.New(params)
var options = new SessionCreateOptions {
    PaymentMethodTypes = new List<string> {
        "card",
    },
    SubscriptionData = new SessionSubscriptionDataOptions {
        TrialPeriodDays = 30,
    },
    LineItems = new List<SessionLineItemOptions>
    {
        new SessionLineItemOptions
        {
            Price = "{PRICE_ID}",
            Quantity = 1,
        },
    },
    Mode = "subscription",
    SuccessUrl = "https://example.com/success",
    CancelUrl = "https://example.com/cancel",
};

var service = new SessionService();
var session = service.Create(options);

Next, pass the Session ID to your client and redirect your customer to Checkout to complete payment.

var stripe = Stripe('pk_test_TYooMQauvdEDq54NiTphI7jx');

var checkoutButton = document.getElementById('checkout-button');

checkoutButton.addEventListener('click', function() {
  stripe.redirectToCheckout({
    // Make the id field from the Checkout Session creation API response
    // available to this file, so you can provide it as argument here
    // instead of the {{CHECKOUT_SESSION_ID}} placeholder.
    sessionId: '{{CHECKOUT_SESSION_ID}}'
  }).then(function (result) {
    // If `redirectToCheckout` fails due to a browser or network
    // error, display the localized error message to your customer
    // using `result.error.message`.
  });
});
const stripe = Stripe('pk_test_TYooMQauvdEDq54NiTphI7jx');

const checkoutButton = document.getElementById('checkout-button');

checkoutButton.addEventListener('click', () => {
  stripe.redirectToCheckout({
    // Make the id field from the Checkout Session creation API response
    // available to this file, so you can provide it as argument here
    // instead of the {{CHECKOUT_SESSION_ID}} placeholder.
    sessionId: '{{CHECKOUT_SESSION_ID}}'
  })
  // If `redirectToCheckout` fails due to a browser or network
  // error, display the localized error message to your customer
  // using `error.message`.
});

The customer will be redirected to the success_url once the customer and subscription have been created.

If you need to fulfill purchased services after the payment, refer to Checkout Purchase Fulfillment.

You can also update subscription information using Checkout.

Connect platforms and marketplaces

If you are operating a Connect platform or marketplace and create payments involving connected accounts, consider using the new version of Checkout’s server integration. Follow the instructions in the Connect guide to migrate your integration.

The following example demonstrates using the Checkout Sessions API to process a direct charge. Follow the Connect guide for details on how to create destination charges.

Before

With the legacy version of Checkout, you would collect card information from your customer on the client.

<form action="/purchase" method="POST">
  <script
    src="https://checkout.stripe.com/checkout.js"
    class="stripe-button"
    data-key="pk_test_TYooMQauvdEDq54NiTphI7jx"
    data-name="Food Marketplace"
    data-description="10 cucumbers from Roger's Farm"
    data-amount="2000">
  </script>
</form>

Next, you would send the resulting token or source to your server and charge it on behalf of the connected account.

curl https://api.stripe.com/v1/charges \
  -u sk_test_4eC39HqLyjWDarjtT1zdp7dc: \
  -d source="{{TOKEN_ID}}" \
  -d description="10 cucumbers from Roger's Farm" \
  -d amount=2000 \
  -d currency=usd \
  -d application_fee_amount=200 \
  -H "Stripe-Account: {{CONNECTED_STRIPE_ACCOUNT_ID}}"

charge = Stripe::Charge.create({
  source: data['stripeToken'],
  description: "10 cucumbers from Roger's Farm",
  amount: 2000,
  currency: 'usd',
  application_fee_amount: 200,
}, {
  stripe_account: '{{CONNECTED_STRIPE_ACCOUNT_ID}}',
})
charge = stripe.Charge.create(
  source=data['stripeToken'],
  description="10 cucumbers from Roger's Farm",
  amount=2000,
  currency='usd',
  application_fee_amount=200,
  stripe_account='{{CONNECTED_STRIPE_ACCOUNT_ID}}',
)
$charge = \Stripe\Charge::create([
  'source' => $_POST['stripeToken'],
  'description' => "10 cucumbers from Roger's Farm",
  'amount' => 2000,
  'currency' => 'usd',
  'application_fee_amount' => 200,
], [
  'stripe_account' => '{{CONNECTED_STRIPE_ACCOUNT_ID}}',
]);
Map<String, Object> params = new HashMap<String, Object>();
params.put("source", request.stripeToken);
params.put("description", "10 cucumbers from Roger's Farm");
params.put("amount", 2000);
params.put("application_fee_amount", 200);
params.put("currency", "usd");

RequestOptions requestOptions = RequestOptions.builder().setStripeAccount("{{CONNECTED_STRIPE_ACCOUNT_ID}}").build();
Charge charge = Charge.create(params, requestOptions);
const charge = await stripe.charges.create({
  source: request.body.stripeToken,
  description: '10 cucumbers from Roger\'s Farm',
  amount: 2000,
  application_fee_amount: 200,
  currency: 'usd',
}, {
  stripeAccount: '{{CONNECTED_STRIPE_ACCOUNT_ID}}',
});
params := &stripe.ChargeParams{
    Description: stripe.String("10 cucumbers from Roger's Farm"),
    Amount: stripe.Int64(2000),
    Currency: stripe.String(string(stripe.CurrencyUSD)),
    ApplicationFeeAmount: stripe.Int64(200),
}
params.SetSource(*request.stripeToken)
params.SetStripeAccount("{{CONNECTED_STRIPE_ACCOUNT_ID}}")
charge, _ := charge.New(params)
var options = new ChargeCreateOptions {
    Source = request.stripeToken,
    Description = "10 cucumbers from Roger's Farm",
    Amount = 2000,
    Currency = "usd",
    ApplicationFeeAmount = 200,
};
var requestOptions = new RequestOptions {
    StripeAccount = "{{CONNECTED_STRIPE_ACCOUNT_ID}}",
};
var chargeService = new ChargeService();
Charge charge = chargeService.Create(options, requestOptions);

After

With the new version of Checkout, first create a Checkout Session on your server on behalf of the connected account.

curl https://api.stripe.com/v1/checkout/sessions \
  -u sk_test_4eC39HqLyjWDarjtT1zdp7dc: \
  -d "payment_method_types[]"=card \
  -d "line_items[][price]"="{{PRICE_ID}}" \
  -d "line_items[][quantity]"=1 \
  -d "payment_intent_data[application_fee_amount]"=200 \
  -d mode=payment \
  -d success_url="https://example.com/success" \
  -d cancel_url="https://example.com/cancel" \
  -H "Stripe-Account: {{CONNECTED_STRIPE_ACCOUNT_ID}}"

# Set your secret key. Remember to switch to your live secret key in production!
# See your keys here: https://dashboard.stripe.com/account/apikeys
Stripe.api_key = 'sk_test_4eC39HqLyjWDarjtT1zdp7dc'

session = Stripe::Checkout::Session.create({
  payment_method_types: ['card'],
  line_items: [{
    price: '{{PRICE_ID}}',
    quantity: 1,
  }],
  payment_intent_data: {
    application_fee_amount: 200,
  },
  mode: 'payment',
  success_url: 'https://example.com/success',
  cancel_url: 'https://example.com/cancel',
}, {stripe_account: '{{CONNECTED_STRIPE_ACCOUNT_ID}}'})

# Set your secret key. Remember to switch to your live secret key in production!
# See your keys here: https://dashboard.stripe.com/account/apikeys
stripe.api_key = 'sk_test_4eC39HqLyjWDarjtT1zdp7dc'

session = stripe.checkout.Session.create(
  payment_method_types=['card'],
  line_items=[{
    'price': '{{PRICE_ID}}',
    'quantity': 1,
  }],
  payment_intent_data={
    'application_fee_amount': 200,
  },
  mode='payment',
  success_url='https://example.com/success',
  cancel_url='https://example.com/cancel',
  stripe_account='{{CONNECTED_STRIPE_ACCOUNT_ID}}',
)

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
\Stripe\Stripe::setApiKey('sk_test_4eC39HqLyjWDarjtT1zdp7dc');

$session = \Stripe\Checkout\Session::create([
  'payment_method_types' => ['card'],
  'line_items' => [[
    'price' => '{{PRICE_ID}}',
    'quantity' => 1,
  ]],
  'payment_intent_data' => [
    'application_fee_amount' => 200,
  ],
  'mode' => 'payment',
  'success_url' => 'https://example.com/success',
  'cancel_url' => 'https://example.com/cancel',
], ['stripe_account' => '{{CONNECTED_STRIPE_ACCOUNT_ID}}']);

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
Stripe.apiKey = "sk_test_4eC39HqLyjWDarjtT1zdp7dc";

SessionCreateParams params =
  SessionCreateParams.builder()
    .addPaymentMethodType(SessionCreateParams.PaymentMethodType.CARD)
    .setMode(SessionCreateParams.Mode.PAYMENT)
    .setSuccessUrl("https://example.com/success")
    .setCancelUrl("https://example.com/cancel")
    .addLineItem(
      SessionCreateParams.LineItem.builder()
        .setPrice("{{PRICE_ID}}")
        .setQuantity(1L)
        .build())
    .setPaymentIntentData(
      SessionCreateParams.PaymentIntentData.builder()
        .setApplicationFeeAmount(200L)
        .build())
    .build();

RequestOptions requestOptions = RequestOptions.builder().setStripeAccount("{{CONNECTED_STRIPE_ACCOUNT_ID}}").build();
Session session = Session.create(params, requestOptions);

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
const Stripe = require('stripe');
const stripe = Stripe('sk_test_4eC39HqLyjWDarjtT1zdp7dc');

const session = await stripe.checkout.sessions.create({
  payment_method_types: ['card'],
  line_items: [{
    price: '{{PRICE_ID}}',
    quantity: 10,
  }],
  payment_intent_data: {
    application_fee_amount: 200,
  },
  mode: "payment",
  success_url: 'https://example.com/success',
  cancel_url: 'https://example.com/cancel',
}, {
  stripeAccount: '{{CONNECTED_STRIPE_ACCOUNT_ID}}',
});

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
stripe.Key = "sk_test_4eC39HqLyjWDarjtT1zdp7dc"

params := &stripe.CheckoutSessionParams{
  PaymentMethodTypes: stripe.StringSlice([]string{
    "card",
  }),
  LineItems: []*stripe.CheckoutSessionLineItemParams{
    &stripe.CheckoutSessionLineItemParams{
      Price: stripe.String("{{PRICE_ID}}"),
      Quantity: stripe.Int64(1),
    },
  },
  Mode: stripe.String("payment"),
  PaymentIntentData: &stripe.CheckoutSessionPaymentIntentDataParams{
    ApplicationFeeAmount: stripe.Int64(200),
  },
  SuccessURL: stripe.String("https://example.com/success"),
  CancelURL: stripe.String("https://example.com/cancel"),
}

params.SetStripeAccount("{{CONNECTED_STRIPE_ACCOUNT_ID}}")
s, _ := session.New(params)

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
StripeConfiguration.ApiKey = "sk_test_4eC39HqLyjWDarjtT1zdp7dc";

var options = new SessionCreateOptions
{
    PaymentMethodTypes = new List<string>
    {
        "card",
    },
    LineItems = new List<SessionLineItemOptions>
    {
        new SessionLineItemOptions
        {
            Price = "{{PRICE_ID}}",
            Quantity = 1,
        },
    },
    Mode = "payment",
    PaymentIntentData = new SessionPaymentIntentDataOptions
    {
        ApplicationFeeAmount = 200,
    },
    SuccessUrl = "https://example.com/success",
    CancelUrl = "https://example.com/cancel",
};

var requestOptions = new RequestOptions
{
    StripeAccount = "{{CONNECTED_STRIPE_ACCOUNT_ID}}",
};
var service = new SessionService();
Session session = service.Create(options, requestOptions);

Next, pass the Session ID to your client and redirect your customer to Checkout to complete payment. Make sure to provide the connected account’s ID when initializing Stripe.js.

// Initialize Stripe.js with the same connected account ID used when creating
// the Checkout Session.
var stripe = Stripe('pk_test_TYooMQauvdEDq54NiTphI7jx', {
  stripeAccount: '{{CONNECTED_STRIPE_ACCOUNT_ID}}'
});

var checkoutButton = document.getElementById('checkout-button');

checkoutButton.addEventListener('click', function() {
  stripe.redirectToCheckout({
    // Make the id field from the Checkout Session creation API response
    // available to this file, so you can provide it as argument here
    // instead of the {{CHECKOUT_SESSION_ID}} placeholder.
    sessionId: '{{CHECKOUT_SESSION_ID}}'
  }).then(function (result) {
    // If `redirectToCheckout` fails due to a browser or network
    // error, display the localized error message to your customer
    // using `result.error.message`.
  });
});
// Initialize Stripe.js with the same connected account ID used when creating
// the Checkout Session.
const stripe = Stripe('pk_test_TYooMQauvdEDq54NiTphI7jx', {
  stripeAccount: '{{CONNECTED_STRIPE_ACCOUNT_ID}}'
});

const checkoutButton = document.getElementById('checkout-button');

checkoutButton.addEventListener('click', () => {
  stripe.redirectToCheckout({
    // Make the id field from the Checkout Session creation API response
    // available to this file, so you can provide it as argument here
    // instead of the {{CHECKOUT_SESSION_ID}} placeholder.
    sessionId: '{{CHECKOUT_SESSION_ID}}'
  })
  // If `redirectToCheckout` fails due to a browser or network
  // error, display the localized error message to your customer
  // using `error.message`.
});

The customer will be redirected to the success_url once they complete payment.

If you need to fulfill purchased goods or services after the payment, refer to Checkout Purchase Fulfillment.

Saving payment methods for future use

If you are providing services that don’t charge your customers immediately, see setting up future payments.

You may have used the legacy version of Checkout to create a token or source on the client, and passed it to your server to save for later use. The new version of Checkout’s server integration, however, reverses this flow. You first create a Session on your server, pass its ID to your client, redirect your customer to Checkout, who then gets redirected back to your application upon success.

Before

With the legacy version of Checkout, you would display the charge information and collect card information from your customer.

<form action="/subscribe" method="POST">
  <script
    src="https://checkout.stripe.com/checkout.js"
    class="stripe-button"
    data-key="pk_test_TYooMQauvdEDq54NiTphI7jx"
    data-name="Cleaning Service"
    data-description="Charged after your home is spotless"
    data-amount="2000">
  </script>
</form>

Next, you would send the resulting token or source to your server to eventually create a charge.

curl https://api.stripe.com/v1/customers \
  -u sk_test_4eC39HqLyjWDarjtT1zdp7dc: \
  -d email="customer@example.com" \
  -d source="{{STRIPE_TOKEN}}"

curl https://api.stripe.com/v1/charges \
  -u sk_test_4eC39HqLyjWDarjtT1zdp7dc: \
  -d customer="{{CUSTOMER_ID}}" \
  -d description="Cleaning service" \
  -d amount="{{ORDER_AMOUNT}}" \
  -d currency=usd

customer = Stripe::Customer.create(
  email: 'customer@example.com',
  source: data['stripeToken'],
)

charge = Stripe::Charge.create(
  customer: customer.id,
  description: 'Cleaning service',
  amount: order.amount,
  currency: 'usd',
)
customer = stripe.Customer.create(
  email='customer@example.com',
  source=data['stripeToken'],
)

charge = stripe.Charge.create(
  customer=customer.id,
  description='Cleaning service',
  amount=order.amount,
  currency='usd',
)
$customer = \Stripe\Customer::create([
  'email' => 'customer@example.com',
  'source' => $_POST['stripeToken'],
]);

$charge = \Stripe\Charge::create([
  'customer' => $customer->id,
  'description' => 'Cleaning service',
  'amount' => $order->amount,
  'currency' => 'usd',
]);
Map<String, Object> customerParams = new HashMap<String, Object>();
customerParams.put("email", "customer@example.com");
customerParams.put("source", request.stripeToken);
Customer customer = Customer.create(customerParams);

Map<String, Object> chargeParams = new HashMap<String, Object>();
chargeParams.put("customer", customer.id);
chargeParams.put("description", "Cleaning service");
chargeParams.put("amount", order.amount);
chargeParams.put("currency", "usd");
Charge charge = Charge.create(chargeParams);
const customer = await stripe.customers.create({
  email: 'customer@example.com',
  source: request.body.stripeToken,
});

const charge = await stripe.charges.create({
  customer: customer.id,
  description: 'Cleaning service',
  amount: order.amount,
  currency: 'usd',
});
customerParams := &stripe.CustomerParams{
    Email: stripe.String("customer@example.com"),
}
customerParams.SetSource(*request.stripeToken)
customer, _ := customer.New(customerParams)

chargeParams := &stripe.ChargeParams{
    Customer: stripe.String(customer.Id),
    Description: stripe.String("Cleaning service"),
    Amount: stripe.Int64(order.amount),
    Currency: stripe.String(string(stripe.CurrencyUSD)),
}
charge, _ := charge.New(chargeParams)
var customerOptions = new CustomerCreateOptions {
    Email = "customer@example.com",
    Source = request.stripeToken,
};
var customerService = new CustomerService();
Customer customer = customerService.Create(customerOptions);

var chargeOptions = new ChargeCreateOptions {
    Customer = customer.Id,
    Description = "Cleaning service",
    Amount = order.amount,
    Currency = "usd",
};
var chargeService = new ChargeService();
Charge charge = chargeService.Create(chargeOptions);

After

With the new version of Checkout, first create a Checkout Session on your server using setup mode.

curl https://api.stripe.com/v1/checkout/sessions \
  -u sk_test_4eC39HqLyjWDarjtT1zdp7dc: \
  -d "payment_method_types[]"=card \
  -d mode=setup \
  -d success_url="https://example.com/success?session_id={CHECKOUT_SESSION_ID}" \
  -d cancel_url="https://example.com/cancel"

# Set your secret key. Remember to switch to your live secret key in production!
# See your keys here: https://dashboard.stripe.com/account/apikeys
Stripe.api_key = 'sk_test_4eC39HqLyjWDarjtT1zdp7dc'

session = Stripe::Checkout::Session.create(
  payment_method_types: ['card'],
  mode: 'setup',
  success_url: 'https://example.com/success?session_id={CHECKOUT_SESSION_ID}',
  cancel_url: 'https://example.com/cancel',
)

# Set your secret key. Remember to switch to your live secret key in production!
# See your keys here: https://dashboard.stripe.com/account/apikeys
stripe.api_key = 'sk_test_4eC39HqLyjWDarjtT1zdp7dc'

session = stripe.checkout.Session.create(
  payment_method_types=['card'],
  mode='setup',
  success_url='https://example.com/success?session_id={CHECKOUT_SESSION_ID}',
  cancel_url='https://example.com/cancel',
)

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
\Stripe\Stripe::setApiKey('sk_test_4eC39HqLyjWDarjtT1zdp7dc');

$session = \Stripe\Checkout\Session::create([
  'payment_method_types' => ['card'],
  'mode' => 'setup',
  'success_url' => 'https://example.com/success?session_id={CHECKOUT_SESSION_ID}',
  'cancel_url' => 'https://example.com/cancel',
]);

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
Stripe.apiKey = "sk_test_4eC39HqLyjWDarjtT1zdp7dc";

SessionCreateParams params =
  SessionCreateParams.builder()
    .addPaymentMethodType(SessionCreateParams.PaymentMethodType.CARD)
    .setMode(SessionCreateParams.Mode.SETUP)
    .setSuccessUrl("https://example.com/success?session_id={CHECKOUT_SESSION_ID}")
    .setCancelUrl("https://example.com/cancel")
    .build();

Session session = Session.create(params);

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
const Stripe = require('stripe');
const stripe = Stripe('sk_test_4eC39HqLyjWDarjtT1zdp7dc');

const session = await stripe.checkout.sessions.create({
  payment_method_types: ['card'],
  mode: 'setup',
  success_url: 'https://example.com/success?session_id={CHECKOUT_SESSION_ID}',
  cancel_url: 'https://example.com/cancel',
});

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
stripe.Key = "sk_test_4eC39HqLyjWDarjtT1zdp7dc"

params := &stripe.CheckoutSessionParams{
    PaymentMethodTypes: stripe.StringSlice([]string{
        "card",
    }),
    Mode: stripe.String(string(stripe.CheckoutSessionModeSetup)),
    SuccessURL: stripe.String("https://example.com/success?session_id={CHECKOUT_SESSION_ID}"),
    CancelURL: stripe.String("https://example.com/cancel"),
}

session, err := session.New(params)

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
StripeConfiguration.ApiKey = "sk_test_4eC39HqLyjWDarjtT1zdp7dc";

var options = new SessionCreateOptions {
    PaymentMethodTypes = new List<string> {
        "card",
    },
    Mode = "setup",
    SuccessUrl = "https://example.com/success?session_id={CHECKOUT_SESSION_ID}",
    CancelUrl = "https://example.com/cancel",
};

var service = new SessionService();
var session = service.Create(options);

Next, pass the Session ID to your client and redirect your customer to Checkout to gather payment method details.

// Initialize Stripe.js with the same connected account ID used when creating
// the Checkout Session.
var stripe = Stripe('pk_test_TYooMQauvdEDq54NiTphI7jx', {
  stripeAccount: '{{CONNECTED_STRIPE_ACCOUNT_ID}}'
});

var checkoutButton = document.getElementById('checkout-button');

checkoutButton.addEventListener('click', function() {
  stripe.redirectToCheckout({
    // Make the id field from the Checkout Session creation API response
    // available to this file, so you can provide it as argument here
    // instead of the {{CHECKOUT_SESSION_ID}} placeholder.
    sessionId: '{{CHECKOUT_SESSION_ID}}'
  }).then(function (result) {
    // If `redirectToCheckout` fails due to a browser or network
    // error, display the localized error message to your customer
    // using `result.error.message`.
  });
});
// Initialize Stripe.js with the same connected account ID used when creating
// the Checkout Session.
const stripe = Stripe('pk_test_TYooMQauvdEDq54NiTphI7jx', {
  stripeAccount: '{{CONNECTED_STRIPE_ACCOUNT_ID}}'
});

const checkoutButton = document.getElementById('checkout-button');

checkoutButton.addEventListener('click', () => {
  stripe.redirectToCheckout({
    // Make the id field from the Checkout Session creation API response
    // available to this file, so you can provide it as argument here
    // instead of the {{CHECKOUT_SESSION_ID}} placeholder.
    sessionId: '{{CHECKOUT_SESSION_ID}}'
  })
  // If `redirectToCheckout` fails due to a browser or network
  // error, display the localized error message to your customer
  // using `error.message`.
});

The customer will be redirected to the success_url once they complete flow.

From there, you can retrieve the Setup Intent from the Checkout flow and use it to prepare your transaction.

Simple product catalog with fixed pricing

If you are selling products with fixed pricing (such as t-shirts or e-books), see the guide on one-time payments to learn how to generate a code snippet to add to your website.

You may have used the legacy version of Checkout to create a token or source on the client, and passed it to your server to create a charge. The new version of Checkout, however, automatically creates the payment for you, and no server integration is required.

Client-side code

Before
After
<form action="/pay" method="POST">
  <script
    src="https://checkout.stripe.com/checkout.js"
    class="stripe-button"
    data-key="pk_test_TYooMQauvdEDq54NiTphI7jx"
    data-name="T-shirt"
    data-description="Comfortable cotton t-shirt"
    data-amount="500"
    data-currency="usd">
  </script>
</form>
<script src="https://js.stripe.com/v3"></script>
<button id="checkout-button">Pay</button>
var stripe = Stripe('pk_test_TYooMQauvdEDq54NiTphI7jx');

var checkoutButton = document.querySelector('#checkout-button');
checkoutButton.addEventListener('click', function () {
  stripe.redirectToCheckout({
    lineItems: [{
      // Define the product and price in the Dashboard first, and use the price
      // ID in your client-side code.
      price: '{PRICE_ID}',
      quantity: 1
    }],
    mode: 'payment',
    successUrl: 'https://www.example.com/success',
    cancelUrl: 'https://www.example.com/cancel'
  });
});
Before
After
<form action="/pay" method="POST">
  <script
    src="https://checkout.stripe.com/checkout.js"
    class="stripe-button"
    data-key="pk_test_TYooMQauvdEDq54NiTphI7jx"
    data-name="T-shirt"
    data-description="Comfortable cotton t-shirt"
    data-amount="500"
    data-currency="usd">
  </script>
</form>
<script src="https://js.stripe.com/v3"></script>
<button id="checkout-button">Pay</button>
const stripe = Stripe('pk_test_TYooMQauvdEDq54NiTphI7jx');

const checkoutButton = document.querySelector('#checkout-button');
checkoutButton.addEventListener('click', () => {
  stripe.redirectToCheckout({
    lineItems: [{
      // Define the product and price in the Dashboard first, and use the price
      // ID in your client-side code.
      price: '{PRICE_ID}',
      quantity: 1
    }],
    successUrl: 'https://www.example.com/success',
    cancelUrl: 'https://www.example.com/cancel'
  });
});

Server-side code

Before
After
curl https://api.stripe.com/v1/customers \
  -u sk_test_4eC39HqLyjWDarjtT1zdp7dc: \
  -d email="{{STRIPE_EMAIL}}" \
  -d source="{{STRIPE_TOKEN}}"

curl https://api.stripe.com/v1/charges \
  -u sk_test_4eC39HqLyjWDarjtT1zdp7dc: \
  -d customer="{{CUSTOMER_ID}}" \
  -d description=T-shirt \
  -d amount=500 \
  -d currency=usd

The new version of Checkout automatically creates payments for you. Once your customer has paid, they will be redirected to the successUrl configured on the client. Then learn how to fulfill orders after the payment.

Before
After
customer = Stripe::Customer.create(
  email: data['stripeEmail'],
  source: data['stripeToken'],
)

charge = Stripe::Charge.create(
  customer: customer.id,
  description: 'T-shirt',
  amount: 500,
  currency: 'usd',
)

The new version of Checkout automatically creates payments for you. Once your customer has paid, they will be redirected to the successUrl configured on the client. Then learn how to fulfill orders after the payment.

Before
After
customer = stripe.Customer.create(
  email=data['stripeEmail'],
  source=data['stripeToken'],
)

charge = stripe.Charge.create(
  customer=customer.id,
  description='T-shirt',
  amount=500,
  currency='usd',
)

The new version of Checkout automatically creates payments for you. Once your customer has paid, they will be redirected to the successUrl configured on the client. Then learn how to fulfill orders after the payment.

Before
After
$customer = \Stripe\Customer::create([
  'email' => $_POST['stripeEmail'],
  'source' => $_POST['stripeToken'],
]);

$charge = \Stripe\Charge::create([
  'customer' => $customer->id,
  'description' => 'T-shirt',
  'amount' => 500,
  'currency' => 'usd',
]);

The new version of Checkout automatically creates payments for you. Once your customer has paid, they will be redirected to the successUrl configured on the client. Then learn how to fulfill orders after the payment.

Before
After
Map<String, Object> customerParams = new HashMap<String, Object>();
customerParams.put("email", request.stripeEmail);
customerParams.put("source", request.stripeToken);
Customer customer = Customer.create(customerParams);

Map<String, Object> chargeParams = new HashMap<String, Object>();
chargeParams.put("customer", customer.id);
chargeParams.put("description", "T-shirt");
chargeParams.put("amount", 500);
chargeParams.put("currency", "usd");
Charge charge = Charge.create(chargeParams);

The new version of Checkout automatically creates payments for you. Once your customer has paid, they will be redirected to the successUrl configured on the client. Then learn how to fulfill orders after the payment.

Before
After
const customer = await stripe.customers.create({
  email: request.body.stripeEmail,
  source: request.body.stripeToken,
});

const charge = await stripe.charges.create({
  customer: customer.id,
  description: 'T-shirt',
  amount: 500,
  currency: 'usd',
});

The new version of Checkout automatically creates payments for you. Once your customer has paid, they will be redirected to the successUrl configured on the client. Then learn how to fulfill orders after the payment.

Before
After
customerParams := &stripe.CustomerParams{
    Email: stripe.String(*request.stripeEmail),
}
customerParams.SetSource(*request.stripeToken)
customer, _ := customer.New(customerParams)

chargeParams := &stripe.ChargeParams{
    Customer: stripe.String(customer.Id),
    Description: stripe.String("T-shirt"),
    Amount: stripe.Int64(500),
    Currency: stripe.String(string(stripe.CurrencyUSD)),
}
charge, _ := charge.New(chargeParams)

The new version of Checkout automatically creates payments for you. Once your customer has paid, they will be redirected to the successUrl configured on the client. Then learn how to fulfill orders after the payment.

Before
After
var customerOptions = new CustomerCreateOptions {
    Email = request.stripeEmail,
    Source = request.stripeToken,
};
var customerService = new CustomerService();
Customer customer = customerService.Create(customerOptions);

var chargeOptions = new ChargeCreateOptions {
    Customer = customer.id,
    Description = "T-shirt",
    Amount = 500,
    Currency = "usd",
};
var chargeService = new ChargeService();
Charge charge = chargeService.Create(chargeOptions);

The new version of Checkout automatically creates payments for you. Once your customer has paid, they will be redirected to the successUrl configured on the client. Then learn how to fulfill orders after the payment.

The conversion table below provides a mapping of configuration options between the two versions of Checkout. For a full list of configuration options for the new version, see the redirectToCheckout reference.

Simple subscriptions

If you are providing a simple subscription service (such as monthly access to software), see the guide on subscriptions to learn how to create a plan in the Dashboard and generate a code snippet to add to your website.

You may have used the legacy version of Checkout to create a token or source on the client, and passed it to your server to create a customer and a subscription. The new version of Checkout, however, automatically creates both the customer and the subscription for you, and no server integration is required.

Client-side code

Before
After
<form action="/subscribe" method="POST">
  <script
    src="https://checkout.stripe.com/checkout.js"
    class="stripe-button"
    data-key="pk_test_TYooMQauvdEDq54NiTphI7jx"
    data-name="Gold Tier"
    data-description="Monthly subscription"
    data-amount="2000"
    data-currency="usd"
    data-label="Subscribe">
  </script>
</form>
<script src="https://js.stripe.com/v3"></script>
<button id="checkout-button">Subscribe</button>
var stripe = Stripe('pk_test_TYooMQauvdEDq54NiTphI7jx');

var checkoutButton = document.querySelector('#checkout-button');
checkoutButton.addEventListener('click', function () {
  stripe.redirectToCheckout({
    lineItems: [{
      // Define the product and price in the Dashboard first, and use the price
      // ID in your client-side code. You may also pass a SKU id into the `price`
      // field
      price: '{PRICE_ID}',
      quantity: 1
    }],
    mode: 'subscription',
    successUrl: 'https://www.example.com/success',
    cancelUrl: 'https://www.example.com/cancel'
  });
});
Before
After
<form action="/subscribe" method="POST">
  <script
    src="https://checkout.stripe.com/checkout.js"
    class="stripe-button"
    data-key="pk_test_TYooMQauvdEDq54NiTphI7jx"
    data-name="Gold Tier"
    data-description="Monthly subscription"
    data-amount="2000"
    data-currency="usd"
    data-label="Subscribe">
  </script>
</form>
<script src="https://js.stripe.com/v3"></script>
<button id="checkout-button">Subscribe</button>
const stripe = Stripe('pk_test_TYooMQauvdEDq54NiTphI7jx');

const checkoutButton = document.querySelector('#checkout-button');
checkoutButton.addEventListener('click', () => {
  stripe.redirectToCheckout({
    lineItems: [{
      // Define the product and price in the Dashboard first, and use the price
      // ID in your client-side code.
      price: '{PRICE_ID}',
      quantity: 1
    }],
    mode: 'subscription',
    successUrl: 'https://www.example.com/success',
    cancelUrl: 'https://www.example.com/cancel'
  });
});

Server-side code

Before
After
curl https://api.stripe.com/v1/customers \
  -u sk_test_4eC39HqLyjWDarjtT1zdp7dc: \
  -d email="{{STRIPE_EMAIL}}" \
  -d source="{{STRIPE_TOKEN}}"

curl https://api.stripe.com/v1/subscriptions \
  -u sk_test_4eC39HqLyjWDarjtT1zdp7dc: \
  -d customer="{{CUSTOMER_ID}}" \
  -d "items[][price]"="{PRICE_ID}" \
  -d "items[][quantity]"=1

The new version of Checkout automatically creates subscriptions for you. Once the subscription is created, your customer will be redirected to the successUrl configured on the client. Then learn how to fulfill orders after the payment.

Before
After
customer = Stripe::Customer.create(
  email: data['stripeEmail'],
  source: data['stripeToken'],
)

subscription = Stripe::Subscription.create(
  customer: customer.id,
  items: [{
    price: '{PRICE_ID}',
    quantity: 2,
  }],
)

The new version of Checkout automatically creates subscriptions for you. Once the subscription is created, your customer will be redirected to the successUrl configured on the client. Then learn how to fulfill orders after the payment.

Before
After
customer = stripe.Customer.create(
  email=data['stripeEmail'],
  source=data['stripeToken'],
)

subscription = stripe.Subscription.create(
  customer=customer.id,
  items=[{
    price: '{PRICE_ID}',
    'quantity': 2,
  }],
)

The new version of Checkout automatically creates subscriptions for you. Once the subscription is created, your customer will be redirected to the successUrl configured on the client. Then learn how to fulfill orders after the payment.

Before
After
$customer = \Stripe\Customer::create([
  'email' => $_POST['stripeEmail'],
  'source' => $_POST['stripeToken'],
]);

$subscription = \Stripe\Subscription::create([
  'customer' => $customer->id,
  'items' => [[
    'price' => '{PRICE_ID}',
    'quantity' => 2,
  ]],
]);

The new version of Checkout automatically creates subscriptions for you. Once the subscription is created, your customer will be redirected to the successUrl configured on the client. Then learn how to fulfill orders after the payment.

Before
After
SubscriptionCreateParams params =
  SubscriptionCreateParams.builder()
    .addItem(
      SubscriptionCreateParams.Item.builder()
        .setPrice("{PRICE_ID}")
        .setQuantity(2L)
        .build())
    .setCustomer(customer.id)
    .build();

The new version of Checkout automatically creates subscriptions for you. Once the subscription is created, your customer will be redirected to the successUrl configured on the client. Then learn how to fulfill orders after the payment.

Before
After
const customer = await stripe.customers.create({
  email: request.body.stripeEmail,
  source: request.body.stripeToken,
});

const subscription = await stripe.subscriptions.create({
  customer: customer.id,
  items: [{
    price: '{PRICE_ID}',
    quantity: 2,
  }],
});

The new version of Checkout automatically creates subscriptions for you. Once the subscription is created, your customer will be redirected to the successUrl configured on the client. Then learn how to fulfill orders after the payment.

Before
After
customerParams := &stripe.CustomerParams{
    Email: stripe.String(*request.stripeEmail),
}
customerParams.SetSource(*request.stripeToken)
customer, _ := customer.New(customerParams)

subscriptionParams := &stripe.SubscriptionParams{
    Customer: stripe.String(customer.Id),
    Items: []*stripe.SubscriptionItemsParams{
        &stripe.SubscriptionItemsParams{
            Price: stripe.String("{PRICE_ID}"),
            Quantity: stripe.Int64(2),
        },
    },
}
subscription, _ := subscription.New(subscriptionParams)

The new version of Checkout automatically creates subscriptions for you. Once the subscription is created, your customer will be redirected to the successUrl configured on the client. Then learn how to fulfill orders after the payment.

Before
After
var customerOptions = new CustomerCreateOptions {
    Email = request.stripeEmail,
    Source = request.stripeToken,
};
var customerService = new CustomerService();
Customer customer = customerService.Create(customerOptions);

var subscriptionOptions = new SubscriptionCreateOptions {
    Customer = customer.id,
    Items = new List<SubscriptionItemOptions> {
        new SubscriptionItemOptions {
            Price = "{PRICE_ID}",
            Quantity = 2,
        },
    },
};
var subscriptionService = new SubscriptionService();
Subscription subscription = subscriptionService.Create(subscriptionOptions);

The new version of Checkout automatically creates subscriptions for you. Once the subscription is created, your customer will be redirected to the successUrl configured on the client. Then learn how to fulfill orders after the payment.

The conversion table below provides a mapping of configuration options between the two versions of Checkout. For a full list of configuration options for the new version, see the redirectToCheckout reference.

Parameter conversion

The new version of Checkout supports most of the functionality of the legacy version of Checkout. However, the two versions do not share the same API. The table below maps parameters and configuration options between the legacy version and the new version.

The legacy Checkout reference documents parameters accepted by the previous version. For a full list of configuration options accepted by the new version of Checkout, see the Stripe.js reference and the API reference for Checkout Sessions.

Legacy version New version Integration tips
allowRememberMe Not supported The new version of Checkout does not support Remember Me. To reuse existing customers, we recommend specifying the customer parameter when creating a Checkout Session.
amount Automatically calculated as the sum of amounts over all line_items.

Client-only integration: Automatically calculated as the sum of amounts over all prices.		 The total amount is the sum of the line items you pass to Checkout.
billingAddress Session.billing_address_collection

Client-only integration: billingAddressCollection		 Checkout automatically collects the billing address when required for fraud-prevention or regulatory purposes. Set this parameter to required to always collect the billing address.
closed cancelUrl When a customer wants to close Checkout, they either close the browser tab or navigate to the cancelUrl.
currency Session.currency

Client-only integration: The price’s currency		  
description Session.line_items.description or product.description

Client-only integration: The price’s product.description		 If you specify a price, Checkout displays an automatically computed description of how often payments occur.

If you specify Session.line_items, Checkout displays the description for each line item.
email Session.customer_email

Client-only integration: customerEmail		 If you already know your customer’s email, specify it here so they do not need to enter it again.
image Business branding
Upload your business logo or icon in the Dashboard.

Product images
Specify images for each line item withproduct.images		 Checkout uses specific images for your business’s branding and for the products you are selling.

Checkout displays your business logo by default and falls back to your business icon alongside your business name.
key No longer a parameter passed to Checkout Specify the publishable key when initializing Stripe.js as Stripe('pk_...') instead.
locale Session.locale

Client-only integration: locale		 You can specify a supported locale when creating a Checkout Session.
name product.name for prices specified in Session.line_items

Client-only integration: The price’s product.name		 If you specify a price, Checkout displays the name of the product to which the price belongs to the customer. If you specify Session.line_items, Checkout displays the name for each line item.
panelLabel submit_type Checkout automatically customizes the button text depending on the items you are selling. For one-time payments, use submit_type to customize the button text.
shippingAddress session.shipping_address_collection Collect shipping address information by passing an array of allowed_countries that you want to ship to.
token or source successUrl There is no longer a callback in JavaScript when the payment completes. As your customer is paying on a different page, set the successUrl to redirect your customer after they’ve completed payment.
zipCode Automatically collected by Checkout Checkout automatically collects the postal code when required for fraud-prevention or regulatory purposes.
Was this page helpful?
Questions? Contact us.
Developer tutorials on YouTube.
On this page
Dynamic product catalog and pricing
Dynamic subscriptions
Connect platforms and marketplaces
Saving payment methods for future use
Simple product catalog with fixed pricing
Simple subscriptions
Parameter conversion