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

# Configuration

> Configure webhook triggers, authentication, and billing behavior.

## Settings page structure

The app settings page has four areas:

* **Configuration**: choose Stripe events that trigger order sync,
* **Authentication**: save Sendcloud API credentials,
* **Billing**: check subscription status and start/manage subscription,
* **Support**: documentation and support links.

## Configuration tab

### Trigger events

You can select one or more Stripe events.

#### Invoice events

| Event               | When it triggers                   | Typical use                  |
| ------------------- | ---------------------------------- | ---------------------------- |
| `invoice.created`   | Immediately after invoice creation | Early order prep             |
| `invoice.finalized` | Draft invoice becomes open         | Sync only finalized invoices |
| `invoice.sent`      | Invoice email is sent              | Start fulfillment after send |
| `invoice.paid`      | Invoice payment succeeds           | Recommended default          |

<Tip>
  Start with only `invoice.paid` to avoid creating shipping orders too early.
</Tip>

#### Subscription events

| Event                           | When it triggers          | Typical use                     |
| ------------------------------- | ------------------------- | ------------------------------- |
| `customer.subscription.created` | A new subscription starts | Ship once at subscription start |

<Tip>
  Use `customer.subscription.created` if you sell a physical product on a recurring subscription and only need to ship once when the subscription begins. This avoids creating duplicate shipping labels on each recurring payment.
</Tip>

## Authentication tab

Paste your Sendcloud public key and secret key. On save, credentials are validated first against Sendcloud before they are accepted.

* credentials are stored in **Stripe Secret Store**,
* credentials are not stored as plaintext in app forms,
* failed validation returns an actionable error.

## Billing tab

The Billing tab is where tenants can manage access to the app.

### Pricing

* €10/month includes the first 1,000 synced orders.
* €10 per additional 1,000 synced orders.

For full billing details, see [Pricing & billing](/legal/pricing-billing).

### Subscribe

Open the pricing page to review the plans and start your subscription:

<Card title="Open pricing & billing" icon="credit-card" href="/legal/pricing-billing" horizontal>
  Review pricing and start the subscription flow.
</Card>

<Tip>
  If you're using the app in a Stripe Sandbox account, no app subscription is needed. You can test freely. Sendcloud does not provide a sandbox, so test orders are still created in your real Sendcloud account.
</Tip>