Guide: get paid by card (Stripe)
This guide is for you, the contractor, who wants clients to pay by credit card online. Funds go to your Stripe account. Allow 30–60 minutes. Ask the coordinator for your tenant ID before step 4.
💡 Alternative: Prefer bank transfers? Add your IBAN in Company settings → it will appear on your PDF invoices. Clients can pay by transfer (you'll manually mark invoices as paid).
2. Copy your two API keys (Live mode)
Stripe → Developers → API keys (check Live mode).
- Publishable key:
pk_live_… - Secret key: Reveal →
sk_live_…(keep private)
3. Paste them in Company settings
Site admin → Company settings → Stripe configuration:
- Stripe public key →
pk_live_… - Stripe secret key →
sk_live_…
Save. Webhook secret comes in step 5.
4. Create the webhook in Stripe (with your ID)
Ask the coordinator for your tenant ID (e.g. 3).
Go to https://dashboard.stripe.com/webhooks → Add destination.
In the Stripe form, fill in:
- Endpoint URL:
https://artisan-peinture.com/stripe-webhook/YOUR_ID
(Example:https://artisan-peinture.com/stripe-webhook/3) - Events to listen (one only):
checkout.session.completed
Then click Add destination.
5. Copy the webhook signing secret (whsec_)
Open the destination → Signing secret → Reveal → whsec_…
Admin → Company settings → Stripe webhook secret → paste whsec_… → Save.
6. Test with real payment
On the site, create a test quote with a small amount:
- Create a quote → click Pay online
- Pay with your card
- Confirm quote/invoice shows as paid
- Confirm you receive the confirmation email
Common issue: payment OK in Stripe but not on site = wrong webhook URL (stripe-webhook/YOUR_ID) or wrong whsec_ in Company settings.
