Instant payments
Instant payment APIs
Instant payments enable individuals and businesses to transfer funds that clear and settle within seconds between US bank accounts at different US-based financial institutions. Cross River (CR) facilitates instant payments through three networks: CRNow, RTP® via The Clearing House (TCH), and FedNow.
Requirements for credit transfers via API
To initiate a credit transfer via API, you must have the following information:
- The account number funding the transfer.
- The transfer amount.
- The creditor’s account number and routing number at the receiving bank.
Get started with Cross River APIs.
GET calls
- Add query parameters to filter the response the API returns to general GET calls.
- Use pagination to control presentation of your results.
API calls
This table provides an overview of the Instant Payments APIs, described in detail below.
Action | API Call | Description |
|---|---|---|
POST /v1/payments | Initiates a single Instant Payment | |
| POST /v1/payments/payment-request | Initiates a request for a single Instant Payment |
POST /v1/payments/{id}/payment-request/cancel | Initiate a cancellation of a requested payment | |
POST /v1/payments/{id}/return-request | Initiate return requests for outgoing payments that has already been sent | |
POST /v1/payments/{id}/return-approval | Approve an inbound return request for a previously received RTP credit transfer | |
POST /v1/payments/{id}/reject | Rejects an inbound return request previously received on a real-time payment | |
GET /v1/directory | Retrieves a list of instant payment-related services supported by a specific financial institution |
Monetary amounts in API calls and responses are formatted as whole numbers, with no decimal point separating dollars and cents.
Related topics
Tutorials
See our API tutorials to learn how to:
- Send an instant payment: Originate a payment using RTP, FedNow, CRNow or network interoperability.
- Get service info: Find out the instant payment services a specific financial institution supports, per network (RTP or FedNow).
- Set payment expiration: Set your own custom expiration time for retrying a payment when a receiving financial institution is down.
- Fraud reporting: Each instant payment network has specific requirements for reporting suspected fraud, with its own criteria for what qualifies as reportable fraud