Skip to main content

Changelog

note

This changelog covers the public SDK surface. Internal API changes that do not affect the public surface are not listed.

Versioning policy​

AccruPay SDKs follow Semantic Versioning:

IncrementMeaning
Patch (x.x.N)Bug fix — behavior corrected, no new fields or signature changes
Minor (x.N.0)Additive change — new fields, new methods, new options; fully backward compatible
Major (N.0.0)Breaking change — removed or renamed fields, changed method signatures, removed exports

Breaking changes are marked with ⚠️ BREAKING in the entry below.

Pin to a minor version range (^0.17.1) to receive patches automatically while guarding against breaking changes.

@accrupay/node​

Current version: 0.17.1

v0.17.1 — 2025-Q4 (current)​

  • Patch: corrected TypeScript types for baseConfig on Stripe sessions to accurately reflect the { publicKey: string } shape.
  • Patch: fixed an edge case where merchantInternalTransactionCode uniqueness validation returned a generic INTERNAL_SERVER_ERROR instead of VALIDATION_ERROR.

v0.17.0​

  • Minor: added customers service (sdk.customers) with create, get, list, and update methods.
  • Minor: added merchantInternalCustomerCode as an optional field on all session start inputs.

v0.16.0​

  • Minor: added sdk.transactions.paymentMethods.ach.start() for ACH session creation via Nuvei.
  • Minor: TRANSACTION_PROVIDER enum now exported from the top-level package entry point.

v0.15.0​

  • Minor: added sdk.transactions.clientSessions.authorizations.start() for auth-only sessions.
  • Minor: added sdk.transactions.operations.capture() and sdk.transactions.operations.void().

v0.14.0​

  • ⚠️ BREAKING: sdk.sessions renamed to sdk.transactions.clientSessions. Update all call sites.
  • ⚠️ BREAKING: sdk.paymentMethods moved to sdk.transactions.paymentMethods. Update all call sites.
  • Minor: added sdk.transactions.paymentPlans service.
  • Minor: added sdk.transactions.paymentPlanTemplates service.

v0.13.0​

  • Minor: added sdk.transactions.providers service for listing and managing transaction providers.
  • Minor: added sdk.merchants service for merchant profile reads.

v0.12.0​

  • Patch: improved error message detail for VALIDATION_ERROR — each field failure now includes the field name and reason.
  • Minor: AccruPayValidationError now exposes a fields property containing per-field error details.

@accrupay/react​

Current version: 0.1.0

v0.1.0 — 2025-Q4 (current, initial release)​

Initial public release of the AccruPay React SDK.

Included in this release:

  • <AccruPay> provider component — wraps a payment form and manages session state.
  • <CardNumber>, <CardExpiry>, <CardCVC> — hosted field components for PCI-compliant card entry.
  • <SubmitButton> — submit control with built-in loading and disabled state.
  • useAccruPay() hook — access to session state, submit handler, and error details from any child component.
  • Imperative ref API via AccruPayRef type and ref prop on <AccruPay> — programmatic submit trigger for custom button implementations.
  • Automatic provider routing — loads SafeCharge.js (Nuvei) or Stripe.js based on the resolved session provider.
  • environment prop — pass 'sandbox' to run in test mode without code changes across providers.
  • TypeScript-first: full type definitions bundled.