generated: '2026-09-10'
method: searched
source: https://dev.aero.inc/docs/release-notes
source_additional: https://dev.aero.inc/docs/release-notes-1
scheme: sdk-release-notes
note: 'Aeropay publishes NO changelog for the v2 REST API itself. The two "Release Notes" pages under the
  docs cover only the Aerosync bank-linking SDKs — one page for the Web SDK, one for the React Native SDK.
  There is no dated log of API contract changes, no deprecation notices and no per-release diff of the
  OpenAPI. This is the single largest operational-transparency gap in the profile: the contract changed
  materially in 2026 (multiple independent reversals replacing silently-merged partial refunds, the
  Idempotency-Key surface, the AP13XX refund codes, the tipConfiguration endpoint, payloadVersion 2.0
  webhooks with merchantUserReputation) and every one of those changes is documented only inside the
  affected reference page''s prose, never announced in a dated entry.'
api_changelog:
  published: false
  probed:
  - url: https://dev.aero.inc/docs/release-notes
    covers: Aerosync Web SDK only
  - url: https://dev.aero.inc/docs/release-notes-1
    covers: Aerosync React Native SDK only
current_version:
  api: v2
  api_spec_filename: v2-oasfile-01-13-2026-final.json
  api_spec_last_updated: '2026-09-08'
  api_spec_note: 'The ReadMe API registry reports the Aeropay v2 OpenAPI definition was created
    2026-09-02 and last updated 2026-09-08, so the contract IS being maintained — it simply is not
    announced anywhere a reader can subscribe to.'
docs_freshness:
  method: 'Each ReadMe docs page publishes an updatedAt stamp in its markdown frontmatter; the most recent
    across the pages harvested for this profile.'
  most_recent_page_update: '2026-09-09'
  most_recent_page: https://dev.aero.inc/docs/error-handling
entries:
- component: Aerosync Web SDK
  version: 2.1.2
  date: '2025-07-08'
  breaking: false
  highlights:
  - Bug fixes and stability work.
- component: Aerosync Web SDK
  version: 1.1.3
  date: '2025-07-18'
  breaking: false
  highlights:
  - Maintenance release on the 1.x line.
- component: Aerosync Web SDK
  version: 2.1.1
  date: '2025-06-10'
  breaking: false
  highlights:
  - Avoid onClose() firing after a successful bank link.
- component: Aerosync Web SDK
  version: 2.1.0
  date: '2025-05-30'
  breaking: true
  breaking_changes:
  - openWidget() renamed to initAeroSyncWidget()
  - Widget config key `id` renamed to `elementId`
  - consumerId renamed to configurationId
  - onSuccess now returns only connectionId, clientName and aeroPassUserUuid
  - onSuccess alone fires after a successful link; onClose no longer fires alongside it
  highlights:
  - Dark-mode launch flash fixed.
- component: Aerosync Web SDK
  version: 1.1.1
  date: '2025-04-22'
  breaking: true
  breaking_changes:
  - openWidget() renamed to initAeroSyncWidget()
  - Widget config key `id` renamed to `elementId`
  - onSuccess alone fires after a successful link
  additions:
  - Embedded Bank View — render the supported-bank list inline in the page.
- component: Aerosync React Native SDK
  version: 4.0.1
  date: '2025-05-30'
  breaking: false
- component: Aerosync React Native SDK
  version: 3.0.3
  date: '2025-09-30'
  breaking: false
- component: Aerosync React Native SDK
  version: 3.0.2
  date: '2025-05-20'
  breaking: false
- component: Aerosync React Native SDK
  version: 3.0.1
  date: '2025-05-05'
  breaking: false
staleness:
  note: 'The most recent dated release-note entry on either page is 2025-09-30, while the packages
    themselves shipped releases in August 2026 (aerosync-web-sdk 2.2.0, aerosync-react-native-sdk 4.1.0,
    com.aerosync:bank-link-sdk 2.1.0, aerosync_flutter_sdk 2.1.1, aerosync-ios-sdk 2.2.1). The release
    notes are roughly eleven months behind the artifacts they describe. See packages/aeropay-packages.yml.'
  release_notes_last_entry: '2025-09-30'
  packages_last_release: '2026-08-20'