Stripe

Most likely with Stripe, you will need a minimum of 3 keys that you can retrieve after you sign up for their services. After getting an account, you need to use API keys to get access to them.

• a public key: this key is shareable and will be exposed on your frontend. It is useful for rendering the UI.
• a secret key: per nature, this should be kept secret server-side. It will allow your service layer to communicate with Stripe servers.
• a signing secret: per nature, it should be kept secret server-side. It will help verify the signature.

Stripe has its own flow and concepts that you can read about within Stripe’s documentation.

The Remix Run Furniture v2 boilerplate includes a full Stripe Integration, including a confirmation webhook.

On the checkout page, we render the Stripe component, which does 3 things:

• makes the cart immutable
• creates a payment intent (server-to-server) via the service layer
• uses the public key to render the UI (the Stripe JS client is doing that for us)

In this boilerplate, we decided to save the cart in our own service layer, so we push the order to Crystallize only when the payment is successful.

Upon Stripe confirmation (client-side), we redirect to the `/order/cart/${cartId}` page. This page is actually waiting for the cart to be saved as an order in Crystallize.

Indeed, while everything is happening, Stripe (with a correctly configured webhook) will be triggered and the endpoint will be called.

The endpoint, when the event is a `payment_intent.succeeded` event:

• creates a customer in Crystallize, if one does not exist yet
• creates the order in Crystallize
• updates the cart from placed to paid, allowing the waiting page to update to the order confirmation

This boilerplate is also using our Node Service API Request Handlers that include 2 handlers to speed up your Stripe integration.

This NextJS eCommerce boilerplate includes Stripe Integration.

The most interesting parts are:

• Intent Creation
• Success Management
• Order Confirmation
• Creating the Order in Crystallize

Note: As mentioned in the code, this boilerplate does not rely on webhooks.