For the complete documentation index, see llms.txt. This page is also available as Markdown.

Configuration

Configuring Stripe Payment Provider

You will need to add your Stripe Secret API key to the site's configuration, as below. Keep the keys out of committed settings files: use user secrets in development and environment variables or your host's secret store elsewhere (for example UmbCheckout__Stripe__Live__ApiKey).

  "UmbCheckout": {
    "Stripe": {
      "Test": {
        "ApiKey": "TEST STRIPE SECRET API KEY"
      },
      "Live": {
        "ApiKey": "LIVE STRIPE SECRET API KEY"
      }
    }
  }

You can find your Stripe Secret API key within your account by heading to Developers -> API keys

If the key for the active mode is missing, checkout and the Stripe screens show "No Stripe API key is configured for test mode. Set UmbCheckout:Stripe:Test:ApiKey." (or live) instead of an error page. If Stripe rejects the key, the message is "Stripe rejected the API key for the active mode (test or live). Check the Stripe settings.": the key itself, including its last 4 characters, is never shown or logged.

You also need the Stripe Webhook: it records payments, so a paid Basket is cleared even if the customer doesn't return to the success page. Add its signing secret in the same way:

  "UmbCheckout": {
    "Stripe": {
      "Test": {
        "WebHookSecret": "STRIPE TEST WEBHOOK SECRET"
      },
      "Live": {
        "WebHookSecret": "LIVE STRIPE WEBHOOK SECRET"
      }
    }
  }

You can create your WebHook Secret within your account by heading to Developers -> Webhooks

You will also need to ensure your Webhooks are configured for the Stripe API version used by the Stripe.net package UmbCheckout is built with. UmbCheckout 17 uses Stripe.net 50.x, which uses API version:

The test keys are used unless Use live API details is ticked in the Stripe settings (see below).

Stripe Settings

The Stripe settings are found in the backoffice here:

Settings -> UmbCheckout -> Stripe -> Settings

Name
Use

Use live API details

Use the Live API key and webhook secret. When unticked, the Test ones are used

Allowed Shipping Countries

The countries Stripe Checkout accepts shipping addresses for, as 2-letter ISO codes separated by commas (e.g. GB,IE). Used only when Enable Shipping is on in the configuration

Collect Phone Number

Stripe Checkout asks the customer for a phone number

Collect Promotional Emails Consent

Stripe Checkout asks the customer for consent to promotional emails (Stripe offers this for US customers)

Allow Promotional Codes

Stripe Checkout accepts promotion codes created in Stripe

Enable Abandoned Cart Recovery

Stripe can email customers who leave the checkout a link to recover it. Used only when Collect Promotional Emails Consent is on

Allow Promotional Codes On Recovered Carts

Recovered checkouts accept promotion codes. Used only with Enable Abandoned Cart Recovery

Only users with access to the Settings section can see or change the Stripe settings. Saving them writes the uSync file when uSync Stripe is installed.

Product properties

Your product can have the following optional properties

Alias
Property Type

umbCheckoutMetaData

umbCheckoutTaxRates

Last updated