[Partners] Start onboarding a new business
If you haven't visited the guide: how to make your first loan? we recommend you to visit it first.
Timeout after: 30 seconds (status code will be 504 in such a case)
In order to request loans you will need to have borrowers. In order to test borrower's eligibility, we'll need
to have access to borrower business' financial data.
This can be achieved in two ways:
Either you have this piece of information and you may use the
sharing business data
API documentation to do so, or you might want to rely on defacto's onboarding process to get this information.
In the later, you will need to create an onboarding for the business you want to request loans for.
Behavior
When you send this API request providing business information, your referral and callback url:
The system will start an onboarding for you and you will get its id in the response.
Then you must redirect the borrower to https://app.getdefacto.com/onboarding/continue/{onboarding_id}
so that the borrower can select his financial tools and share as much data as he wants to max-out
his eligible amount.
Once borrower has accepted defacto's T&Cs and created his account, he'll be redirected back to the redirect_url
you provided and if you subscribed to CREDIT_LINE.Created webhook you will receive it shortly.
Read webhook for details.
Frequently Asked Questions
How do I get onboarding results?
You can use the GET /onboarding/{onboarding_id} endpoint to retrieve the onboarding results.
What should I do if the status of the onboarding is expired?
Onboardings last for 24 hours;
after what you'll have to repeat the POST /onboarding request you just made.
How do I get the borrower's ID once onboarding is COMPLETED?
You can use the GET /onboarding/{onboarding_id} endpoint to retrieve the borrower's ID under the borrower_id
attribute; or you can GET /borrowers/?identifier={business_identifier} to directly get the borrower object.