Skip to Content
better-auth-nuvion

Changelog

What changed in each version of the plugin, newest first, and what to read before you upgrade.

All notable changes to @umohpyro/better-auth-nuvion, newest first. Versions below 1.0 may change behaviour between minors, so read Changed before you upgrade. Steps you have to take (database changes, known errors) are in Upgrading.

0.5.1 (2026-11-20)

Beta. No code changes; the package now says what has been verified on Nuvion production.

Changed

  • README and docs: the split engine's transfer path is verified on production. A ₦1.00 book transfer between two accounts of one entity settled from a real signed outflows.completed, and a refund reversal settled the same way. The hosted-checkout pay-in is verified on Nuvion's test environment only, and the docs say what is still open.
  • SECURITY.md and the privacy and support pages ship in the repository and docs.

0.5.0 (2026-11-20)

Added

  • onEntityUpdated hook: runs when Nuvion reports that an entity's review status changed (entities.updated), for example to approved, so an app can create the entity's accounts and bind them without polling. The status is confirmed with Nuvion (GET /entities/{id}) before the hook runs, and Nuvion's record wins over the event body. The hook receives only entityId, status, parentEntityId, the organizationIds already bound to it and confirmed; the name, risk level and documents in the event are never passed on. With per-organization keys, an entity that is not bound to any organization yet cannot be confirmed, so the hook is not called for it.

0.4.0 (2026-11-19)

Changed

  • Events are confirmed with Nuvion before the plugin acts (confirmEvents, on by default). An inflows.completed must match a settled funding session the plugin created (reference, amount, currency). A transfer event is settled from Nuvion's own record of the transfer, which wins over the event body. Set confirmEvents: false for the old behaviour.
  • The webhook answers 503 only for a temporary failure (Nuvion unreachable, 5xx, 429) so Nuvion retries. Everything else is acknowledged with 200 and logged, instead of failing every retry and risking a blacklisted webhook.
  • A setup problem while sending a leg (for example an organization that is not bound) marks that leg failed, so it can be retried, instead of throwing. A network error leaves the leg pending with the same reference.
  • A failure before anything was settled releases the event id, so a redelivery can be processed.

Added

  • cronSecret and GET or POST /nuvion/cron/reconcile for a scheduler (Authorization: Bearer <secret>). Absent unless the option is set.
  • Reconcile also recovers a checkout that settled at Nuvion while its webhook was lost (recovered in the result).
  • bind with replace: true moves an organization to another Nuvion account while it has no open payments, and forgets the saved counterparties.
  • Per-tenant credentials: apiKey: (organizationId) => key and webhookSecret: (tenant) => secret, with webhook URLs /nuvion/webhook/<tenant>.

Fixed

  • The checkout's funding session id is now saved on the payment. It was assigned but never persisted.

0.3.0 (2026-11-19)

Changed

  • The split is fixed at checkout. The legs are saved, as pending, when the payment is created, so a rule or parent change while a customer is paying no longer changes what that payment pays out, and a payer-borne fee rule changed in that window no longer stops the payment for manual review. A payment with no saved legs (made before 0.3, or by a lone organization) is still quoted when the money lands. No schema change.

Added

  • ./package.json in the package exports.

0.2.3 (2026-11-19)

Fixed

  • Upgrading an existing Postgres database to 0.2.0 to 0.2.2 with an older Better Auth CLI failed with type "nuvionPayment_userId_idx" does not exist. nuvionPayment.userId is no longer indexed, so the upgrade only needs ADD COLUMN.

0.2.2 (2026-11-19)

Changed

  • The admin view (/react) has class names on every part, classNames, unstyled, labels, formatDate and renderActions, and no inline styles or raw HTML, so it works under a strict CSP. The default look is now the optional @umohpyro/better-auth-nuvion/react.css. Without importing it the table is unstyled.

0.2.1 (2026-11-19)

Changed

  • Version bump so the npm page shows the README banner.

0.2.0 (2026-11-19)

Added

  • Hooks: onPaymentSettled, onPaymentPartial, onLegFailed, onRefunded.
  • Server-to-server calls with an API key (enableSessionForAPIKeys).
  • Payments without an organization (defaultOrganizationId), recorded with the payer's userId.
  • GET /nuvion/payments/list, GET /nuvion/payments/get and POST /nuvion/payments/reconcile.
  • A React admin view, PaymentsAdmin and PaymentsTable, from @umohpyro/better-auth-nuvion/react.
  • One optional column, nuvionPayment.userId.

Fixed

  • A failure event for a leg that was already rejected no longer repeats the onLegFailed hook or replaces the error, and the provider's reason is recorded for a sent leg.
  • Reconcile can settle a sent leg that has no Nuvion transfer id by looking it up by its reference.

0.1.2 (2026-11-18)

Changed

  • README leads with the install command and links. Corrected the development notes.

0.1.1 (2026-11-18)

Changed

  • Removed the open questions and the private repository link from the published package.

0.1.0 (2026-11-18)

First release.

  • Organizations in a hierarchy of one to three levels, with a fee rule per organization (flat, basis points, minimum, cap, paid by the payer or the merchant). Shares are integers and always add up to the charge.
  • Hosted checkout (an open-banking funding session) and signed webhooks, with de-duplication of events.
  • Each parent's share sent as a book transfer, with counterparties created on first use, retry of failed legs and refunds as reversal legs.
  • A typed client, and ESM and CommonJS builds.

On this page