FAQ
What the plugin can and cannot do today, which payment methods and currencies it supports, who holds the money, and what is verified.
Payment methods and currencies
Which payment methods can a customer use?
A hosted Open Banking checkout (the default): the customer pays from their bank account through Nuvion's page. Nuvion supports GBP and EUR for it. Since 0.6 you can also take Interac e-Transfer in CAD, which has no hosted page (Accept Interac). The smallest amount is 100 (£1.00); a smaller one is refused.
Can I take cards, Interac, mobile money or stablecoin?
Interac (CAD) since 0.6: Nuvion emails the payer an e-Transfer request, and there is no hosted page (Accept Interac). Creating and refreshing a request have been run against Nuvion's test environment, and the payer accepting, settlement and the shares moving are tested end to end against a simulated Nuvion.
Cards, mobile money and stablecoin are not built. Mobile money needs a phone number and channel and a USSD prompt, and stablecoin a different checkout; each is a separate piece of work. If you need one, say so in an issue.
Can I charge in another currency, for example CAD or NGN?
Nuvion's Open Banking checkout supports only GBP and EUR, so those are the currencies a customer can pay in through this plugin. Splits are different: the shares are book transfers in the payment's own currency, and that part does not depend on the pay-in method. A ₦1.00 split leg and its refund reversal have been run on Nuvion production this way, with the pay-in simulated. See Status for exactly what has been verified.
Does it support subscriptions or recurring payments?
No. Nuvion documents no recurring or mandate API, so each payment is a new checkout the customer completes.
Does a refund pay the customer back?
No. A refund moves each parent's share back to the merchant's account, so the merchant is whole. Paying the customer is a separate step you handle, because Nuvion documents no refund API for these payments (Refunds).
Money and risk
Who holds the money?
Nuvion does. The plugin never holds funds: the customer pays into the merchant's Nuvion account, and the plugin then asks Nuvion to move each parent's share to the parent's own Nuvion account with a book transfer. Your server holds an API key and a webhook secret, not money.
What does it cost?
The plugin is free and MIT licensed. Nuvion does not charge for book transfers, so a share costs exactly its amount. Anything Nuvion charges for checkout or accounts is between you and Nuvion.
Can a fake webhook make it pay out?
Not by itself. A request needs a valid signature, and with confirmEvents on (the default) the plugin also asks Nuvion whether the checkout really settled for that reference, amount and currency before it moves anything (Webhooks).
What if a webhook is lost or arrives twice?
Duplicates are ignored, and a payment that settled at Nuvion without a webhook is recovered by the reconcile (Operations). Each transfer has its own reference, so a retry cannot pay a share twice.
Setup
Do I need the organization plugin?
Yes. Organizations are the tenants and the hierarchy: a merchant, optionally under a reseller, under a platform. Even a single shop is one organization (Recipes).
Which databases and frameworks work?
Tested on SQLite, Postgres, MariaDB, and the Drizzle and Prisma adapters. MySQL 8 on Linux is next to verify. The plugin runs wherever Better Auth does; see Recipes for Express and Hono, and TanStack Start and Router.
Test environment or production?
Both use the same code. Set baseUrl to https://api.nuvion.co and use a production key and webhook secret. Read Going to production first.
Is this an official Nuvion product?
No. It is an independent project, published under the author's npm scope, and it is in beta. If Nuvion adopts it, the package may move and this site will say so (Support and versioning).
Something is not working
Start with Troubleshooting. To run it on your machine, see Local development.