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 422
and 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.