Stripe Checkout (payment + no 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 is taken to when they make a successful payment.

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

mode

In this field you should enter the following value: payment

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-m

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.

unit_amount

In this field you should enter the amount the user is going to be charged, this value should be entered in cents, for example 1000 = $10

currency

In this field you should enter the currency code for the amount to be paid, for example aud or usd.

this value must be in lower case.

Here is a link to a list of currency codes accepted by Stripe: https://docs.stripe.com/currencies

name

In this field you should enter the name of the product that will be displayed to the user in the checkout portal.

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

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.