Stripe Checkout (Subscription with price id)

Link to stripe docs: https://docs.stripe.com/api/checkout/sessions/create

---

Parameters:

success_url

In this field you should enter the URL that the user will be taken to once they make a successful payment.

Link to Stripe docs: https://docs.stripe.com/api/checkout/sessions/create#create_checkout_session-success_url

price_id

In this field you should enter the price id of a product you have created in stripe.

Your price id should look something like this: price_1PbaGKLpgKvw6WCMvjvexif

cancel_url

In this field you should enter the URL that the user should be taken to when they cancel the payment.

Users cancel the payment by clicking the back button in the checkout session portal.

quantity

In this field you should enter the quantity of the line item being purchased

Link to Stripe docs: https://docs.stripe.com/api/checkout/sessions/create#create_checkout_session-line_items-quantity

Adjustable quantity (optional)

If your users will be choosing the quantity, you will need to append the following code to the api calls body.

&line_items[0][adjustable_quantity][enabled]=_*_adjustable_quantity_enabled_*_&&line_items[0][adjustable_quantity][minimum]=_*_adjustable_quantity_minimum_*_line_items[0][adjustable_quantity][maximum]=_*_adjustable_quantity_maximum_*_

This code introduces the following parameters:

• adjustable_quantity_enabled - this field should be set to either "true" or "false".

• adjustable_quantity_minimum - In this field you should enter the minimum quantity the user is able to select.

• adjustable_quantity_maximum - In this field you should enter the maximum quantiy the user is able to select.

Note that the "quantity" field is still required as this will be used to set the initial quantity.

Link to Stripe docs: https://docs.stripe.com/api/checkout/sessions/create#create_checkout_session-line_items-adjustable_quantity

customer_id

In this field you should enter the users stripe customer id.

This field is not required to capture a payment however with a customer id you are able to easily identify and save information about customers with stripe.

mode

In this field you should enter the following value: subscription

This parameter typically takes in one of the following values:

payment - Accept one-time payments for cards, iDEAL, and more.

setup - Save payment details to charge your customers later.

subscription - Use Stripe Billing to set up fixed-price subscriptions.

Here is a link to the relevant Stripe documentation: https://docs.stripe.com/api/checkout/sessions/create#create_checkout_session-mode

metadata[custom_value] (optional)

If you need to pass custom data through the checkout session you can do so by creating custom fields in the metadata, you can create as many as needed, all you have to do is replace "custom_value" with a name that makes sense for your use case.

When a response is returned from a checkout session, you will be able to access these custom values.

As an example, you might create a field called metadata[users_bubble_id], then when a checkout session is created you enter the current users id into this field. When the user completes a checkout session you will get a response and in that response under 'metadata', you will have access to the user id you entered.