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.mdand the privacy and support pages ship in the repository and docs.
0.5.0 (2026-11-20)
Added
onEntityUpdatedhook: runs when Nuvion reports that an entity's review status changed (entities.updated), for example toapproved, 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 onlyentityId,status,parentEntityId, theorganizationIdsalready bound to it andconfirmed; 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). Aninflows.completedmust 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. SetconfirmEvents: falsefor the old behaviour. - The webhook answers
503only for a temporary failure (Nuvion unreachable, 5xx, 429) so Nuvion retries. Everything else is acknowledged with200and 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 legpendingwith the same reference. - A failure before anything was settled releases the event id, so a redelivery can be processed.
Added
cronSecretandGETorPOST /nuvion/cron/reconcilefor 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 (
recoveredin the result). bindwithreplace: truemoves an organization to another Nuvion account while it has no open payments, and forgets the saved counterparties.- Per-tenant credentials:
apiKey: (organizationId) => keyandwebhookSecret: (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.jsonin 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.userIdis no longer indexed, so the upgrade only needsADD COLUMN.
0.2.2 (2026-11-19)
Changed
- The admin view (
/react) has class names on every part,classNames,unstyled,labels,formatDateandrenderActions, 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'suserId. GET /nuvion/payments/list,GET /nuvion/payments/getandPOST /nuvion/payments/reconcile.- A React admin view,
PaymentsAdminandPaymentsTable, 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
onLegFailedhook or replaces the error, and the provider's reason is recorded for asentleg. - Reconcile can settle a
sentleg 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.