Bank Verification Status

Read on dealing with bank verification statuses

After a bank account has been connected using our widget, the bank account undergoes verification before it is successfully added. The bank account will have different verification statuses which you can retrieve using our API or through webhooks.

1. PENDING: Once the bank account has been added through the widget, verification checks are conducted on the bank account. While the verification checks are in progress, verification_status of the funding account will be PENDING.

   1. You can retrieve verification status using the GET User funding account API.

   2. user_bank_verification_pending webhook will also be sent to the subscribed link.

2. VERIFIED: When all verification checks are completed and the bank account is successfully added, the verification_status of the user’s funding account will be moved to VERIFIED.

   1. You can retrieve verification status using the GET User funding account API.

   2. user_bank_added webhook will also be sent to the subscribed link.

3. FAILED: If verification checks are unsuccessful or there is an issue, the verification_status of the user’s funding account will be moved to FAILED.

   1. You can retrieve verification status using the GET User funding account API.

   2. user_bank_verification_failed webhook will also be sent to the subscribed link.

4. LOGIN_REQUIRED: In some cases, the user may be required to re-login to their bank account.The verification_status of the user’s funding account will be moved to LOGIN_REQUIRED.

   1. You can retrieve verification status using the GET User funding account API.

   2. bank_login_required webhook will be sent to the subscribed link.

   3. You will have to reopen the bank widget with the funding account ID so they can re-login to their bank account.

   4. Please note that for certain cases the user may need to communicate with their bank before re-linking their bank account.

When verification status of the user’s funding account is PENDING, users can create a transaction/transfer. However, the transaction will be placed on HOLD. Only when the user’s funding account is in VERIFIED status, the transaction will be forwarded for processing, given that all other compliance checks have been completed.