Instant Payments

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 instant payments apis for rtp, fednow, and crnow are available in the rtp module of our cos sandbox register with cross river apis this table provides an overview of the instant payments apis, described in detail below action api call description instant payments docid\ kp nayzjmsetlxub5n36o post /v1/payments initiates a credit transfer instant payments docid\ kp nayzjmsetlxub5n36o post /v1/payments/payment request initiates a request for payment instant payments docid\ kp nayzjmsetlxub5n36o post /v1/payments/{id}/payment request/cancel initiates a cancellation of a request for payment instant payments docid\ kp nayzjmsetlxub5n36o 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 originate a credit transfer initiates an instant payment credit transfer enables real time fund transfers from your account to the recipient's account transfers can originate from master account deposit account (dda) associated subledger cross river cannot determine how a receiving financial institution displays payment details to its customers for information on how fields appear in their banking portal or statements, please contact the receiving fi directly originate a request for payment initiates a request for payment (rfp) allows the recipient to authorize and trigger an instant payment credit transfer rfps can be initiated from master account deposit account (dda) associated subledger cancel a request for payment cancels a payment request if a credit transfer or payment request response has not been received refer to request and response codes for complete list of values for reason code get service info for specific fi (directory) retrieves a list of instant payment services supported by a specific financial institution if the bank supports tch and fednow instant payments, service codes for both networks are returned for fednow, an fi must register each rtn separately an fi can have some but not all rtns registered for fednow add query parameters to filter the response the api returns to all get calls use pagination docid\ jv50x2 p 4rzd fkonoy to control presentation of your results associated webhooks events event name description rtp payment sent the rtp payment has been successfully transmitted to the receiving institution, and the funds are now available in the receiver's bank account rtp payment received an inbound payment has been received from another institution and successfully posted to an account in cos rtp payment rejected payment rejected – the payment was rejected by the receiving institution or rtp network insufficient funds – the payment could not be processed because the originating account had insufficient funds rtp payment canceled partner cancellation – the payment was canceled at the request of the partner research cancellation – a payment with a status of researchrequired has been canceled rtp payment researchrequired no response was received for the outbound payment research is required to determine whether the payment should be completed or canceled rtp hold escalated a hold on an outbound payment has been escalated by the operations team, typically indicating that additional documentation or action is required from the partner rtp refund requested a request has been received to refund a previously accepted credit transfer rtp payment queued the receiving institution is offline the payment will be processed once the receiving institution returns online rtp limits utilization changed this webhook triggers when the percentage of successful transfers reaches 5%, and continues to fire at each 5% increment (e g , 10%, 15%, etc ) rtp payment expired this webhook is triggered when an outgoing credit transfer in the queue expires or when a request for payment expires due to the absence of a response or incoming credit transfer related topics instant payments docid\ p jm1copzmzow4jo uasb instant payment queuing docid\ zqd 2iu4g7vo2f5etopdo instant payment limits docid\ kfhr7xvubeysgaiagtm8v request and response codes system error codes docid\ ce pi3muasult3r6i99xm tutorials instant payments docid\ kp nayzjmsetlxub5n36o query the directory docid\ k3z1 kezqn5wj iamwagm