> ## Documentation Index
> Fetch the complete documentation index at: https://shipfree.revoks.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Payment Providers

> Stripe, Polar, Lemon Squeezy, and Creem configuration.

# Payment providers

ShipFree ships with Stripe, Polar, Lemon Squeezy, and Creem adapters. Configure one provider and set `PAYMENT_PROVIDER` (`stripe`, `polar`, `lemonsqueezy`, or `creem`).

## Stripe

Required:

* `STRIPE_SECRET_KEY`
* `STRIPE_WEBHOOK_SECRET`
* `STRIPE_PRICE_ID`

Optional public price IDs for UI display:

* `NEXT_PUBLIC_STRIPE_PRICE_STARTER_MONTHLY`
* `NEXT_PUBLIC_STRIPE_PRICE_STARTER_YEARLY`
* `NEXT_PUBLIC_STRIPE_PRICE_PRO_MONTHLY`
* `NEXT_PUBLIC_STRIPE_PRICE_PRO_YEARLY`
* `NEXT_PUBLIC_STRIPE_PRICE_ENTERPRISE_MONTHLY`
* `NEXT_PUBLIC_STRIPE_PRICE_ENTERPRISE_YEARLY`

## Polar

Required:

* `POLAR_ACCESS_TOKEN`
* `POLAR_WEBHOOK_SECRET`
* `POLAR_ORGANIZATION_ID`
* `POLAR_PRODUCT_ID`

Optional public product IDs:

* `NEXT_PUBLIC_POLAR_PRODUCT_STARTER_MONTHLY`
* `NEXT_PUBLIC_POLAR_PRODUCT_PRO_MONTHLY`
* `NEXT_PUBLIC_POLAR_PRODUCT_ENTERPRISE_MONTHLY`

## Lemon Squeezy

Required:

* `LEMONSQUEEZY_API_KEY`
* `LEMONSQUEEZY_STORE_ID`
* `LEMONSQUEEZY_WEBHOOK_SECRET`

Optional public product IDs:

* `NEXT_PUBLIC_LEMONSQUEEZY_PRODUCT_STARTER_MONTHLY`
* `NEXT_PUBLIC_LEMONSQUEEZY_PRODUCT_PRO_MONTHLY`
* `NEXT_PUBLIC_LEMONSQUEEZY_PRODUCT_ENTERPRISE_MONTHLY`

## Creem

[Creem](https://creem.io) is an EU-based Merchant of Record with low fees. Get your API key from the dashboard under the **Developers** menu.

<Note>
  Creem uses **different API keys** for test mode and production. Set `CREEM_TEST_MODE=true`
  to target `test-api.creem.io` with your test-mode key.
</Note>

Required:

* `CREEM_API_KEY`
* `CREEM_WEBHOOK_SECRET`

Optional:

* `CREEM_TEST_MODE` (`true` to use the Creem test environment)

Optional public product IDs:

* `NEXT_PUBLIC_CREEM_PRODUCT_STARTER_MONTHLY`
* `NEXT_PUBLIC_CREEM_PRODUCT_PRO_MONTHLY`
* `NEXT_PUBLIC_CREEM_PRODUCT_ENTERPRISE_MONTHLY`

<Warning>
  If the configured provider is missing credentials, the payment system will fail at runtime.
</Warning>