Payments
Wires
Send and receive
6 min
how wire payments work understanding the mechanics of sending and receiving payments is essential for managing account balances these factor influence when a payment will settle (clear) direction is it an inbound or outbound payment? payment type is it a value (meaning credit transfer ) or a non value (meaning investigation request )? contractual cutoff time was the outbound payment request received by cross river before the cutoff time defined in your contact? outbound wires when a customer uses send a wire transfer api, money is wired to an account at an external bank when a wire payment is accepted and acknowledged by the federal reserve, an {{imad}} (imad) is assigned to the payment and returned in the api this can be used to track the payment via the fedwire funds transfer system when you initiate an outbound payment, the following steps occur the system attempts to post a transaction to the originating account for the amount of the payment the system scans the payment data for ofac compliance any potential matches require manual review by our bsa/aml team once the transaction posts successfully and gets ofac clearance, the payment status changes to pending if the transaction cannot be posted to the originating account, the payment status updates to rejected the wire payment rejected webhook event triggers the next step is to add your payment to a distribution or outbound batch distributions are created throughout the day and are sent to the federal reserve for processing once the distribution is released and acknowledged by the federal reserve, the wire payment sent event triggers, and the payment status updates to completed , marking the end of the payment lifecycle see our tutorial to learn how to send a wire payment via api the following diagram shows the status and webhook events flows for outbound wire transfers inbound wires when a customer receives an incoming wire, an external bank wires money to a cross river account you receive a webhook events to indicate that a wire has been received when an inbound wire payment is received, the system attempts to post a transaction to the account specified in the beneficiary identifier field within the payment details once the payment posts successfully posted, the wire payment received webhook event triggers if the transaction fails to post, the payment returns to the originating bank inbound payments that fail to post and are returned will not be visible to you there are various ways a wire can be originated due to the numerous fields available in the payment message consequently, the details within the wire payment received webhook event payload may differ the following diagram shows the status and webhook events flows for inbound wire transfers