Getting paid with Stripe
Connect Stripe so clients pay an invoice online by card or US bank account, and charge saved payment methods.
Connect your Stripe account and clients can pay an invoice from its page by card or US bank account. ChronoSlice makes the invoices and Stripe only takes the payment, so there's no Stripe invoicing fee. This page covers connecting, the webhook, how clients pay, saved payment methods, and fees.
Before you start
- A Stripe account.
CHRONOSLICE_PUBLIC_URLset to your publichttps://address. Stripe sends clients back to it and sends payment notices to it. See Reverse proxy and HTTPS.- For US bank account payments, turn on US bank account in your Stripe dashboard, under Settings, then Payment methods.
Connect Stripe
- In Stripe, open Developers, then API keys, and copy a secret key. A key that starts with
sk_test_is for Stripe's test mode, which lets you try everything with Stripe's test cards. No real money moves. - In ChronoSlice, open Invoices, then Settings, and find Online payments.
- Paste the key into Stripe secret key, and press Connect Stripe.
ChronoSlice checks the key with Stripe before saving it, stores it, and never shows it again. The card then says Connected and the account's name, and Test mode for a test key. To change keys, press Use another key. Disconnect stops online payment on your invoices, and saved methods can't be charged until you connect again.
Your Stripe key is kept in the database, so keep your backups private.
Ways to pay
Under Ways to pay, choose what clients are offered:
| Way | Stripe's fee | Notes |
|---|---|---|
| Card | 2.9% + 30¢ | |
| US bank account (ACH) | 0.8%, at most $5 | US dollar invoices only. Clears in 3 to 5 business days. |
The fees are Stripe's standard US rates, and the card shows the fee on an example invoice. If your invoices aren't in USD, clients are offered card only. Stripe's fee is recorded with each payment, and the invoice shows what you receive.
The webhook
A webhook lets Stripe tell ChronoSlice the moment a payment clears, so bank payments show up sooner. When you save a key, ChronoSlice adds the webhook to your Stripe account by itself, at https://time.example.com/api/stripe/webhook/ followed by your organization's id, with the address from CHRONOSLICE_PUBLIC_URL. Saving a different key replaces the webhook, and disconnecting deletes it.
- If the webhook goes missing, for example because someone deleted it in Stripe, press Set up again under Webhook.
- If ChronoSlice can't create it, such as when the key can't manage webhooks, the key is still saved and the page says why. Open Set it up by hand and follow the steps. In Stripe, open Developers, then Webhooks, and add an endpoint with the address the page shows. Choose these events:
checkout.session.completed,checkout.session.async_payment_succeeded,checkout.session.async_payment_failed,checkout.session.expired,payment_intent.succeeded,payment_intent.payment_failedandpayment_intent.processing. Then paste its signing secret, which starts withwhsec_, into the page. - Stripe won't send events to
http://or to localhost, so the webhook needs a publichttps://address.
The webhook is optional. Payments are also recorded when the client returns from Stripe, and ChronoSlice checks open payments with Stripe every hour. The webhook only makes them appear sooner.
How clients pay
Clients open the invoice from its link in the email, or from the link you send. See Invoices.
- They press Pay with the amount due.
- Stripe's secure checkout page opens. It uses the branding you set in your Stripe dashboard, under Settings, then Branding, so set your logo and color there.
- They pay.
The payment is recorded on the invoice, marked Paid online. If it clears days later, as bank payments do, the page shows on its way until then. If receipts are on, ChronoSlice emails the client a receipt. See Reminders and notifications.
Saved payment methods
Under the Pay button, a client can tick Save it for future invoices. The card or bank account is then saved in Stripe, and you can charge it without asking again.
- On a recurring invoice, turn on Charge the client's saved payment method. Each invoice charges it first, so the email says it's paid. See Recurring invoices.
- On any invoice with a balance, press Charge followed by the saved method, such as the card's name. ChronoSlice asks you to confirm. The money is taken straight away. Refunds are made in Stripe.
- To stop, open the client and, under Saved payment method, press Forget it. ChronoSlice stops charging it. It stays in your Stripe account, and the client can save one again the next time they pay. Clients can also ask you to stop.
If an automatic charge fails, ChronoSlice tells the team.
When the trial has ended
While the server is read-only after the trial, clients can still pay, and payments are still recorded. See The trial.
Still stuck?
Send us a request: it goes to the people who build ChronoSlice, and the reply comes by email. Include your ChronoSlice version (Settings › Licence shows it) and what you tried.