GuidesTokenization

Runner.js Versions

Versioning

Runner.js releases are deployed periodically to introduce new features. In order to not introduce breaking changes to existing integrations, several releases are kept live concurrently.

Important: When breaking changes are introduced in a new release, integrated clients are notified. We make all efforts to minimize the impact of breaking changes, however, integrators should test everything in staging prior to updating the runner.js version in production.

In staging, it is possible to use the “latest” release to have all recent updates. We strongly recommend using a fixed version in your production environment. After some time, old versions of runner.js will be discontinued. These discontinuations will be communicated to provide ample time to update any environments to newer, active versions.

Current Version

Latest stable release: 1.5.5 — Use this version in your production environment. Copy the CDN snippet from the Runner.js guide.

Runner.js Releases

VersionDate of ReleaseDescription
1.5.5 (Latest)5/5/2026- iStream last4 returned on tokenization response
1.5.44/14/2026- Payroc surcharge support
1.5.33/9/2026- Card reader tokenization support (Clover Flex, Clover Mini, Ingenico devices)
- Debouncer moved to Runner to enforce input settling before tokenization
- Advanced error messaging via tokenizererror and validation callbacks
- onInputChange API for card reader input events
- Loading wheel support extended to all tokenizers
- Buffer size increase
1.5.22/6/2026- Added destroy() method to programmatically tear down a Runner.js instance
1.5.11/30/2026- Payroc hosted fields library updated to v1.7
1.5.012/16/2025- Plaid integration support
1.4.811/26/2025- ACH improvements
- iStream form improvements
- CCN validation
- Tokenizer validation fixes and bug fixes
1.4.711/17/2025- Improved CSS styling for iStream fields
1.4.69/3/2025- Copy and paste support for ACH account and routing number fields
1.4.58/27/2025- iStream account type field added
1.4.48/7/2025- iStream field and form improvements
1.4.37/22/2025- Enhanced vault creation with card brand ID, last4, and expiration
- Expiration fetched from gateway response when not provided in request
- Payroc contact info (email and phone) now prefills
- Expiration returned in onTokenize response
- Orientation param added (CardPointe only)
- Payroc client library update
1.4.24/28/2025- ACH form validation
1.4.14/25/2025- Cybersource (CYBS) gateway form support
1.4.03/12/2025- Payroc gateway integration