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

# Use Stripe as payment provider

> Connect Stripe as your Firmhouse payment provider using a Stripe API key, supporting recurring credit card payments and one-time subscription charges.

Firmhouse connects to Stripe payments using a Stripe API key. You can connect your subscription payments to the same account or open a new one to keep them separate.

## Setting Up Stripe

### Steps

1. [Locate an API key in your Stripe dashboard](https://support.stripe.com/questions/locate-api-keys-in-the-dashboard) or create a new public API key and secret API key.
2. Create a Stripe endpoint secret as described below.

## Creating a Webhook for All Events

Go to [https://dashboard.stripe.com/webhooks](https://dashboard.stripe.com/webhooks) and create a webhook that points to the URL that's shown in the Firmhouse portal. Stripe will then provide you with a "Stripe Endpoint Secret."

The webhook events to enable in Stripe are:

* `charge.succeeded`
* `charge.failed`
* `charge.pending`
* `charge.refunded`
* `charge.refund.updated`
* `charge.dispute.closed`
* `payment_intent.succeeded`
* `payment_intent.payment_failed`
* `source.chargeable`
* `source.failed`

## Configuring Stripe in Firmhouse

### Steps

1. In your Firmhouse project, navigate to **Settings > Payments**.
2. Select **Stripe** as your payment provider.
3. Select the currency you want to use.
4. Add your Stripe public API key.
5. Add your Stripe secret API key.
6. Add the Stripe endpoint secret from the webhook you created.
7. Enable the desired payment methods (iDEAL | Wero, credit cards, etc.).

<img src="https://mintcdn.com/firmhousebv/i0tAuZcoMZU4WKIb/images/docs-configure-payment-providers-stripe-settings-dev-aa.png?fit=max&auto=format&n=i0tAuZcoMZU4WKIb&q=85&s=b6cc6aea3726b52b1c197a3c1aec2ad0" alt="Firmhouse Payments Settings with Stripe" width="2880" height="1960" data-path="images/docs-configure-payment-providers-stripe-settings-dev-aa.png" />
