Skip to Content
better-auth-nuvion

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.completed webhooks: the header names, the ISO 8601 timestamp, and the HMAC over {timestamp}.{raw body} all verify. The inflow carries the funding session's unique_reference and narration, and a meta.funding_session_id, so matching by reference works.
  • Creating the counterparty and book-transfer payment 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

GapToday
Authentication of the payment endpoints by API keyThey use the signed-in session. @better-auth/api-key is loaded but not wired to them
Reconciliation of legs stuck in sent or pendingYou retry them yourself; there is no poller
outflows.refunded mapped back to a paymentAcknowledged only
Paying the customer back on refundOut of scope: reversal legs only
Per-tenant credentialsA single apiKey and webhookSecret; multi-tenant apps use a fetch and proxy pattern
Changing a bindingA binding can be created once
Listing payments and legsRead the tables yourself
Attribution of Nuvion's own fees to legsA small payment can fail a leg with insufficient funds
Multi-currency splits, subscriptionsSingle currency per payment; no recurring payments

Amounts use JavaScript numbers (safe for fiat).

On this page