The Verify API provides an instant and seamless way to verify bank accounts. Orum verifies accounts by pushing an instant micro deposit to the account in question. We are currently able to confirm if the account is open and valid, as well as ownership, and we push that information back to you via webhook.

Verification Status

Status of account verification.

Verification StatusDescription
pendingAcknowledgment of the request being received
validA bank account is open and valid
closedA bank account is closed
invalidThe bank account information provided is invalid
failedThe verification request has failed

Status Reasons

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

Status ReasonDescription
blocked_accountAn account in the transfer request was blocked or prohibits posting of transfers against it
closed_accountAccount number specified has been closed on the bank of account's books
deceased_partyOne of the parties in the transfer request was deceased
duplicated_transferDuplicate of a previous transfer request
invalid_accountThe account number provided is invalid or does not exist
invalid_fieldThere was erroneous, invalid, or missing data in the transfer request
invalid_routingThe routing number provided is invalid or does not exist
regulatory_errorThe transfer could not be completed because of limitations imposed by a regulator
unavailable_financial_institutionSending or receiving financial institution is currently not available or does not support this request type
unexpected_errorThere was an unexpected error with this transfer request
unsupported_transferTransfer type is not supported or forbidden

Verify Webhooks

Verify webhooks are configured using the same momentum 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"

Verify Sandbox Environment

The sandbox environment is also available to verify APIs.

In the sandbox, all verify accounts you create will have a verification_status of "pending" in the POST response and will then move to a verification_status of "valid".

To simulate non-valid verification_statuses, pass the status you want to simulate in the account_holder_name field along with all other required fields. You will receive a webhook when the account's status updates from "pending" to the simulated status.

NOTE: Only "failed" and "invalid" non-valid verifications statuses are supported in sandbox.