---
title: Stripe
slug: stripe
createdAt: 2022-10-31T10:13:12.000Z
---

To successfully set up an integration with Stripe, you need to generate data for six different fields:

- Publishable key
- Secret key
- Webhook signing secret
- Invoice line format
- Payment methods
- Webhook URL (this will be prefilled)

Most of this data can be retrieved from the [Stripe dashboard](https://dashboard.stripe.com/). Go there first to:

### Collect the API keys

1. Head to the **Developers** section in your settings and subsequently, **API keys**
2. Copy the Publishable key and paste it into Fiona
3. Reveal the Secret key, then copy and paste it into Fiona



![](https://api.archbee.com/api/optimize/Jb5LCrq9-vEh7pDapzR1e/_1_0C2t8z8Uxth8212z6X_image.png)

***Tip!**: You can also set up a test integration for testing purposes. Make sure you have both your Fiona integration and your Stripe account in test mode. It is not possible to use a live key in combination with a Fiona test integration or vice versa. Read more about testing Stripe payments [here](https://docs.stripe.com/testing).*

The following step is to:

### Set up the webhook

1. Head to **Webhooks**
2. Add an endpoint. Copy and paste here the URL from your Stripe integration card in Fiona.
3. Add events:
   - checkout.session.async\_payment\_failed&#x20;
   - checkout.session.async\_payment\_succeeded
   - checkout.session.completed
   - checkout.session.expired



::Image[]{src="https://api.archbee.com/api/optimize/Jb5LCrq9-vEh7pDapzR1e/f1_1hQM98M5-nsgm5noPr_image.png" size="66" width="636" height="637" position="center" showCaption="false"}

After this, you can:

### Get the Webhook Signing secret

1. Click on the newly created endpoint
2. Reveal and copy the Signing secret and paste it into Fiona



::Image[]{src="https://api.archbee.com/api/optimize/Jb5LCrq9-vEh7pDapzR1e/iN7WKPdfjpG8dqSbpYAmc_image.png" size="64" width="673" height="485" position="center" caption="Webhook signing secret example" alt="Webhook signing secret example" showCaption="true"}

### Invoice line format & Payment methods

An invoice line format can help you quickly identify individual payments in your provider's dashboard. You can enter the format yourself:

::Image[]{src="https://api.archbee.com/api/optimize/Jb5LCrq9-vEh7pDapzR1e/TqoFnDYdb_-5Jh5k1I300_image.png" size="70" width="705" height="50" caption="Line format example" position="flex-start" showCaption="true"}

The available payment methods are indicated as such:

::Image[]{src="https://api.archbee.com/api/optimize/Jb5LCrq9-vEh7pDapzR1e/J-qMmvfK7FzDzMdMMhJEK_image.png" size="70" width="706" height="50" caption="Payment methods" position="flex-start" showCaption="true"}

Before adding payments methods in Fiona, make sure they are enabled on your Stripe Dashboard.&#x20;

Check out Stripe's [documentation](https://stripe.com/docs/api/payment_methods/object) for more information on formatting other payment methods.

