# Stripe

:::tip Available
This integration is active and ready to use on all Pro plans.
:::

Connect Stripe to Frihet to automate subscription payments and automatically synchronize payments.

## What is it for?

With Stripe integrated:

- **Recurring subscriptions** — Automatically charge every month
- **Automatic invoices** — Frihet creates invoices when there is a payment
- **Automatic reconciliation** — Payments are marked as collected instantly
- **Synchronized reports** — Your numbers in Frihet reflect Stripe's reality

## Requirements

- **Active Stripe account** — [Create one at stripe.com](https://stripe.com)
- **Admin permissions** — In your Stripe account
- **Frihet Pro or higher** — Stripe is not available on the Free plan

## Connect Stripe

### Step 1: Open integrations

1. Go to **Settings** → **Integrations**
2. Search for **Stripe**
3. Click on **Connect**

### Step 2: Authentication

1. You will be redirected to Stripe
2. Log in with your Stripe account
3. Authorize Frihet to access your account
4. Frihet redirects automatically

### Step 3: Confirm the connection

Once authorized:

```
✅ Stripe connected
Account ID: acct_XXXXXXXXX
Last synced: 2 minutes ago
```

## How it works

### Subscriptions

If you have clients in Stripe with subscriptions:

1. **Frihet automatically syncs** each client and their plan
2. **Every month** Stripe charges the client
3. **Upon collection**, Frihet automatically creates an invoice
4. **The invoice appears** in your list with "Paid" status

**Example:**
- Client: Empresa SL
- Stripe Plan: €299/month
- Feb 1, 2025: Stripe collects €299
- Frihet automatically creates an invoice for €299
- Status: Paid ✅

### One-time payments

If you use Stripe for one-time payments:

1. Create an invoice in Frihet
2. Generate a payment link with Stripe (from Stripe Connect - see next section)
3. Client pays
4. Frihet automatically marks the invoice as paid

### Online invoicing

With Stripe you can:

- Send invoices directly from Stripe
- Clients pay with card, Apple Pay, Google Pay
- Everything synchronized in Frihet

## Data that is synchronized

### From Stripe to Frihet

| Data | Synchronization |
|------|----------------|
| Clients | Every 15 minutes |
| Active subscriptions | Every 15 minutes |
| Payments | In real time |
| Refunds | In real time |
| Invoices | Every 15 minutes |

### From Frihet to Stripe

| Data | Synchronization |
|------|----------------|
| Client data | Manual (upon creation) |
| Invoice metadata | Manual (upon linking) |

**Note:** Synchronization is primarily from Stripe → Frihet. Do not edit clients in Frihet that exist in Stripe, to avoid conflicts.

## Subscription management

### View subscriptions in Frihet

1. Go to **Clients**
2. Open a client that has a subscription in Stripe
3. In the **History** tab, you will see:
   - Active subscription
   - Next payment
   - Payment history

### Cancel subscription

If a client cancels their subscription in Stripe:

1. Frihet automatically detects the change
2. Marks the subscription as "Canceled"
3. Does not generate more invoices

### Change subscription plan

If a client upgrades or downgrades their plan:

1. They do so in your Stripe client portal (or you manually)
2. Frihet updates the next payment
3. Invoice will reflect the new amount

## Payment reconciliation

Frihet automatically compares:

- **Unpaid invoices in Frihet** vs **Payments in Stripe**
- If there is a payment Frihet is unaware of, it marks it as "Payment pending registration"
- You can confirm the payment with one click

**How to view invoices for reconciliation:**

1. Go to **Invoicing** → **Invoices**
2. Filter by **"Requires reconciliation"**
3. Confirm payments with one click
4. The invoice automatically changes to "Paid"

## Tax declarations

With Stripe synchronized:

- Your tax summary includes Stripe payments
- The AI assistant can ask: "How much did I collect in Stripe this month?"
- Income reports reflect reality

## Security

- **OAuth connection** — We do not share your Stripe password
- **Restricted API** — Read-only access to payments, no access to money
- **Instant disconnection** — Revoke access in Settings whenever you want
- **Encryption** — Tokens stored encrypted in Frihet

## Disconnect Stripe

1. Go to **Settings** → **Integrations**
2. Search for **Stripe**
3. Click on **Disconnect**
4. Confirm the action

After disconnecting:

- Active subscriptions in Stripe continue to work (but Frihet does not see them)
- There are no new automatic invoices
- You can reconnect at any time

## Troubleshooting

### "I don't see my subscriptions in Frihet"

- Verify that Stripe is connected (you should see "✅ Connected" in Integrations)
- Wait 15 minutes for the first synchronization
- Subscriptions must be in "active" status in Stripe

### "An invoice was not marked as paid"

- Automatic reconciliation only works if the amount matches exactly
- If there are discounts or adjustments, it may not be detected
- Manually mark from the invoice: **"Confirm payment"** → enter amount

### "Error connecting Stripe"

- Verify that you have administrator access in Stripe
- Your Stripe account has no restrictions (contact Stripe if it does)
- Try disconnecting and reconnecting
- If it persists, contact support

:::tip Advanced automations
For advanced automations with Stripe, consult Frihet's [webhooks](/desarrolladores/webhooks) that notify events like `invoice.created` or `invoice.paid` in real time. You can combine them with the [REST API](/desarrolladores/api-rest) to build custom flows.
:::

## Next steps

- [Use Stripe Connect to collect from invoices](./stripe-connect)
- [Also integrate WooCommerce if you have a store](./woocommerce)
- [View all Frihet integrations](https://www.frihet.io/es/integrations)

---

**Next:** [Stripe Connect - Payment links on your invoices](./stripe-connect)