> ## 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.

# Installation

> Install and activate the Stripe Sendcloud app.

<Info>
  You can install the Stripe Sendcloud app in the [Stripe Marketplace](https://marketplace.stripe.com/apps/sendcloud).
</Info>

## Prerequisites

Before installing, make sure you have:

* a Stripe account where apps can be installed,
* a Sendcloud account with API access,
* permission to manage webhooks in Stripe,
* permission to create integrations in Sendcloud.

## Step 1: Install the app in Stripe

1. [Install the app](https://marketplace.stripe.com/apps/sendcloud) in your Stripe account.
2. Open **App settings** after installation.
3. Confirm the app has access to required Stripe scopes.

## Step 2: Prepare Sendcloud credentials

In Sendcloud:

1. Go to **Settings > Integrations**.
2. Look for the **Sendcloud API** integration and click **Connect**.
3. Name the integration (for example, `Stripe`).
4. Enable **Webhook feedback**.
5. Set the webhook URL to the correct app environment endpoint:

Stripe Production account (use this for normal usage):

```text theme={null}
https://stripe-sendcloud-prod.vinaka-apps.com/api/webhooks/sendcloud
```

Stripe Sandbox account:

```text theme={null}
https://stripe-sendcloud-sandbox.vinaka-apps.com/api/webhooks/sendcloud
```

6. Save and copy your Sendcloud public and secret keys.

Use the endpoint that matches the Stripe mode where you installed the app:

* Stripe Sandbox -> Sandbox webhook URL
* Stripe Live/Production -> Production webhook URL

## Step 3: Configure the app

In Stripe app settings:

1. Open **Authentication** and save your Sendcloud keys.
2. Open **Configuration** and select invoice trigger events.
3. Save configuration to provision/update the Stripe webhook endpoint.

<Tip>
  The safest default trigger is `invoice.paid`.
</Tip>

## Step 4: Validate end-to-end

1. Create a test invoice in Stripe.
2. Trigger one configured event (for example mark invoice paid in test mode).
3. Confirm a Sendcloud order is created.
4. Open the invoice detail page and verify sync status in the app panel.

## Sandbox vs production

If you're using the app in a Sandbox account in Stripe, no subscription for the app is needed. You're free to try it out. Please be aware that Sendcloud does not offer a Sandbox environment, so orders are actually created in the Sendcloud account.