Troubleshooting and FAQs
Learn how to test, debug, and optimize your the Business Onboarding integration in RiskOS™.
Common troubleshooting scenarios
Partner enrichment not returning a response
Ensure the enrichment step has been properly configured and added to the workflow. Note that some enrichments might require you to provide your own API key.
UBOs or Associated Individuals are not being evaluated
Certain feature flags have to be enabled for the connected UBO/Individual workflow to function properly. Double check your feature flags on the Business Onboarding Setup Page.
Additionally, be sure that the UBO/Individual verification workflow is being called from the main Business Onboarding workflow and is returning results.
Businesses are consistently not being verified
Be sure that the Partner(s) you are using within the workflow support the geographies you wish to cover. It may be that more than one Partner is required if you need to verify businesses from a broad range of countries.
Partners are taking a long time to return data
While most of the time, Partners can return data nearly instantly, in some cases, KYB Partners will need to retrieve documents from registries and other sources asynchronously, which will take as long as a few minutes.
Company not found in search
Double check spelling of the legal business name, and ensure you are not using a DBA. If you've not done so, be sure to include EIN, address, and website, as these can further help locate a company.
Unexpected decision
Review the configured risk rules and thresholds in your Business Onboarding workflow. Review the Decision Path in the Case Management page to see if Partner enrichments and other steps were properly called and do not produce errors.
Partner enrichment couldn't verify a sole proprietor
Often sole prop data is harder to verify, and some Partners are unable to. The best course of action is to send sole proprietors through a traditional KYC flow, which you can do via the UBO/Individual Verification workflow.
Differing results in sandbox vs. production
Most of our Partners don't utilize the same data in sandbox vs. production API calls. Typically there will be a set of test data that can be utilized in sandbox environments vs. live data utilized in production environments.
The business was verified, but the tax ID was not.
This sometimes happens in the case of newer companies. If the business was formed within the last 30 days, often they will not have an EIN/tax ID since it typically takes 30 days for those to be issued.
A partner that provides asynchronous responses is stuck in a Response Pending status.
Double check to ensure the webhooks are properly configured on both the Partner side and RiskOS. This is most often the reason for this status being persistent and unresolved.
FAQs
Does Socure offer any business verification solutions?
Socure provides customers with the choice to use any of our KYB Partner integrations for business verification purposes within RiskOS. Additionally, Socure products such as Digital Intelligence help mitigate fraud related to business onboarding scenarios, and Watchlist Plus can provide sanctions checks and adverse media for business entities.
How does RiskOS™ handle verifying business owners?
RiskOS provides an innovative solution for verifying business owners, or UBOs, alongside the business entity. Using a single API endpoint and connected workflows, the business entity and all associated individual data that is provided can be quickly and confidently verified using both Socure and Partner products.
Which KYB Partner should I choose?
Selecting the right KYB Partner or Partners is important to ensure that you have the verification coverage that you require. Some Partners are better in the US, while some have broad coverage internationally. Specific use cases like lending, ecommerce, social networks, etc. all require different types of coverage and verifications, which makes choosing the right Partner an involved process. We recommend consulting our Solution Consulting team for assistance.
How can I find out who owns a business entity?
Determining business ownership if you don't have access to formation documents or cap tables can be tricky. In the US, much of that data is intentionally hidden behind registered agents and multi-layered entities. While some KYB Partners can provide a limited amount of ownership information, coverage is typically minimal.
Outside of the US, the possibilities open up as many countries require business ownership to be made public. Most of our international KYB Partners will provide ownership data for a business anytime it's available.
I need to support KYB in more than one country. Do I need a separate workflow for each country?
RiskOS makes it easy to orchestrate onboarding events from different countries. A single workflow can contain multiple Partner products, and it's easy to add condition steps to direct the workflow to send data to the vendor that supports the country in question.
Where does KYB data come from?
Socure partners with some of the top business data providers in the industry in order to offer customers comprehensive coverage for KYB verification. Our partners aggregate data from Secretaries of State, government registries, independent business registries, and other data sources.
What should less regulated organizations such as ecommerce platforms do when it comes to onboarding businesses?
Customers without strict due diligence guidelines can still benefit from utilizing RiskOS Business Onboarding workflows. Depending on their risk appetite, they might choose to utilize comprehensive verification solutions like financial institutions do. Alternatively, they might prefer a lighter touch solution such as detecting potential risk based on a business's web presence, industry classification, customer reviews, etc. Our KYB Partners offer tools for such purposes.
Updated 10 days ago
