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:
{
"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]).
If the quote has no payment terms or no installment defined, no payment link will be created.
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 |
