Verification

Verify bank accounts instantly with our Verify API. Verify determines within 15 seconds whether an account is open and valid. The API initiates verification utilizing RTP or FedNow penny deposits (Orum’s penny) and pulls back the information from the real-time ping. If RTP and FedNow are unavailable, the API automatically falls back to Same-Day ACH. In that scenario, the maximum time to verify account status would be T+3 business days. In addition, Verify confirms ownership and we push that information back to you via webhook.

Verification Status

Status of account verification.

Verification Status	Description
pending	Acknowledgment of the request being received
valid	A bank account is open and valid
closed	A bank account is closed
invalid	The bank account information provided is invalid
failed	The verification request has failed

Status Reasons

Possible status reason codes for failed, invalid, and closed accounts.

Status Reason	Description
blocked_account	An account in the transfer request was blocked or prohibits posting of transfers against it
closed_account	Account number specified has been closed on the bank of account's books
deceased_party	One of the parties in the transfer request was deceased
duplicated_transfer	Duplicate of a previous transfer request
invalid_account	The account number provided is invalid or does not exist
invalid_field	There was erroneous, invalid, or missing data in the transfer request
invalid_routing	The routing number provided is invalid or does not exist
regulatory_error	The transfer could not be completed because of limitations imposed by a regulator
unavailable_financial_institution	Sending or receiving financial institution is currently not available or does not support this request type
unexpected_error	There was an unexpected error with this transfer request
unsupported_transfer	Transfer type is not supported or forbidden

Verify Webhooks

Verify webhooks are configured using the same Deliver endpoints. For event_types the webhook configuration can either use subscribe_all or specifically use verify_account_updated for verify webhook events.

Sample Webhook Event

{
   "event_id": "36fa9e91-b63d-4cc4-9055-eab98198a7ea",
   "event_type": "verify_account_updated",
   "created_at": "2023-06-01T15:00:09.374Z",
   "event_data": {
       "account": {
           "id": "2b610cd7-0366-47a0-94c7-923dc0472bc5",
           "account_number": "12345678910",
           "routing_number": "102001017",
           "account_holder_name": "John Doe",
           "verification_status": "pending",
           "estimated_verification_date": "2023-07-26T00:00:00Z",
           "created_at": "2023-06-01T14:59:46.751044Z",
           "updated_at": "2023-06-01T15:00:05.250318Z"
       }
   }
}