Supported countries
Add a bank account
1
Open Settings
Web: Settings → Payout banks. Mobile: Profile → Payouts.
2
Choose a country
Pick from the country dropdown. The form swaps fields based on what the country requires (sort code for UK, routing number for US, etc.).
3
Enter bank details
For NG and GH, select your bank from the searchable list (sourced from Paystack). For US and UK, type the bank name freely.
4
Hedwig verifies the account
For NG and GH, the account holder name resolves automatically once you enter a 10-digit account number. The form pre-fills the holder from the verification response.
For UK, modulus check runs at save time when GoCardless is configured. US accounts save unverified.
5
Save
The first account you add becomes the default. Toggle Show on invoices if you want to keep an account but hide it from public pages.
Default account
Exactly one bank account per user is the default. The default is preselected for clients on every public invoice and payment link. To change it:- Find the account in Settings → Payout banks
- Click Set default
How clients see your bank details
On every public invoice and payment link page, the Pay by bank transfer card shows:- Country flag and currency label
- Bank name
- Account holder name
- Full account number (with a Copy button)
- Routing / sort code / IBAN / SWIFT as applicable
- Account type
- A Verified pill if the account passed automatic verification
Account numbers are intentionally shown in full so clients can complete the transfer. Access is gated by the document URL, which only the issuer shares.
Mark as paid after a transfer
Bank transfers settle off-platform, so Hedwig cannot detect them automatically. After the funds land in your account:1
Open the invoice or payment link
Go to Payments, find the unpaid record, and open the detail panel.
2
Tap Mark as paid
A dialog appears asking how you were paid.
3
Pick the payment method and add a reference
Choose Bank transfer (or crypto, cash, other). Optionally type the bank reference, transaction id, or note. Both fields persist on the document and appear in your revenue activity feed.
4
Confirm
The status flips to Paid, your client lifetime earnings update via the database trigger, and the activity feed gets a new entry.
Privacy and security
- Bank details are stored only in the
user_bank_accountstable tied to your user id - Cloudflare R2 and the public document endpoint never expose bank details unless the issuer has the row saved with
show_on_invoice = true - You can remove an account at any time. The data is hard-deleted; it cannot be recovered.
Troubleshooting
My account number was not auto-verified
My account number was not auto-verified
Auto-verification calls Paystack (NG / GH) or GoCardless (UK). If your environment lacks those API keys the account saves unverified. Verification can still happen later — re-save the same details once keys are configured. The account works on invoices either way.
Clients see only one account in the dropdown
Clients see only one account in the dropdown
The dropdown only appears with two or more saved accounts that have
Show on invoices enabled. Add another account in Settings or toggle visibility on existing ones.Free plan blocks me from adding a second account
Free plan blocks me from adding a second account
The free plan includes one bank account. Upgrade to Pro from Settings → Billing to add accounts in additional countries.
The Verified pill never appears
The Verified pill never appears
NG and GH require
PAYSTACK_SECRET_KEY to be configured; UK requires GOCARDLESS_TOKEN. US accounts are not auto-verified in v1.