November 2026
In November 2026 we updated token management fields and a response example, added a new field on an event, added a new secondary-account indicator, new closure reason, updated AutoPay status codes, clarified a Posted Transactions RDF field, added regex to Payment Hub API, and added guides and API reference for Account Linking via Microdeposits.
Token management updates
The Token Lifecycle Management guide has been updated to include the ACTIVATE operation, and the example response for Get Card Tokens now includes the fields payment_app_instance_id and token_suffixas well as thedevice object and a Device Types enumeration.
Updated GIVE response example
In the Get Instant Verification response example, we added additional values to the reason_cd field to reflect its capability to return multiple reason codes as an array of strings.
New field on ODAA event
Added thebalance_id field to the ODAA: overdraft_authorization event.
New secondary-account indicator
In the Get Related Accounts endpoint, we added the boolean isSecondary field to every account returned in the self_accounts, child_accounts, parent_accounts, and sibling_accounts lists. This field is true for secondary accounts and false otherwise, regardless of whether the secondary and primary accounts share the same client_id. This allows you to identify secondary accounts even when parent_accounts is empty.
New account closure reason
In the Modify Status endpoint, we added a new value for the closureReason field:
external_deposit_fraud_first_party
Updated AutoPay status codes
We updated the endpoint-specific status codes for the Autopay-related endpoints. See specifics for each endpoint below:
Set AutoPay Plan
We removed retired codes 629-01, 629-02, and 629-03. We added:
- 639-01 — Account not enrolled in autopay
- 639-02 — Cannot update autopay while execution is in progres
- 639-03 — Cannot update autopay while a retry is pending
- 639-06 — Autopay is only allowed on the primary credit account
Set AutoPay Attempt
We added 640-01 — Retry budget exceeds billing cycle.
Get AutoPay History
We removed 639-04 and 639-05, which were incorrectly documented as returned by this endpoint. We added 641-01 — Account not found.
Get AutoPay Plan
We removed 639-07 and added 677-01 — Autopay plan not found. <!-- FEDX-3613 –>
Association Trans ID field updated
In the Posted Transactions RDF, we updated the description of the ASSOCIATION TRANS ID field to clarify that it is now applicable to both Visa and Mastercard—for Mastercard, this field uses the Transaction Link Identifier (TLID) from DE105.
Regex for Payment Hub API
To the Payment Hub endpoints, we added regex to the field descriptions and included clarification between FedNow and Fedwire character sets.
Account Linking via Microdeposits
We added the following pages to cover Account Linking via Microdeposits functionality, which allows account holders to link bank accounts using small deposits to the external account:

