> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qwoty.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Stripe - Payment link

> Automatically send a Stripe payment link to your customer as soon as a quote is accepted.

## Overview

The **Stripe — Payment Link** integration creates a Stripe-hosted payment page and sends it to your customer by email as soon as a Qwoty quote is accepted.

The payment link is pre-configured with the amount of the first installment defined on the quote. Your customer simply clicks to pay.

***

## Authentication

### Stripe

Go to **Stripe Dashboard → Developers → API keys** and copy your secret key (`sk_live_...` in production, `sk_test_...` in test mode).

Two modes are available depending on your organization:

**Workspace** — a single Stripe key for all your quotes. Enter it in the **Workspace API token** field.

**Business unit** — a different Stripe key per business unit. Enter a JSON map in the **Business unit API tokens** field:

```json theme={null}
{
  "business_unit_id_1": "sk_live_...",
  "business_unit_id_2": "sk_live_..."
}
```

***

## Behavior

### Payment link

A Stripe payment link is created for each accepted quote. The amount is the **first installment** defined in the quote's payment terms (`payment_terms.installments[0]`).

<Warning>
  If the quote has no payment terms or no installment defined, no payment link will be created.
</Warning>

The link expires **24 hours** after creation.

### Payment email

An email is automatically sent to the customer's primary contact with the payment link.

## Settings

| Setting                      | Values                     | Default   | Description                                                                                                 |
| ---------------------------- | -------------------------- | --------- | ----------------------------------------------------------------------------------------------------------- |
| **Token scope**              | Workspace / Business unit  | Workspace | Use a single Stripe key for the whole workspace, or one key per business unit.                              |
| **Workspace API token**      | Text                       | —         | Stripe secret key. Visible only when Token scope = Workspace.                                               |
| **Business unit API tokens** | JSON                       | —         | Map `{ "bu_id": "sk_..." }`. Visible only when Token scope = Business unit.                                 |
| **Submit button label**      | Pay / Book / Donate / Auto | Pay       | Text displayed on the Stripe Checkout submit button.                                                        |
| **Collect billing address**  | Auto / Required            | Auto      | `Auto`: Stripe collects the address only when required by the payment method. `Required`: always collected. |
| **Allow promotion codes**    | Yes / No                   | No        | Allows the customer to enter a Stripe promo code on the payment page.                                       |
| **Collect phone number**     | Yes / No                   | No        | Asks the customer for their phone number on the payment page.                                               |

***

## Examples

**Accepted quote — €588 in French**

The quote has one installment of €588 (100%) and the language is `fr`. The integration creates a payment link and sends the following email to the customer.

| Field       | Value                                        |
| ----------- | -------------------------------------------- |
| To          | Customer's primary contact email             |
| Subject     | `Acmé vous a envoyé une demande de paiement` |
| Amount      | €588.00                                      |
| Link expiry | 24 hours after quote acceptance              |
| CTA         | Link to the Stripe payment page              |