Frequently Asked Questions

Compliance

KYC / KYB

Q:  Is permanent residence in the US or Canada required for Cybrid KYC?
A:  Yes, permanent residence in the US or Canada is required for Cybrid KYC.

Q: What are the allowable countries for government ID in the Cybrid KYC?
A: The allowable countries for government ID in the Cybrid KYC are the US and Canada.

Q: Which forms of government ID are accepted for Cybrid KYC?
A: The following are the forms of government ID that are accepted for Cybrid KYC:

  • Passport
  • Passport card
  • Drivers license
  • State ID
  • Permanent resident card
  • Visa
  • Work permit

Q: What is the minimum age of a partner end-user for KYC/identification verification purposes?
A: The minimum age of partner end-users is 18 years old.

Q: Does the Cybrid Platform allow repeat identity verifications?
A: Yes, the Cybrid Platform allows repeat identity verifications as long as the same customer account is used. If a new customer account were created for the same individual and a new identity verification was performed, the identity verification would be flagged as a repeat and auto-denied.

Q: What is the next action if a customer KYC fails and user status changes to rejected?
A: Should a customer's KYC be unsuccessful (due to Government ID and Selfie error codes), and they wish to retry, kindly reach out to Cybrid Support to revert the customer's status to unverified, thereby enabling another attempt at the identity verification process.

Q: What are the expirations of the various identity verification types?
A: The following are the expirations of the various identity verification types:

  • Individual customer KYC (i.e., IDV type: "kyc", method: "id_and_selfie" ): 60 minutes
  • Business customer KYB (i.e., IDV type: "kyc", method: "business_registration" ): 24 hours
  • Beneficial owner KYC (not created via our API): 7 days
  • Document submission (i.e., IDV type: "kyc", method: "document_submission" ): 7 days

Q: What are the failed KYC with address_check_failure + database_check_failure mean?
A: The customer failed the database check on address after they were prompted to submit a supporting document, in other words, the address on the provided document does not match the address that the customer entered.

Q: What does it mean if a bank IDV has name_check_failure or address_check_failure error codes but it is in the state reviewing?
A: The bank account remains in the reviewing state because it is undergoing a manual compliance review. Typically, the bank verification would move to a completed state with a failed outcome, unless the customers are prompted to provide additional documents, then the state will change to reviewing. Once all the information was provided from the customer, it then should move to state completed and outcome failed, or expired if the customer doesn't complete the process in 60 minutes.

Authentication

Token

Q: What is the TTL for access tokens?
A: The TTL for access tokens is 30 minutes in the production environment and 8 hours in the sandbox environment.

Transfers

Q: What does the reviewing transfer state indicate?
A: The reviewing transfer state may occur after the pending transfer state, indicating that the transfer requires compliance review. After the reviewing state, the transfer state will progress to either complete or failed.

Funding

External bank accounts (Plaid)

Q: What does the transfer API error with the status of 422and the message of External bank account invalid and message code of invalid_external_bank_account mean during creating an ACH funding transaction? What steps should I take?
A: This API error can occur if the state of the external bank account is in refresh_required state. To resolve, the end user needs to connect/re-authenticate their external bank account which can be initiated by creating a new workflow with kind set to link_token_update.

Q: What does the transfer failure code refresh_required indicate?
A: The transfer failure code refresh_required means that the Plaid connected bank account must be reconnected by the end user by creating a new workflow with kind set to link_token_update.

Q: What does the transfer failure code plaid_institution_not_responding indicate?
A: The transfer failure code plaid_institution_not_responding means that Plaid is unable to communicate with the customer's bank. This can happen if the bank is temporarily offline or if there are performance issues on Plaid's side. Our recommendation is to retry again later. If the issue persists, it may be worth a different institution or bank.

Q: What should I do in case of plaid_no_accounts, plaid_multiple_accounts and plaid_item_not_supported?
A: These errors are from Plaid, and in most cases, there is no point in retrying the same account. The solution is that the account will need to be deleted, and another account (or the same one) will need to be re-added.

Q: What do R03 and R04 return codes mean and what should I do in this case?
A: Plaid verifies your bank account during the online banking sign-in process. However, this verification does not guarantee the ability to send or receive money, as there may be restrictions imposed by the customer's bank based on the account type and other factors. If Cybrid receive an R03 or R04 return code, we will notify you, then the external bank account must be removed. The customer should be notified by you that the account details they provided caused an ACH return. Then, they should contact their bank to inquire about the reason for the return and confirm the account information is accurate and up-to-date to minimizes the risk of encountering issues when linking the bank account through Plaid before attempting to make another transaction.

Withdrawal

Q: What does the API request error invalid_payment_rail_for_direction indicate for a withdrawal transfer from a bank-level external bank account?
A: The 422 error stating "Invalid direction for payment rail" and message code "invalid_payment_rail_for_direction" indicates that the RTP payment rail may not support the direction of the transfer you are trying to perform. In the case of initiating an RTP withdrawal transfer from an external bank account, this functionality is not yet supported for bank-level accounts, thus plea

Accounts

Q: What is the difference between account platform_balance and platform_available?
A: The difference between account platform_balance and platform_available is that the platform_available is the balance that has already been settled, whereas platform_balance includes pending transfers that have not yet been settled.

Balance Checking

Q: What action is required no_account or invalid_account is returned as the message_code on a 422 Unprocessable Entity response from the GET /api/external_bank_accounts endpoint?
A: When either the no_account or invalid_account message code is returned from the GET /api/external_bank_accounts endpoint, the ExternalBankAccount must be deleted and re-added as we no longer have access to the account.

External Wallets

Q: Why don't I provide a network when creating an external wallet?
A: The network is inherent in the asset that is specified when creating an external wallet, so when specifying the asset for quotes/external withdrawals, the network is predetermined.

Subscriptions / Webhooks

Q: What is the limit on active subscriptions for webhooks?
A: The limit is 5 active subscriptions (webhook endpoints).

Holidays

Q: Is the Cybrid Platform affected by bank holidays?
A: Yes, all US and Canadian bank holidays affect the Cybrid Platform. Every time there is a holiday, there will be an additional business day for all settlements.