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

# App manual

> Simple, step-by-step guide to start syncing Stripe invoices and subscriptions to Sendcloud.

This guide is written for business users, not developers.\
If you can use Stripe and Sendcloud, you can set this up.

## What this app does for you

* Creates Sendcloud orders from your Stripe invoices or new subscriptions.
* Saves you manual copy/paste between tools.
* Helps avoid duplicate orders.
* Shows order and shipment status directly in Stripe.
* Shows customer-level order history on Stripe customer pages.

## Start in 3 quick steps

### 1. Connect Sendcloud credentials

In Stripe, open the app and go to **Authentication**:

1. Paste your Sendcloud public key.
2. Paste your Sendcloud secret key.
3. Click **Save credentials**.

If the keys are correct, you will see a success message.

### 2. Choose when orders are created

Go to **Configuration**:

1. Choose your trigger event(s).
2. Click **Save configuration**.

Recommended for most tenants:

* Start with **`invoice.paid`** only for invoice-based flows.
* Use **`customer.subscription.created`** if you sell a physical product on a recurring subscription and only need to ship once.

`invoice.paid` creates orders after each successful payment. `customer.subscription.created` creates an order only once when the subscription starts.

### 3. Activate subscription (production)

Go to **Billing**:

1. Click **Start subscription**.
2. Complete checkout.
3. Return to Stripe and confirm status is active.

In sandbox mode, you can test without a production subscription.

## Daily usage

### Automatic mode (recommended)

Once configured, invoices are synced automatically based on your selected trigger.

### Manual mode (backup option)

On an invoice page in Stripe:

1. Open the Sendcloud app panel.
2. Click **Create order in Sendcloud**.

Use this when you need to send one invoice manually.

### Customer history view

On a Stripe customer page:

1. Open the Sendcloud app panel.
2. Review all synced Sendcloud orders for that customer.
3. Open linked invoice, order, or tracking details directly.

## How to read statuses

* **Succeeded**: order was created in Sendcloud.
* **Failed**: something blocked the sync (for example credentials or subscription).
* **Already exists**: this invoice was already synced earlier.

## Pricing reminder

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

## Good first-week checklist

1. Test in sandbox with 2-3 invoices or a test subscription.
2. Confirm orders appear in Sendcloud.
3. Go live with `invoice.paid` or `customer.subscription.created` first.
4. Expand triggers later only if needed.

## Need help?

If anything is unclear, contact [support@vinaka-apps.com](mailto:support@vinaka-apps.com).