Payments / RailsRTP
RTP
The Clearing House's Real-Time Payments network. Used for instant pay-in in the USA.
Rail overview
Use RTP for real-time US bank movement through The Clearing House network.
The payment is sent for real-time provider processing and Conomy receives the accepted or failed state asynchronously.
RTP is best for user-visible money movement where delayed ACH settlement would create support burden.
Required fields
Section titled “Required fields”| Field | Type | Description |
|---|---|---|
type | string | Must be "RTP" |
currency | string | Must be "USD" |
rtp.bank.accountNumber | string | Bank account number |
rtp.routingNumber | string | 9-digit ABA routing number |
rtp.customer.firstName | string | Account holder’s first name |
rtp.customer.lastName | string | Account holder’s last name |
rtp.customer.email | string | Account holder’s email |
rtp.customer.documentNumber | string | SSN or ITIN |
rtp.customer.documentType | string | Document type |
Example
Section titled “Example”{ "type": "RTP", "currency": "USD", "rtp": { "routingNumber": "021000021", "bank": { "accountNumber": "000123456789" }, "customer": { "firstName": "Sarah", "lastName": "Williams", "email": "sarah@example.com", "documentType": "SSN", "documentNumber": "456789012" } }}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