# Changelog

All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.

### [0.3.1](https://github.com/aevrHQ/pay/compare/pay@v0.3.0...pay@v0.3.1) (2026-07-08)


### Features

* **pay-100pay:** add asset transfer validation and execution methods to treasury domain ([5fa974a](https://github.com/aevrHQ/pay/commit/5fa974a114c84343621f1669dd5faf2893296ba5))


### Bug Fixes

* **pay-100pay:** getProviderBalance handles object-wrapped balances array ([a6b4afa](https://github.com/aevrHQ/pay/commit/a6b4afa27af8235f231df8e539a419f809c1a00b))
* **pay-100pay:** update package versions and improve data handling in list100PayBanks function ([508157d](https://github.com/aevrHQ/pay/commit/508157dbc5d08caf3da22eea733c684af04bc2ec))
* **pay-100pay:** update search100PayBanks to use API for bank search ([9bee0d0](https://github.com/aevrHQ/pay/commit/9bee0d096f0f2251e17c9e8d1742d37746419c14))

## [0.3.0](https://github.com/aevrHQ/pay/compare/pay@v0.2.18...pay@v0.3.0) (2026-07-04)


### Features

* **pay:** add new domain interfaces for banks and treasury ([ac9d15f](https://github.com/aevrHQ/pay/commit/ac9d15f63ecc127d7d9c2415142fc061e5e60cdc))

### [0.2.18](https://github.com/aevrHQ/pay/compare/pay@v0.2.16...pay@v0.2.18) (2026-07-04)


### Features

* **pay:** update version to 0.2.5 and add support for multiple wallet IDs in filters ([7fb5363](https://github.com/aevrHQ/pay/commit/7fb5363102d4ef17ef726e08a9b5ca842ffba65e))

### [0.2.16](https://github.com/aevrHQ/pay/compare/pay@v0.2.11...pay@v0.2.16) (2026-07-04)


### Features

* **docs:** enhance README and guides with extraMetadata and per-payer identity details ([814573f](https://github.com/aevrHQ/pay/commit/814573fa49b9c107c5b6b11549c182842e9e1f5e))
* **domains:** enhance settle behavior to merge extra metadata ([dad8f9e](https://github.com/aevrHQ/pay/commit/dad8f9ece2961a479b3ea13ffc4075fd1216664d))
* **pay,pay-100pay:** add customerUserId to CheckoutInitInput and CustomerInput ([de5b1f3](https://github.com/aevrHQ/pay/commit/de5b1f3df3fa4e22ac3259971ba39c595a2a8641))
* **pay:** add customerUserId to CheckoutInitInput and CustomerInput ([3f3bbf3](https://github.com/aevrHQ/pay/commit/3f3bbf33920222a31d931bdd9b88c307e0e6ae96))
* **pay:** add extraMetadata to SettleOptions and ProcessWebhookInput ([f35eb7c](https://github.com/aevrHQ/pay/commit/f35eb7c79193be37ca3d57d8ad0280392851d179))
* **pay:** update version to 0.2.15 and enhance filter options with anyWalletId ([3183577](https://github.com/aevrHQ/pay/commit/318357754dd854ba39126e85bc7089f4d0fd35aa))


### Bug Fixes

* **pay:** thread extraMetadata through session webhook settlement path ([1e22994](https://github.com/aevrHQ/pay/commit/1e229940a493aacbf8b6cdedaf29b370635f08b8))
* prioritize customerPhone over metadata phone in charge creation ([0e678df](https://github.com/aevrHQ/pay/commit/0e678df4d3cd087c3f9d019c424e44c5b7533ded))


### Documentation

* document fetchEventById proactive verification pattern for 100Pay embedded checkout ([5fe5cee](https://github.com/aevrHQ/pay/commit/5fe5ceebdef7638d3ed3c6e8f393a7ee916764f7))

### [0.2.11](https://github.com/aevrHQ/pay/compare/pay@v0.2.10...pay@v0.2.11) (2026-06-21)


### Features

* add fetchEventById method and HundredPayEventResponse interface for proactive event fetching ([b9cdc41](https://github.com/aevrHQ/pay/commit/b9cdc41fae84f41189994ff3cc6bad77359e79b0))

### [0.2.10](https://github.com/aevrHQ/pay/compare/pay@v0.2.9...pay@v0.2.10) (2026-06-21)

### [0.2.9](https://github.com/aevrHQ/pay/compare/pay@v0.2.6...pay@v0.2.9) (2026-06-14)


### Features

* add support for multi-payment sessions in 100Pay adapter ([9b46b2d](https://github.com/aevrHQ/pay/commit/9b46b2d01bb46e3ad169737ed5cd75fee7fb6cc1))


### Bug Fixes

* **pay-100pay:** prefer ref_id as externalId in verifyWebhook; always emit ref_id as providerReference ([38b812d](https://github.com/aevrHQ/pay/commit/38b812d1e4985b65a685246c8a6ec80440b5d230))

### [0.2.6](https://github.com/aevrHQ/pay/compare/pay@v0.2.5...pay@v0.2.6) (2026-06-11)


### Features

* enhance 100Pay adapter documentation and implement partial payment handling ([c6c0cb3](https://github.com/aevrHQ/pay/commit/c6c0cb3fe12b9bf8e1232acb949bcde643466d23))
* update 100Pay integration and add custom payment adapter documentation ([4ed3e5f](https://github.com/aevrHQ/pay/commit/4ed3e5f45ef8fc477cd7cf74eb6d3668ca706bdf))
* update charge reference handling in HundredPayAdapter for improved compatibility ([3a03e9c](https://github.com/aevrHQ/pay/commit/3a03e9cf96f5e04c0001493777c460f321672ff4))


### Bug Fixes

* update VitePress config and remove unnecessary Netlify redirects ([614bb78](https://github.com/aevrHQ/pay/commit/614bb7856e30bbdf040af13606865da683861ba8))

### [0.2.5](https://github.com/aevrHQ/pay/compare/pay@v0.2.4...pay@v0.2.5) (2026-05-19)


### Features

* add netlify configuration for documentation build and redirects ([1c67925](https://github.com/aevrHQ/pay/commit/1c67925adffc714378d4a455c93561b762de04ed))
* add structured logging to payment provider adapters ([0395b2a](https://github.com/aevrHQ/pay/commit/0395b2a8755f56c560ac72b8f4536f7e6b19ee4f))
* enhance payment adapters with embedded checkout support and update documentation ([54582a0](https://github.com/aevrHQ/pay/commit/54582a0de7a050d710ca1dfaf1d2f913a7ebfe1c))


### Code Refactoring

* update payment session parameters to use selectedProvider and quoteId ([554f81c](https://github.com/aevrHQ/pay/commit/554f81c8de54bfe802f614134a6f37245da3b0f5))

### [0.2.4](https://github.com/aevrHQ/pay/compare/pay@v0.2.3...pay@v0.2.4) (2026-05-10)


### Features

* add demo transfer scenario API and documentation for scheduled transfers ([aa0df40](https://github.com/aevrHQ/pay/commit/aa0df400b50eab64947759c310e29275db2142f0))
* add recipient support for scheduled transfers and bulk transfers ([1c19991](https://github.com/aevrHQ/pay/commit/1c1999104a839b08acd10254792e5e7261c6661a))
* add scheduled payouts functionality with creation, management, and execution features ([4e4d67b](https://github.com/aevrHQ/pay/commit/4e4d67b66bb6f226703b9a895b43beace9723258))
* add scheduled transfer functionality ([8bd1996](https://github.com/aevrHQ/pay/commit/8bd1996517874f6d54c53d0ea8b43b5c713c93a8))
* enhance scheduled transfer metadata with execution details ([636d979](https://github.com/aevrHQ/pay/commit/636d979640c87ad7999f8cd0c0ef11e9a3a1fe5c))
* implement scheduled payouts functionality ([bb9322f](https://github.com/aevrHQ/pay/commit/bb9322f3c68cbed539593758c0ef80a39d8a0a95))
* update documentation for recipient handling in scheduled and bulk transfers ([4cf7f50](https://github.com/aevrHQ/pay/commit/4cf7f50c67f8f8f7a67a1e8776bc52e45ec0d2d5))

### [0.2.3](https://github.com/aevrHQ/pay/compare/pay@v0.2.2...pay@v0.2.3) (2026-05-10)


### Features

* **docs:** enhance webhook and payout documentation with normalizeHeaders utility and examples ([9297c82](https://github.com/aevrHQ/pay/commit/9297c82ec15b86ca858b36e28c2706be53942888))


### Code Refactoring

* **pay:** format createPayoutFeePolicy function for improved readability ([590c7dc](https://github.com/aevrHQ/pay/commit/590c7dc400a7f2a361f81b9197febbf6ba1c84f9))

### [0.2.2](https://github.com/aevrHQ/pay/compare/pay@v0.2.0...pay@v0.2.2) (2026-05-10)


### Features

* **pay-paystack:** add bank payout support ([753935e](https://github.com/aevrHQ/pay/commit/753935ec6ec5621cdf83d66005ab0275d914675f))
* **pay:** export normalizeHeaders and createPayoutFeePolicy utilities ([2a8011f](https://github.com/aevrHQ/pay/commit/2a8011f47aedb4936fb5ffd5954d10bebd4a0590))
* **payout:** add payout verification button and functionality ([ae99eec](https://github.com/aevrHQ/pay/commit/ae99eec88bf948c288709be0b8fe8c28e2273b06))
* **paystack:** add payout capabilities and bank listing functionality ([1dbb920](https://github.com/aevrHQ/pay/commit/1dbb920594797f1e902f4f1526f7bbb0d8837403))

### [0.2.1](https://github.com/aevrHQ/pay/compare/pay@v0.2.0...pay@v0.2.1) (2026-05-09)

## [0.2.0](https://github.com/aevrHQ/pay/compare/pay@v0.1.0...pay@v0.2.0) (2026-05-09)


### Features

* add callback URL support for Flutterwave payouts and resolved name handling ([17e622a](https://github.com/aevrHQ/pay/commit/17e622a5a1eb6dce00edc2833f614cd2f9e1b965))
* add Flutterwave payout support with account resolution, recipient creation, and payout verification ([71b28ec](https://github.com/aevrHQ/pay/commit/71b28ec59cf80cbf453a0b4ff3c127a2d71fd679))
* add paymentReference to PayoutWebhookEvent and update lookup strategy in createPayoutsDomain ([5878f88](https://github.com/aevrHQ/pay/commit/5878f88aca9ed6a91e40bac0dba5a06f44ca28bf))
* add payout functionality with provider selection, recipient registration, and transaction processing ([f10828c](https://github.com/aevrHQ/pay/commit/f10828c2cf214c1e1e58ca40d457a28135e5d6ce))
* add payouts domain for managing payout recipients and operations ([9f93523](https://github.com/aevrHQ/pay/commit/9f93523479d114873f497cb478fbea5885d8b6fc))
* **docs:** add SPEC-PAYOUTS guidelines for payouts and rewards ([26daed3](https://github.com/aevrHQ/pay/commit/26daed3002e627d269b20ae239c3f55fcb4e6997))
* enhance payout functionality with bank search, log export, and recipient management ([5d41162](https://github.com/aevrHQ/pay/commit/5d411622b35f3741055ad7291f1c34578827a6cc))
* enhance payout functionality with recipient details and asset transfer support ([fb75021](https://github.com/aevrHQ/pay/commit/fb7502167a36f6e84599642cedee4580763b527b))
* implement payout fee policy with flat, percentage, and cap configurations ([829d271](https://github.com/aevrHQ/pay/commit/829d271add629c786daa2dacaea968466784ec81))
* implement payout functionality with recipient management and asset transfer support ([e63ddcf](https://github.com/aevrHQ/pay/commit/e63ddcf0ba461683c15a703532f932f1a7a5984d))
* **pay-flutterwave:** add bank payout support ([f56ee23](https://github.com/aevrHQ/pay/commit/f56ee232846d2fff55c6b483eac469c83b43ff26))

## 0.1.0 (2026-05-08)

### Features

* add charge ID handling with utility functions and update webhook payload structure ([98421bb](https://github.com/aevrHQ/pay/commit/98421bb6d1f37706af4bb21cafa01f227ea1b90f))
* add comprehensive Payment Pages vNext grilling session specification for multi-provider and multi-currency support ([1704be4](https://github.com/aevrHQ/pay/commit/1704be47898ec6b4b27fb94cd02b7dbbd6354ca2))
* add CurrencyFreaks FX adapter for @untools/pay ([cc235c0](https://github.com/aevrHQ/pay/commit/cc235c084f5f25290c6e191f9a16b39c1c74e6fb))
* add customer phone input and fallback handling in demo app ([eb1b53c](https://github.com/aevrHQ/pay/commit/eb1b53c861e376f6599a9bb8af21338492b5a388))
* add dockable log panel with toggle functionality for improved output logging ([471488c](https://github.com/aevrHQ/pay/commit/471488ceba791c06d04ffa1f6ee8890f94818d5c))
* add documentation maintenance instructions and update prompt for JSDoc compliance ([e0080be](https://github.com/aevrHQ/pay/commit/e0080be86e1cdf32a8158bbc4e4a5c303001f7b6))
* add GitHub Actions workflow for deploying documentation ([864ce7a](https://github.com/aevrHQ/pay/commit/864ce7a915952120cddac68e2a55872e80d890c9))
* add integration tests for cross-currency checkout session quotes ([9658897](https://github.com/aevrHQ/pay/commit/965889782aeda537afdda66bbe8a184f96e7f6c3))
* add resize handle functionality to dockable log panel for improved user experience ([9e3b9ab](https://github.com/aevrHQ/pay/commit/9e3b9ab8439cba005d0464e9e136c611b156a03c))
* add support for apps workspace and implement transaction verification in HundredPayAdapter ([621a198](https://github.com/aevrHQ/pay/commit/621a19810757cc8faa4e93b45a81cc2ec6b90647))
* add support for checkout modes in payment provider adapters ([2794299](https://github.com/aevrHQ/pay/commit/2794299b3398eef44a9b936ec9ba50e6536ecbb1))
* add support for custom currency registration and enhance operations with new adjustment and verification methods ([a240b64](https://github.com/aevrHQ/pay/commit/a240b64fb2b70dc04e3f6eb98e8998a1d295e6e6))
* add support for mongoose and prisma storage adapters with configuration updates ([00ebe83](https://github.com/aevrHQ/pay/commit/00ebe83ed0ae029105bc608f7b993c9878d551a8))
* add support for optional redirect URL in embedded checkout for Flutterwave ([f646692](https://github.com/aevrHQ/pay/commit/f64669242ece0aef283992663f4909e6916b9217))
* add sweep job endpoints for manual session and payment management ([15770a6](https://github.com/aevrHQ/pay/commit/15770a669ed3538821ed376f78228269121dd870))
* add transaction support to MongooseStorageAdapter with session management ([51a4e8b](https://github.com/aevrHQ/pay/commit/51a4e8b3788cd24bb6927486c3d4dfbd646667ea))
* add transaction verification and currency conversion endpoints with error handling ([e219e3d](https://github.com/aevrHQ/pay/commit/e219e3d837026d20459ef5f6b1fb83bb35fcd420))
* add transfers domain with cross-user transfer and conversion capabilities ([b27f795](https://github.com/aevrHQ/pay/commit/b27f795804aa760564e9bd0ae914771c4bc517a3))
* add verify reference handling and improve error reporting in transaction verification ([6cdf814](https://github.com/aevrHQ/pay/commit/6cdf81422f405ecb050d47daf4632338e36f6ea8))
* add vitest configuration and tests for payment adapters ([f698dbd](https://github.com/aevrHQ/pay/commit/f698dbd97980925423641425e963436f265ee87e))
* add wallet management and cross-user transfer functionality with payment page support ([94866af](https://github.com/aevrHQ/pay/commit/94866af1de854074ee8146d36d9b5fffbaa52eaf))
* add wallet payment method to checkout sessions, enabling direct wallet debits for faster transactions ([2b157d1](https://github.com/aevrHQ/pay/commit/2b157d15c8cfb999fbff6f3ede3869a5b05d6641))
* add webhook secret configuration to payment providers ([376c327](https://github.com/aevrHQ/pay/commit/376c32791db93ec2118bf4823ccde202a5aaea8c))
* **demo:** add multi-provider demo app for @untools/pay adapters ([636bce7](https://github.com/aevrHQ/pay/commit/636bce747f9f4eac9e2736b369a58e7f6ddf3ff2))
* **docs:** add comprehensive documentation for payment processing and adapters ([b4b895f](https://github.com/aevrHQ/pay/commit/b4b895f3fa44888c7e87752483e1954702909c49))
* **docs:** add payment documentation and script for full LLM ingestion ([5b171b0](https://github.com/aevrHQ/pay/commit/5b171b05dca81ccc78b417ca818846e25e77c2d4))
* **docs:** enhance documentation with new fields and error handling details across multiple files ([0257158](https://github.com/aevrHQ/pay/commit/02571589f45507143cd29cee8be714f24fa2340c))
* enhance balance computation and introduce manual resolution for transfers ([6f731a5](https://github.com/aevrHQ/pay/commit/6f731a57c894a06caefaf29fe8a2de304cbeee6f))
* enhance balance management and authorization actions across domains ([0443fb0](https://github.com/aevrHQ/pay/commit/0443fb06fddd3a82bfaafbb0473aa0e9c9b3806d))
* enhance demo interface with sender wallet auto-population and hints ([de01318](https://github.com/aevrHQ/pay/commit/de01318ad418ed3e031e280768ab0ce541a57377))
* enhance Flutterwave integration with modal closure and server verification ([565c16b](https://github.com/aevrHQ/pay/commit/565c16ba06d90476f91fc681a1f818397dd34741))
* enhance manual resolution handling and improve FX snapshot management in transfers ([8962020](https://github.com/aevrHQ/pay/commit/8962020a52bb59dab26041179db7249d9272f90b))
* enhance MongooseStorageAdapter with consistent returnDocument option usage and improve session handling ([f99ef04](https://github.com/aevrHQ/pay/commit/f99ef04488a950e2d955a644356ccaeabe0bb828))
* enhance operation finality and wallet constraints ([3132d6b](https://github.com/aevrHQ/pay/commit/3132d6b6129e0e4cd54ab4cdb725f7a1ee29f6b6))
* enhance operations and wallet handling with reconciliation support and idempotency checks ([0483df4](https://github.com/aevrHQ/pay/commit/0483df4bac181b1ec4968016f354a9e7c6269777))
* enhance payment client to include authorizer and rateProvider in createPayClient function ([64a05f3](https://github.com/aevrHQ/pay/commit/64a05f3e0433d4a373c58868faf13eeb41f5b22f))
* enhance payment page and checkout session functionality with multi-provider support ([b03c648](https://github.com/aevrHQ/pay/commit/b03c648938fd5a2065c76475ef1d9032171446df))
* enhance payment pages and checkout session handling ([2931ce3](https://github.com/aevrHQ/pay/commit/2931ce33c4484e8029d90c707917389652a95804))
* enhance payment processing models and add checkout session, quote, and payment functionality ([daacc9d](https://github.com/aevrHQ/pay/commit/daacc9d9611afb4b0fa8e52739aec7abbc731daf))
* enhance payment provider integration with public key support and status updates ([8ed00e7](https://github.com/aevrHQ/pay/commit/8ed00e7a1cfa6999ef180aee1fbff847d98164bf))
* enhance PaymentPage model with additional fields and update data handling in storage adapters ([30f74a2](https://github.com/aevrHQ/pay/commit/30f74a2607685511d457b032b1f2307e9becd763))
* enhance transaction verification and update MongooseStorageAdapter to use returnDocument option ([e2b837c](https://github.com/aevrHQ/pay/commit/e2b837c3b3d4c5be5740abdf4348f647b685d8c8))
* enhance transaction verification to support raw charge payloads and map status to completed ([f38bfd6](https://github.com/aevrHQ/pay/commit/f38bfd66c24a2ae11ea99b4f97daafd6ab0aa140))
* enhance wallet management with constraints and multi-wallet lock ordering ([dcaf8ae](https://github.com/aevrHQ/pay/commit/dcaf8ae73351e244570ff6d233933360b7527076))
* enhance webhook payload handling and add tests for amount and currency parsing ([d1f1044](https://github.com/aevrHQ/pay/commit/d1f104422836d38b14c821affbf27b6e21ecb548))
* enhance webhook processing with additional transaction details and mock provider updates ([8e82fe0](https://github.com/aevrHQ/pay/commit/8e82fe0ea48e49570070743effc4f31ccb4e9cee))
* enhance webhook verification with HMAC support and update payload structure ([839f2ce](https://github.com/aevrHQ/pay/commit/839f2ce08cb0e36363da73a7a1276b36d7d7ef99))
* **errors:** add detailed error classes for wallet and operation management ([f70bdb2](https://github.com/aevrHQ/pay/commit/f70bdb2e17a6d7fd7a1dbddcff36574ae71670d5))
* implement charge ID handling and enhance operation metadata persistence ([9c68a6e](https://github.com/aevrHQ/pay/commit/9c68a6e013a143df1701c0088467c645ac2991cd))
* implement Flutterwave and Paystack adapters for payment processing ([f202d54](https://github.com/aevrHQ/pay/commit/f202d5467e14948609cf1474636328b43af0f79f))
* implement payment and cancellation operations with detailed API documentation ([d8e056f](https://github.com/aevrHQ/pay/commit/d8e056f0145ef06720dde00135d6265666a87b41))
* implement payment pages, wallets, and webhooks domains ([89931ec](https://github.com/aevrHQ/pay/commit/89931ec6fd5e1b21dd5a588a83808caa713858fa))
* implement sweep job for TTL-driven session and payment management ([5e32fd8](https://github.com/aevrHQ/pay/commit/5e32fd89bb9ca2caf2ab232f824cf89fd60ea33a))
* implement system wallet resolution and double-entry bookkeeping for deposits and withdrawals ([17d5445](https://github.com/aevrHQ/pay/commit/17d5445918c1e66496304ff5b086791ff8e87a6a))
* implement user manager and wallet management features in demo app ([65efc55](https://github.com/aevrHQ/pay/commit/65efc5544aa8e776446273695894b4c632122113))
* implement verification domain and enhance webhook processing with event handling ([06dcaac](https://github.com/aevrHQ/pay/commit/06dcaac70b7e233ecc7a35981969bd88889960dd))
* implement wallet payment method and enhance checkout session API to support wallet transactions ([ababf35](https://github.com/aevrHQ/pay/commit/ababf350427676c85d4b213699e7e6eeacdba5fe))
* integrate decimal.js for improved currency conversion precision and add effectiveAtPolicy to PayClientConfig ([dbb1388](https://github.com/aevrHQ/pay/commit/dbb1388f534a0c79ebc064c78b26beebf779c0b8))
* introduce ReversalNotAllowedError and update related operations; rename webhook methods for clarity ([c25cde3](https://github.com/aevrHQ/pay/commit/c25cde38c71a65884549998d2076b08a36d06305))
* make phone number optional in charge and checkout payloads ([c73da25](https://github.com/aevrHQ/pay/commit/c73da2585075c962d75273d612ff73cbab622885))
* optimize balance derivation and enhance entry metadata ([217e580](https://github.com/aevrHQ/pay/commit/217e5806a9546daabe447f09a13d2f7ef7e81255))
* update architecture specification with enhanced FX handling and operation status definitions ([494d83e](https://github.com/aevrHQ/pay/commit/494d83ec4a5b9194b710c637dbc5f05bc102a478))
* update demo app configuration and enhance checkout state management ([84c6788](https://github.com/aevrHQ/pay/commit/84c678809888a35b5dcf31ad0ff1273866612513))
* update QuoteExpiredError to use originalQuoteId and enhance session fulfillment status calculation ([8250826](https://github.com/aevrHQ/pay/commit/8250826674c64f3d69286f0ccd6cd14aea31131b))
* update unique constraint for transit wallet to align with checkout session ownership model ([caccab5](https://github.com/aevrHQ/pay/commit/caccab54b24f592c1d1ac9d5f3011f970eb3954d))

### Bug Fixes

* **docs:** add missing line breaks for better readability in multiple documentation files ([7d3f0b6](https://github.com/aevrHQ/pay/commit/7d3f0b67f1e899271bdd420770fcb83bb9446c78))
* **docs:** pin vitepress outDir via explicit CLI flags for Vercel compatibility ([88ba383](https://github.com/aevrHQ/pay/commit/88ba3833fc14a5b661d986b5c94fd383407c9158))
* **docs:** set base to / for Netlify root domain deployment ([9143a3f](https://github.com/aevrHQ/pay/commit/9143a3f56d0bef387578e37441f60a9632304897))
* **docs:** simplify head configuration in VitePress config ([ab180b2](https://github.com/aevrHQ/pay/commit/ab180b296bc052eccff7d8bbb50abcc15ac72eef))
* update .gitignore to specify dist directory and add .gitkeep to docs/dist ([bb0ff25](https://github.com/aevrHQ/pay/commit/bb0ff25b81643df8d9f7662301d2ae5e9d3dd8d8))
* update output paths for documentation build and deployment ([72c2193](https://github.com/aevrHQ/pay/commit/72c21931ae7fde3fedb889f8862f8717119278c5))

### Documentation

* add detailed specification document ([772fab8](https://github.com/aevrHQ/pay/commit/772fab829f7dea3be82b9d8179ec04f865605c56))
* add missing guides and adapter pages ([1aae778](https://github.com/aevrHQ/pay/commit/1aae778961fd38121302f418071a613708814635))
* add SPEC_FIXES.md to documentation directory ([9f14063](https://github.com/aevrHQ/pay/commit/9f14063bd9ca968f9bb20d0243feadd9f4023a90))
* update specification documents to include new payment pages multi-provider session feature and various minor fixes ([3c512f7](https://github.com/aevrHQ/pay/commit/3c512f7e03185cc986adbeaed17ad2f9d5527997))
* update specification for id generation contract and add adapter internal implementation details ([d939874](https://github.com/aevrHQ/pay/commit/d939874cc26c89dc0320c336825168acbd6a8cc2))

# 1.0.0 (2026-05-07)

### Bug Fixes

* **docs:** pin vitepress outDir via explicit CLI flags for Vercel compatibility ([88ba383](https://github.com/aevrHQ/pay/commit/88ba3833fc14a5b661d986b5c94fd383407c9158))
* **docs:** set base to / for Netlify root domain deployment ([9143a3f](https://github.com/aevrHQ/pay/commit/9143a3f56d0bef387578e37441f60a9632304897))
* **docs:** simplify head configuration in VitePress config ([ab180b2](https://github.com/aevrHQ/pay/commit/ab180b296bc052eccff7d8bbb50abcc15ac72eef))
* update .gitignore to specify dist directory and add .gitkeep to docs/dist ([bb0ff25](https://github.com/aevrHQ/pay/commit/bb0ff25b81643df8d9f7662301d2ae5e9d3dd8d8))
* update output paths for documentation build and deployment ([72c2193](https://github.com/aevrHQ/pay/commit/72c21931ae7fde3fedb889f8862f8717119278c5))

### Features

* add charge ID handling with utility functions and update webhook payload structure ([98421bb](https://github.com/aevrHQ/pay/commit/98421bb6d1f37706af4bb21cafa01f227ea1b90f))
* add comprehensive Payment Pages vNext grilling session specification for multi-provider and multi-currency support ([1704be4](https://github.com/aevrHQ/pay/commit/1704be47898ec6b4b27fb94cd02b7dbbd6354ca2))
* add CurrencyFreaks FX adapter for @untools/pay ([cc235c0](https://github.com/aevrHQ/pay/commit/cc235c084f5f25290c6e191f9a16b39c1c74e6fb))
* add customer phone input and fallback handling in demo app ([eb1b53c](https://github.com/aevrHQ/pay/commit/eb1b53c861e376f6599a9bb8af21338492b5a388))
* add dockable log panel with toggle functionality for improved output logging ([471488c](https://github.com/aevrHQ/pay/commit/471488ceba791c06d04ffa1f6ee8890f94818d5c))
* add documentation maintenance instructions and update prompt for JSDoc compliance ([e0080be](https://github.com/aevrHQ/pay/commit/e0080be86e1cdf32a8158bbc4e4a5c303001f7b6))
* add GitHub Actions workflow for deploying documentation ([864ce7a](https://github.com/aevrHQ/pay/commit/864ce7a915952120cddac68e2a55872e80d890c9))
* add integration tests for cross-currency checkout session quotes ([9658897](https://github.com/aevrHQ/pay/commit/965889782aeda537afdda66bbe8a184f96e7f6c3))
* add resize handle functionality to dockable log panel for improved user experience ([9e3b9ab](https://github.com/aevrHQ/pay/commit/9e3b9ab8439cba005d0464e9e136c611b156a03c))
* add support for apps workspace and implement transaction verification in HundredPayAdapter ([621a198](https://github.com/aevrHQ/pay/commit/621a19810757cc8faa4e93b45a81cc2ec6b90647))
* add support for checkout modes in payment provider adapters ([2794299](https://github.com/aevrHQ/pay/commit/2794299b3398eef44a9b936ec9ba50e6536ecbb1))
* add support for custom currency registration and enhance operations with new adjustment and verification methods ([a240b64](https://github.com/aevrHQ/pay/commit/a240b64fb2b70dc04e3f6eb98e8998a1d295e6e6))
* add support for mongoose and prisma storage adapters with configuration updates ([00ebe83](https://github.com/aevrHQ/pay/commit/00ebe83ed0ae029105bc608f7b993c9878d551a8))
* add support for optional redirect URL in embedded checkout for Flutterwave ([f646692](https://github.com/aevrHQ/pay/commit/f64669242ece0aef283992663f4909e6916b9217))
* add transaction support to MongooseStorageAdapter with session management ([51a4e8b](https://github.com/aevrHQ/pay/commit/51a4e8b3788cd24bb6927486c3d4dfbd646667ea))
* add transfers domain with cross-user transfer and conversion capabilities ([b27f795](https://github.com/aevrHQ/pay/commit/b27f795804aa760564e9bd0ae914771c4bc517a3))
* add verify reference handling and improve error reporting in transaction verification ([6cdf814](https://github.com/aevrHQ/pay/commit/6cdf81422f405ecb050d47daf4632338e36f6ea8))
* add vitest configuration and tests for payment adapters ([f698dbd](https://github.com/aevrHQ/pay/commit/f698dbd97980925423641425e963436f265ee87e))
* add wallet management and cross-user transfer functionality with payment page support ([94866af](https://github.com/aevrHQ/pay/commit/94866af1de854074ee8146d36d9b5fffbaa52eaf))
* add wallet payment method to checkout sessions, enabling direct wallet debits for faster transactions ([2b157d1](https://github.com/aevrHQ/pay/commit/2b157d15c8cfb999fbff6f3ede3869a5b05d6641))
* add webhook secret configuration to payment providers ([376c327](https://github.com/aevrHQ/pay/commit/376c32791db93ec2118bf4823ccde202a5aaea8c))
* **demo:** add multi-provider demo app for @untools/pay adapters ([636bce7](https://github.com/aevrHQ/pay/commit/636bce747f9f4eac9e2736b369a58e7f6ddf3ff2))
* enhance balance computation and introduce manual resolution for transfers ([6f731a5](https://github.com/aevrHQ/pay/commit/6f731a57c894a06caefaf29fe8a2de304cbeee6f))
* enhance balance management and authorization actions across domains ([0443fb0](https://github.com/aevrHQ/pay/commit/0443fb06fddd3a82bfaafbb0473aa0e9c9b3806d))
* enhance demo interface with sender wallet auto-population and hints ([de01318](https://github.com/aevrHQ/pay/commit/de01318ad418ed3e031e280768ab0ce541a57377))
* enhance Flutterwave integration with modal closure and server verification ([565c16b](https://github.com/aevrHQ/pay/commit/565c16ba06d90476f91fc681a1f818397dd34741))
* enhance manual resolution handling and improve FX snapshot management in transfers ([8962020](https://github.com/aevrHQ/pay/commit/8962020a52bb59dab26041179db7249d9272f90b))
* enhance MongooseStorageAdapter with consistent returnDocument option usage and improve session handling ([f99ef04](https://github.com/aevrHQ/pay/commit/f99ef04488a950e2d955a644356ccaeabe0bb828))
* enhance operation finality and wallet constraints ([3132d6b](https://github.com/aevrHQ/pay/commit/3132d6b6129e0e4cd54ab4cdb725f7a1ee29f6b6))
* enhance operations and wallet handling with reconciliation support and idempotency checks ([0483df4](https://github.com/aevrHQ/pay/commit/0483df4bac181b1ec4968016f354a9e7c6269777))
* enhance payment client to include authorizer and rateProvider in createPayClient function ([64a05f3](https://github.com/aevrHQ/pay/commit/64a05f3e0433d4a373c58868faf13eeb41f5b22f))
* enhance payment page and checkout session functionality with multi-provider support ([b03c648](https://github.com/aevrHQ/pay/commit/b03c648938fd5a2065c76475ef1d9032171446df))
* enhance payment pages and checkout session handling ([2931ce3](https://github.com/aevrHQ/pay/commit/2931ce33c4484e8029d90c707917389652a95804))
* enhance payment processing models and add checkout session, quote, and payment functionality ([daacc9d](https://github.com/aevrHQ/pay/commit/daacc9d9611afb4b0fa8e52739aec7abbc731daf))
* enhance payment provider integration with public key support and status updates ([8ed00e7](https://github.com/aevrHQ/pay/commit/8ed00e7a1cfa6999ef180aee1fbff847d98164bf))
* enhance PaymentPage model with additional fields and update data handling in storage adapters ([30f74a2](https://github.com/aevrHQ/pay/commit/30f74a2607685511d457b032b1f2307e9becd763))
* enhance transaction verification and update MongooseStorageAdapter to use returnDocument option ([e2b837c](https://github.com/aevrHQ/pay/commit/e2b837c3b3d4c5be5740abdf4348f647b685d8c8))
* enhance transaction verification to support raw charge payloads and map status to completed ([f38bfd6](https://github.com/aevrHQ/pay/commit/f38bfd66c24a2ae11ea99b4f97daafd6ab0aa140))
* enhance wallet management with constraints and multi-wallet lock ordering ([dcaf8ae](https://github.com/aevrHQ/pay/commit/dcaf8ae73351e244570ff6d233933360b7527076))
* enhance webhook payload handling and add tests for amount and currency parsing ([d1f1044](https://github.com/aevrHQ/pay/commit/d1f104422836d38b14c821affbf27b6e21ecb548))
* enhance webhook processing with additional transaction details and mock provider updates ([8e82fe0](https://github.com/aevrHQ/pay/commit/8e82fe0ea48e49570070743effc4f31ccb4e9cee))
* enhance webhook verification with HMAC support and update payload structure ([839f2ce](https://github.com/aevrHQ/pay/commit/839f2ce08cb0e36363da73a7a1276b36d7d7ef99))
* **errors:** add detailed error classes for wallet and operation management ([f70bdb2](https://github.com/aevrHQ/pay/commit/f70bdb2e17a6d7fd7a1dbddcff36574ae71670d5))
* implement charge ID handling and enhance operation metadata persistence ([9c68a6e](https://github.com/aevrHQ/pay/commit/9c68a6e013a143df1701c0088467c645ac2991cd))
* implement Flutterwave and Paystack adapters for payment processing ([f202d54](https://github.com/aevrHQ/pay/commit/f202d5467e14948609cf1474636328b43af0f79f))
* implement payment pages, wallets, and webhooks domains ([89931ec](https://github.com/aevrHQ/pay/commit/89931ec6fd5e1b21dd5a588a83808caa713858fa))
* implement system wallet resolution and double-entry bookkeeping for deposits and withdrawals ([17d5445](https://github.com/aevrHQ/pay/commit/17d5445918c1e66496304ff5b086791ff8e87a6a))
* implement user manager and wallet management features in demo app ([65efc55](https://github.com/aevrHQ/pay/commit/65efc5544aa8e776446273695894b4c632122113))
* implement verification domain and enhance webhook processing with event handling ([06dcaac](https://github.com/aevrHQ/pay/commit/06dcaac70b7e233ecc7a35981969bd88889960dd))
* implement wallet payment method and enhance checkout session API to support wallet transactions ([ababf35](https://github.com/aevrHQ/pay/commit/ababf350427676c85d4b213699e7e6eeacdba5fe))
* integrate decimal.js for improved currency conversion precision and add effectiveAtPolicy to PayClientConfig ([dbb1388](https://github.com/aevrHQ/pay/commit/dbb1388f534a0c79ebc064c78b26beebf779c0b8))
* introduce ReversalNotAllowedError and update related operations; rename webhook methods for clarity ([c25cde3](https://github.com/aevrHQ/pay/commit/c25cde38c71a65884549998d2076b08a36d06305))
* make phone number optional in charge and checkout payloads ([c73da25](https://github.com/aevrHQ/pay/commit/c73da2585075c962d75273d612ff73cbab622885))
* optimize balance derivation and enhance entry metadata ([217e580](https://github.com/aevrHQ/pay/commit/217e5806a9546daabe447f09a13d2f7ef7e81255))
* update architecture specification with enhanced FX handling and operation status definitions ([494d83e](https://github.com/aevrHQ/pay/commit/494d83ec4a5b9194b710c637dbc5f05bc102a478))
* update demo app configuration and enhance checkout state management ([84c6788](https://github.com/aevrHQ/pay/commit/84c678809888a35b5dcf31ad0ff1273866612513))
* update QuoteExpiredError to use originalQuoteId and enhance session fulfillment status calculation ([8250826](https://github.com/aevrHQ/pay/commit/8250826674c64f3d69286f0ccd6cd14aea31131b))
* update unique constraint for transit wallet to align with checkout session ownership model ([caccab5](https://github.com/aevrHQ/pay/commit/caccab54b24f592c1d1ac9d5f3011f970eb3954d))