Payments / RailsFedNow
FedNow
The Federal Reserve's instant payment rail. Used for instant transfers in the USA.
Rail overview
Use FEDNOW for US instant bank movement when the receiving institution supports the rail.
Instant rails still require provider confirmation; Conomy updates the payment once the rail accepts, completes, or rejects the instruction.
Use it for time-sensitive payout and funding flows where the bank supports FedNow reachability.
Required fields
Section titled “Required fields”| Field | Type | Description |
|---|---|---|
type | string | Must be "FEDNOW" |
currency | string | Must be "USD" |
fedNow.bank.accountNumber | string | Bank account number |
fedNow.routingNumber | string | 9-digit ABA routing number |
fedNow.customer.firstName | string | Account holder’s first name |
fedNow.customer.lastName | string | Account holder’s last name |
fedNow.customer.email | string | Account holder’s email |
fedNow.customer.documentNumber | string | SSN or ITIN |
fedNow.customer.documentType | string | Document type |
Example
Section titled “Example”{ "type": "FEDNOW", "currency": "USD", "fedNow": { "routingNumber": "021000021", "bank": { "accountNumber": "000123456789" }, "customer": { "firstName": "Michael", "lastName": "Johnson", "email": "michael@example.com", "documentType": "SSN", "documentNumber": "123456789" } }}Object
Section titled “Object”ABA routing number (9 digits).
Bank account number.
CHECKINGSAVINGSInformation on who pays the transaction
idstringUnique identifier for the internal service.
firstNamestringrequiredPayer's name
emailstringPayer's email
lastNamestringPayer's last name
phoneNumberstringPayer's phone number without prefix
phoneNumberPrefixstringPhone number prefix (e.g., +57)
documentTypestringDocumeny type of the entity (e.g., RUT, CURP, CURL). Go to the Supported Identity document types page for the complete list of supported values.
documentNumberstringThe document number associated with the documentType
addressobjectThe entity’s address information.
administrativeAreaLevel1stringThe first-level administrative division.
administrativeAreaLevel2stringThe second-level administrative division.
administrativeAreaLevel3stringThe third-level administrative division.
streetstringThe name of the street.
streetNumberstringThe street number.
optionalAddressstringAdditional address details.
countrystringCountry of operations for the entity, specified using the ISO 3166-1 alpha-3 standard (e.g., CHL, USA, MEX). Go to the countries page for the complete list of supported values.
zipcodestringZipcode f the address