Skip to content
Open Bokeping

Set up Stripe or Forte for your company

Find the company payment configuration and understand provider-specific setup requirements.

In BokepingSettings → Payment Methods

By

Last updated:

Configure the provider belonging to the company that will receive payments. You need an appropriate provider account and permission to manage the company’s payment settings. Processing charges are separate from the Bokeping software trial.

Open Settings → Payment Methods. Review the Stripe or Forte card and choose Set it up for an unconfigured provider. For an existing connection, confirm the intended company before editing it.

Payment Methods in the demo company, with Stripe and Forte both marked Not set up and a Set it Up button for each.

Open full-size screenshot ↗

This demo company has no payment provider connected. Not set up means the company cannot yet offer that provider on its invoices.

One provider connection per company: choose Stripe or Forte. If one is already configured, the other provider’s setup is unavailable. Switching Offer on invoices off keeps the existing connection, so it does not free the company to connect the other provider.

The company-key setup form contains:

  • Environment: Sandbox (test mode) or Production (live).
  • Secret key and Publishable key: credentials from the same Stripe account and environment.

Review the form’s permissions guidance if using a restricted key. Choose Save and enable for initial setup. Bokeping attempts to configure the webhook when saving; inspect any error and the resulting connection status instead of assuming pasted keys were accepted.

If your deployment presents a Stripe Connect authorization flow instead of API-key fields, follow that displayed flow for the intended Stripe account. The two setup methods are alternatives; do not configure a second provider account to work around a failed connection.

The Forte setup form includes Environment, API URL, Organization ID, Location ID, API Access ID, API Secure Key, and Webhook Secret. Use the values supplied for your own Forte account and selected environment.

Copy the exact webhook URL shown in Bokeping to Forte’s webhook settings, and follow the form’s event and secret instructions. The URL is read-only in Bokeping. Choose Save and enable, then check the resulting status and any validation message.

After connecting Forte, review Card and Bank account (eCheck). Customers can choose from the methods you turn on. Bank payments also require your Forte merchant account to be approved for eCheck; turning on the switch does not grant that approval. Keep at least one method on while Forte is offered on invoices.

What you want to doActionEffect
Temporarily stop accepting new online paymentsTurn Offer on invoices off and review the confirmation.Customers cannot pay through that provider, including checkout pages already open. The connection and configuration are kept.
Resume using the same connectionTurn Offer on invoices back on.The provider can be offered again; check its status and the invoice’s Payment Options.
Change from Stripe to Forte, or the reverseReview the existing provider’s More actions → Delete connection confirmation before removing it, then set up the other provider.Off alone is insufficient. Deleting a connection is not the reversible pause control.

Before deleting a connection, read the confirmation’s impact on unpaid invoices and confirm how customers will pay them afterward. Once the new provider is ready, review Payment Options on outstanding invoices and check their customer-facing payment pages. Do not assume existing invoices automatically offer the replacement.

Check the company, provider account, environment, enabled payment options, and provider setup requirements. Sandbox configuration is not a live connection. Inspect any payment-sync warning before relying on automatic bookkeeping.

A configured provider does not mean an invoice is paid. Verify individual payment status and reconcile gross receipts, fees, and net payouts using payout differences.

Never send secret keys, card numbers, or webhook secrets in a support request or public screenshot. Share the provider name and a non-sensitive error description instead.

Frequently asked questions

Can I connect both Stripe and Forte to the same company?

No. Each company has one provider connection, so if one is already configured, the other provider's setup is unavailable. Turning Offer on invoices off keeps the existing connection and does not free the company. To switch, review the existing provider's More actions > Delete connection confirmation, remove it, then set up the other provider.

How do I temporarily stop customers paying my invoices online?

Turn Offer on invoices off for the provider in Settings > Payment Methods and review the confirmation. Customers then cannot pay through that provider, including on checkout pages already open, but the connection and configuration are kept. Turn Offer on invoices back on to resume with the same connection.

Where do I get the webhook URL to paste into Forte?

Bokeping shows it on the Forte setup form, as a read-only field. Copy that exact URL into Forte's webhook settings and follow the form's event and secret instructions. Then choose Save and enable and check the resulting status and any validation message instead of assuming the setup worked.

Why can't customers pay by bank account through Forte?

Bank payments require your Forte merchant account to be approved for eCheck, and turning on Bank account (eCheck) in Bokeping does not grant that approval. Check that the switch is on and that Forte has approved your account. Customers can only choose the methods you turn on, and at least one must stay on while Forte is offered.

Will my unpaid invoices use the new provider after I switch from Stripe to Forte?

Don't assume they will. Before deleting the old connection, read the confirmation's impact on unpaid invoices and decide how customers will pay them. Once the new provider is ready, review Payment Options on each outstanding invoice and check its customer-facing payment page.

Screenshot