> ## Documentation Index
> Fetch the complete documentation index at: https://developer.rollfi.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# October 2026 API Release

> Improved payroll import performance, expanded transaction visibility, and clearer payroll and bank-account configuration.

## Overview

October's API updates improve payroll import performance, expand transaction visibility, and provide clearer bank-account and state-registration information. Integrations can also specify payroll processing days when creating pay schedules.

## Highlights

* **State-registration guidance:** Display readable format examples alongside validation rules.
* **Transaction transparency:** Retrieve transaction identifiers and payment details for reconciliation and troubleshooting.
* **Payroll import performance:** Benefit from enhanced processing for synchronous and asynchronous imports where enabled.
* **Payroll processing configuration:** Specify processing days when creating a pay schedule, with next-day payroll available through production enablement.

## Enhancements

### State-Registration Format Examples

`getStateRegistrationFields` now includes an optional `expectedFormat` array in field metadata. These examples help integrations display readable input guidance alongside existing `validationFormat` rules.

**What to update:** Display format examples when available. Continue using `validationFormat` for validation and support fields where `expectedFormat` is absent.

### Payroll Transaction Transparency and IDs

`getPayPeriodDetails` provides transaction-level details when `includeTransactions` is set to `true`, making payroll payments easier to reconcile and investigate.

Employee and company transaction records include:

* `payrollTransactionId` to identify individual transactions.
* `parentTransactionId` to link related transactions.
* `requestReferenceId` for request correlation.
* Transaction amounts, statuses, and initiation/update timestamps.

Company transaction records also include banking trace numbers and transaction response details, where available.

**What to update:** Request transaction details when needed and allow for unavailable transaction references or banking details.

### Synchronous and Asynchronous Payroll Import Performance

Payroll import processing has been enhanced with parallel employee processing, batched tax calculations, and shared preparation work that reduces repeated processing.

These enhancements support both synchronous and asynchronous regular and differential payroll imports where parallel processing is enabled. Historical payroll imports also support a configuration-controlled parallel processing path.

**What to update:** Continue using the existing import endpoints. Use `importMethod` to request synchronous or asynchronous execution for regular and differential imports, subject to feature availability. Parallel processing is enabled separately through Rollfi configuration.

### Bank-Account Linking Details in `getCompanyInfo`

Bank-account records returned by `getCompanyInfo` now include `linkType`, helping integrations identify how an account was connected:

* `Manual`
* `Plaid`
* `CustomProvider`

The response can return `N/A` when linking information cannot be resolved. Bank-account `status` also reflects a relinking requirement when one is recorded, helping integrations identify accounts that need attention.

**What to update:** Use `linkType` to distinguish linking methods and handle relink-related statuses in account recovery workflows.

### Set Payroll Processing Days with `addPaySchedule`

Integrations can supply `payrollProcessingWorkingDays` when calling `addPaySchedule` to configure the processing interval for a new pay schedule. This setting is separate from `paymentMode`, which controls Automatic versus Self-Initiated payroll submission.

> [!NOTE]
>
> Next-day payroll carries an additional customer charge and must be enabled by Rollfi before use in production. Supplying a next-day processing value does not itself enable the service. Please reach out to Rollfi for pricing, eligibility, and production-enablement details.

## Notes for Integrators

| Area | Change | Action |
| - | - | - |
| State registration | Optional `expectedFormat` array | Display examples when present; retain existing validation handling. |
| Payroll transactions | Expanded transaction details in `getPayPeriodDetailsV2` | Set `includeTransactions` to `true` when needed and support unavailable references. |
| Payroll imports | Enhanced processing where enabled | Retain existing endpoints and confirm feature availability with Rollfi. |
| Company bank accounts | Added `linkType` and relink-status visibility | Handle linking methods, fallback values, and relinking requirements. |
| Pay schedules | Processing-day configuration through `addPaySchedule` | Supply `payrollProcessingWorkingDays` as needed and contact Rollfi before using next-day payroll in production. |

## Recommended Next Steps

1. Review transaction and bank-account response handling for the additional fields.
2. Add state-registration format examples to your forms where available.
3. Contact Rollfi to confirm parallel-import availability or enable next-day payroll in production.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.