Configure Stripe

Learn how to configure Stripe in order to implement the integration with your Umbraco Commerce installation.

If you haven't done so yet, head on over to the Stripe Dashboard to register for a Stripe account.

Or login to the Stripe Dashboard if you already have an account.

Test & Live mode

When logged in to the Stripe Dashboard it is important to know that there are two modes you can view data and perform tasks under. These are Test mode and Live mode.

Test mode allows you to perform test transactions to ensure your solution is set up correctly.

Live mode is where real-life transactions will take place.

Use the View test data toggle switch located in the dashboard sidebar to switch between the two modes.

When in test mode the toggle switch will change color, and a test data header bar appear above the data panel.

For each of these modes, multiple settings need to be configured.

Step 2: API Keys

In order for Umbraco Commerce to communicate with Stripe securely we need to generate a series of API keys that Umbraco Commerce can use to authenticate with.

Select the Developers heading in the sidebar.
Select the API Keys sub-heading.
See your Publishable key displayed on the right-hand side.
Click the Reveal test/live key token button to view your Secret key.

Complete the steps listed above for both the Test and the Live mode to generate keys for both.

Note down the API keys.

Step 3: Webhook

For Stripe to notify Umbraco Commerce of a transaction, Stripe makes use of webhook technology to send notifications of the changing transaction statuses. By using webhooks it ensures that the system will always be notified of these status changes. This is also the case if a customer decides not to return to the store once a transaction is complete.

To register a webhook follow these steps:

Select the Developers heading in the sidebar.
Select the Webhooks sub-heading.
Click the Add Endpoint button on the right-hand side.
Enter the Umbraco Commerce callback URL. See an example below:

  https://{store_domain}/umbraco/commerce/payment/callback/stripe-checkout/{payment_method_id}/

Be sure to replace the parameters in curly brackets with the corresponding values taken from your store.

Leave the Version set to Your current version.
Select the following event types in the Events to send dropdown:
- checkout.session.completed
- review.closed
Click Add endpoint to create the webhook endpoint registration.