Checks that a US bank account exists and is open, from its routing number and account number. Use it at onboarding, before you pay out to a merchant or debit their account. The answer comes back in the same response.
Coris treats Open Valid and Valid Pattern as a pass. Treat any other verification_status as a reason to ask the merchant for another account, or to review it by hand:
verification_status | Meaning |
|---|---|
Open Valid | The account is open and in good standing. |
Valid Pattern | The numbers have a valid format for this bank, but the bank has no history for the account yet. |
Closed Invalid | The account is closed or not valid. |
Invalid Pattern | The account number does not have a valid format for this bank. |
No Information Found | The bank has no data for this account. |
Debit Return Likely | A debit to this account is likely to be returned. |
The bank can also return Notification of Change Received, Debit Unsuccessful, Payment Rejected, Payment Instruction Error, Request Rejected or Unable to Determine.
Coris keeps each result for 7 days. A repeat request for the same account in that time returns the saved result with the same last_verified_at. Send force_refresh: true to run a fresh check.
In the sandbox the results are simulated. The same account number always returns the same status.
To also check that the account belongs to the merchant, use Authenticate a bank account.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||