Checkout Sessions & Payment Forms

Stripe Checkout Sessions

The Stripe Connect - Marketplace plugin is built on top of Stripe's Checkout product. Checkout is a pre-built payment form optimised for conversion (read more about it here). Each time a customer goes to purchase a good/service from a merchant on your marketplace, you will use the plugin to create a Checkout Session. The Checkout Session is a programmatic representation of what your customers see on the payment form.

Checkout Sessions can be hosted on a Stripe-hosted webpage or in your own app.

See the 'Embedding Checkout Sessions in your app' section of the documentation for instructions on how to embed Checkout Sessions in your app

In the example below, a customer is purchasing a pair of socks for €15. The Checkout Session is hosted on a Stripe webpage (see the URL: 'checkout.stripe.com').

The Stripe Connect - Marketplace plugin allows you to create Checkout Sessions for one-off purchases and for subscription products.

Database setup

You will need to set your database up to process transactions. At a minimum, I recommend you create a custom data type called 'transaction' (or something similar) that has the following fields:

Field	Type	Description
amount	number	the total value of the transaction (in cents, or equivalent)
checkout session id	text	the unique ID Stripe gives to each checkout session
paymentIntent ID	text	a PaymentIntent guides you through the process of collecting a payment from your customer. The paymentIntent ID is the unique ID for each PaymentIntent created
paymentIntent Status	text	the status of each PaymentIntent. Can be used to track the status of transactions.
seller account id	text	the unique ID of the seller's Stripe account