settlebolt

SettleBolt documentation

Run your stablecoin payments workflow.

Guides for setup, wallets, payment links, invoices, customers, branding, billing, support, APIs, and webhooks. SettleBolt is non-custodial software: customers pay directly into wallets you control.

Fast path

Verify your email, connect a wallet, create a payment link or invoice, then share the hosted checkout URL with your customer.

Last updated: 3 Jul 2026

Overview

SettleBolt lets businesses create payment links and invoices for stablecoin payments. The customer pays on-chain. Funds settle directly to the merchant wallet that is verified in the dashboard.

Non-custodial

SettleBolt does not hold merchant or customer funds.

Hosted checkout

Share links at settlebolt.com/l/..., settlebolt.com/pay/..., or your custom domain.

Flat SaaS billing

Stripe is used only for SettleBolt subscription fees.

What SettleBolt does not do

SettleBolt does not automatically pull crypto from a customer's wallet, hold balances, exchange tokens, or custody funds. Customer payments are initiated by the payer and recorded after chain confirmation.

Quick Start

Verify your email

After signup, enter the 6-digit code before accessing the dashboard. You can resend once every 3 minutes, up to 3 resends.

Connect a receiving wallet

Go to Wallet, add a wallet, and verify it. EVM wallets can be verified by signature or added as receive-only with confirmation.

Fill in business details

In Settings, add legal name, VAT/tax ID, registration number, business email, website, and address. These details appear on invoices and branding previews.

Create a link or invoice

Use Payment Links for reusable checkout links, or Invoices for customer-specific billing with line items, due date, and email delivery.

Track settlement

Payments appear in Payments after the watcher sees a supported transfer to your verified wallet and enough confirmations have passed.

Plans and Limits

PlanIncludedGated featuresSupport
Starter
EUR 29/mo or EUR 290/year
20 paid invoices/month, 10 payment links and invoice drafts, 1 team seat, supported chains and tokens.No API access, webhooks, CSV exports, custom branding, custom domains, advanced analytics, or audit logs.Normal support
Pro
EUR 79/mo or EUR 790/year
60 paid invoices/month, unlimited payment links and invoice drafts, 3 team seats.API keys, webhooks, CSV exports, custom branding, custom domains, advanced analytics, audit logs.Priority support
Business
EUR 199/mo or EUR 1,990/year
200 paid invoices/month, 10 payment links and invoice drafts, 10 team seats.API keys, webhooks, CSV exports, custom branding, custom domains, advanced analytics, audit logs.Priority support

Annual billing includes 2 months free. Monthly billing has no free months.

Wallets and Chains

Your wallet is your settlement destination. A payment link or invoice only works when the selected chain has a verified primary receiving wallet.

EVM chains

Base, Ethereum, Arbitrum, Optimism, Polygon, Avalanche, zkSync Era, Linea, and Scroll. Pay with the stablecoins USDC, USDT, and DAI where each is enabled in the registry.

Non-EVM chains (live)

Bitcoin — native BTC. Solana — native SOL plus USDC and USDT. Tron — native TRX plus USDT. These use self-attested receive-only addresses in v1: you paste and confirm the address (on-chain signature verification is a fast-follow).

Payable assets

Stablecoins USDC / USDT / DAI (EVM), USDC / USDT (Solana), USDT (Tron); and native BTC, SOL, and TRX, which are quoted live at checkout. Native ETH is defined in the system but is not currently enabled as a payable asset.

Add a wallet

  1. Open Wallet in the dashboard.
  2. Choose a chain and enter a wallet name if you want one.
  3. For browser wallets, sign the challenge. For receive-only addresses, paste the exact address and confirm it.
  4. Set a primary wallet per chain when you have more than one verified address.
Payout safety

Changing a primary payout wallet is delayed by 24 hours. Admins can freeze payout changes if an account looks risky.

Invoices

Invoices are customer-specific bills with line items, due dates, and a hosted pay page. They start as drafts, then become sent invoices when emailed to the customer.

Create and send an invoice

  1. Open Invoices and click New invoice.
  2. Add customer name and email. If you already added the customer, use the customer record.
  3. Use the suggested invoice number or enter your own unique number.
  4. Choose currency EUR, token, chain, due date, and line items.
  5. Click Save draft to keep editing, or Save and send to email the pay link.
Draft

Editable. Does not require a verified wallet until you send it.

Sent or overdue

Can be resent or cancelled. The customer can pay via the invoice checkout page.

Paid

Locked after settlement. It counts toward the paid invoice limit for the month.

Cancelled

No longer payable. Use a new invoice if you need to bill again.

The invoice amount must match the line item total when line items are present. PDF/printable invoice output includes available business and customer billing details.

Customers

Customers appear automatically when you invoice them. You can also add manual contacts before billing them.

Individual

First name, middle name, last name, email, phone, and profile notes.

Business

Company/legal name, billing contact, billing email, phone, address, tax status, VAT/tax ID, registration number, and invoice defaults.

Tax status

Business customers can be marked as Taxable, Exempt, or Reverse charge. Use the status your accountant expects for that customer's location and tax relationship.

Customer detail pages show total billed, paid, outstanding, average invoice, invoices, and payments. Removing a manual contact removes the saved contact profile, not historical invoices or payments.

Payments

The Payments ledger shows confirmed, pending, underpaid, overpaid, failed, invoice, link, and direct payments. You can filter by date, status, token, chain, source, transaction hash, or payer address.

How matching works

SettleBolt records payments by verified recipient wallet. If exactly one open invoice or link matches the received amount, it attaches automatically. If no target or multiple targets match, it stays direct so the wrong invoice is not marked paid.

Refunds

Because SettleBolt is non-custodial, refunds are manual on-chain transfers from your wallet back to the customer. The payment detail view shows the payer address and transaction hash to help you refund correctly.

CSV exports are available on paid plans where exports are enabled.

Branding and Custom Domains

Branding controls how checkout, invoices, receipts, and the customer portal look. It is available on Pro and Business.

AssetRuleSuggestion
LogoPNG up to 2 MB. Transparency is recommended, not required.600 x 240 px
IconSquare PNG up to 2 MB. Transparency is recommended.512 x 512 px
ColorsUse valid hex colors such as #0B0B0C.Brand color for headers, accent color for buttons.

Custom checkout domain

  1. Use Pro or Business.
  2. Open Branding, enter a domain you own, such as pay.yourbrand.com.
  3. Add the CNAME record shown in the dashboard. The default target is settlebolt.pages.dev.
  4. If the dashboard shows TXT validation, add that TXT record too.
  5. Wait for Cloudflare certificate validation to complete.

Do not use settlebolt.com or a *.settlebolt.com hostname as your custom domain.

Team Access

RoleAccess
OwnerFull access, billing, team management, ownership transfer, and account deletion.
AdminManages team, links, invoices, payments, wallet, branding, and settings, except owner-only actions.
MemberManages payment links, invoices, customers, and payments.
ViewerRead-only dashboard access.

Invites are emailed to teammates. Removing a teammate revokes their sessions for this merchant account. Starter includes 1 seat, Pro includes 3, and Business includes 10.

Billing

Billing is for the SettleBolt SaaS subscription only. Stripe charges your card for monthly or annual software access. It does not process your customers' crypto payments.

  • Change plan: choose Starter, Pro, or Business and monthly or annual billing.
  • Cancel subscription: cancellation stops renewal immediately, and you will not be charged again for that subscription.
  • Reactivate: available when a cancelled subscription can still be resumed.
  • Receipts: view and email SettleBolt subscription receipts from Billing.
  • Billing history: admins can view purchases, downgrades, checkout starts, plan changes, and receipts from the admin dashboard.

Help, Tickets, and Feedback

The dashboard sidebar includes Help and Feedback near the bottom.

Help

Create support tickets, view active tickets, and open a ticket detail thread.

Feedback

Send product feedback, bugs, ideas, praise, and an optional 1-5 rating.

Ticket categories are General, Billing, Payments, Wallets, Technical, and Security. Priorities are Normal, Low, High, and Urgent. Ticket subjects can be up to 140 characters and messages up to 4,000 characters.

Analytics

Analytics is available on Pro and Business. It shows total volume, payment count, average payment, average invoice, time series, by-token breakdown, by-chain breakdown, top customers, and top payment links.

Supported ranges include 7D, MTD, 30D, 90D, YTD, 12M, and Custom. Empty states stay quiet when there is no activity in the selected range.

API Overview

The production API base is:

https://api.settlebolt.com

Dashboard routes use the authenticated dashboard session token:

Authorization: Bearer <dashboard-session-token>
Content-Type: application/json
API key note

Only accounts with an active paid Pro or Business billing period can create, revoke, or use API keys. API keys are for SettleBolt's dedicated, scoped server-to-server Agent API (/api/agent/*) — each key carries per-operation scopes (for example invoices:create, payments:read). They are not accepted on dashboard routes, so a key can never manage wallets, billing, team, or account settings. Keys are shown once; treat them like passwords and revoke a leaked key in Developers. Do not expose dashboard session tokens in public client code.

Developers also includes a WhatsApp agent channel for Pro and Business accounts. A merchant creates a 10-minute pairing code, sends link 123456 from WhatsApp, and that WhatsApp sender can then use only the selected safe agent scopes. WhatsApp cannot manage wallets, billing, team access, or account deletion.

For the endpoint table, examples, webhook signatures, and payload shapes, open the dedicated API and webhook reference.

Webhooks

Webhooks are available only during an active paid Pro or Business billing period. Add an HTTPS endpoint in Developers, copy the signing secret once, and verify every delivery.

Payment webhooks are live

When a payment is recorded on-chain, SettleBolt sends a signed payment.confirmed POST to each of your active endpoints. Failed deliveries are retried with backoff (up to 6 attempts) and every attempt is visible in the delivery log, where you can also redeliver by hand.

X-SettleBolt-Event: payment.confirmed
X-SettleBolt-Event-Id: evt_...
X-SettleBolt-Timestamp: 1783100000
X-SettleBolt-Signature: t=1783100000,v1=<hmac>

The signature is HMAC-SHA256 over:

<timestamp>.<event_id>.<raw_json_body>

Webhook URLs must be public HTTPS endpoints on port 443. Internal, loopback, link-local, metadata, credentialed, IPv6 literal, and non-443 URLs are rejected.

Security Checklist

  • Verify your email before using the dashboard.
  • Enable 2FA in Settings.
  • Name wallets clearly so payout destinations are easy to inspect.
  • Use separate support/admin accounts instead of shared logins.
  • Keep API keys and webhook secrets in server-side secret storage.
  • Verify webhook signatures and reject stale timestamps.
  • Use HTTPS-only webhook endpoints.
  • Review Billing and Support history after plan or access changes.

Troubleshooting

Payment is not showing

Check that the customer paid the exact token and chain on the checkout page, that the recipient address is your verified primary wallet for that chain, and that enough confirmations have passed.

Invoice cannot be sent

The invoice chain needs a verified wallet before sending. Draft invoices can be saved before a wallet is connected.

Custom domain is pending

Confirm the CNAME target and any TXT validation records exactly match the Branding screen. Certificate validation can take time after DNS propagation.

Customer did not get an invoice email

Use Resend on sent or overdue invoices. Also confirm the customer email is valid and check spam/quarantine filters.

Need help

Open Help in the dashboard, create a ticket, and include invoice IDs, link URLs, wallet addresses, transaction hashes, and screenshots when relevant.