Status and limits
What has been verified against the Nuvion sandbox, what has not, and what the plugin does not do yet.
Version 0.1, pre-release
Published on npm as @umohpyro/better-auth-nuvion (unofficial, under the author's scope). Expect changes to the API before 1.0.
Verified
On the Nuvion sandbox, with real requests:
- Creating a hosted-checkout funding session and paying it with the sandbox bank.
- Real signed
inflows.completedwebhooks: the header names, the ISO 8601 timestamp, and the HMAC over{timestamp}.{raw body}all verify. The inflow carries the funding session'sunique_referenceandnarration, and ameta.funding_session_id, so matching by reference works. - Creating the counterparty and
book-transferpayment detail the plugin needs, between two accounts of one entity.
Against a simulated Nuvion API, on Better Auth's in-memory adapter, SQLite and Postgres: the whole flow, including retries, refunds, de-duplication, fee math (property-tested to sum exactly) and migrations.
Not verified yet
- Real book transfers and the
outflows.*confirmations end to end on the sandbox. - The Nuvion production environment.
- The MySQL, Prisma and Drizzle adapters, a networked Postgres server under concurrent webhook delivery, and webhook retry and ordering behaviour.
Not built yet
| Gap | Today |
|---|---|
| Authentication of the payment endpoints by API key | They use the signed-in session. @better-auth/api-key is loaded but not wired to them |
Reconciliation of legs stuck in sent or pending | You retry them yourself; there is no poller |
outflows.refunded mapped back to a payment | Acknowledged only |
| Paying the customer back on refund | Out of scope: reversal legs only |
| Per-tenant credentials | A single apiKey and webhookSecret; multi-tenant apps use a fetch and proxy pattern |
| Changing a binding | A binding can be created once |
| Listing payments and legs | Read the tables yourself |
| Attribution of Nuvion's own fees to legs | A small payment can fail a leg with insufficient funds |
| Multi-currency splits, subscriptions | Single currency per payment; no recurring payments |
Amounts use JavaScript numbers (safe for fiat).