Invoices & Payments
Helcim Payments
Alternative card processor with hosted checkout.
5 min readHelcim Payments
Overview
Helcim is an alternative card and ACH processor for ServiceFlow businesses. Connect with one-click Partner Connect (recommended once ServiceFlow has Helcim partner tokens) or paste your own API token (BYOK). When Helcim is active, invoices, payment links, and the customer portal use HelcimPay.js instead of Stripe Checkout.
Stripe keys are retained when you switch to Helcim. ServiceFlow SaaS billing and Stripe Connect employee payouts (when enabled) still use Stripe independently of the customer-facing processor.
How to access
| Surface | Path |
|---|---|
| Integrations | Settings → Integrations → Helcim |
| Helcim configuration | Settings → Payments → Helcim Configuration (/settings/payments?tab=helcim) |
| Payment links | Uses active processor |
What you can do today
- Connect with Helcim (partner signup) — one-click redirect to Helcim registration; API token arrives via partner webhook when approved
- Or paste API token + webhook verifier (BYOK)
- Enable ACH / bank payments (
achEnabled) so HelcimPay.js offers card + ACH - Online card (and ACH) checkout via HelcimPay.js
- Payment links, staff checkout, card vault, payment plans
- Payment webhook URL for Helcim Dashboard (
/api/payments/webhook)
Prerequisites
Partner Connect (one-click)
- Platform Admin has Helcim →
partner_config(partnerToken, optionalpartnerApiToken,connectedAccountWebhookVerifier) - Helcim Partnerships deliver URL:
{API_URL}/api/payments/partner-connected/webhook - After approval, register the payment webhook in Helcim Dashboard →
{API_URL}/api/payments/webhook(Helcim does not allow API auto-create for merchant payment webhooks)
BYOK
- Helcim merchant API Token
- Helcim Webhook Verifier Token + endpoint pointing at
/api/payments/webhook - Optional: enable ACH in Integrations
Step-by-step
Partner Connect
- Go to Settings → Integrations → Helcim → Connect.
- Complete Helcim signup (bank/KYC on Helcim’s site).
- When approved, ServiceFlow stores your merchant API token automatically.
- In Helcim Dashboard, register the payment webhook URL shown in ServiceFlow and paste the verifier token.
- Optionally enable ACH / bank payments.
BYOK
- Paste API token and webhook verifier under Helcim configuration.
- Register
/api/payments/webhookin Helcim Dashboard. - Save — Helcim becomes the active card processor.
Current limitations
- Affirm financing requires Stripe as the active processor
- Tap to Pay on iPhone and Stripe Terminal are Stripe-only (there is no Helcim Tap to Pay). While Helcim is your active card processor, those mobile/web surfaces stay hidden until you set Stripe active again in Integrations
- Helcim’s optional terminal ID field is for Helcim hardware only — it does not enable Stripe Tap to Pay
- Employee payouts still require Stripe Connect
- Merchant payment webhooks are Dashboard-only (partner approval webhook is platform-configured)
- One active card processor at a time for customer-facing flows
