[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 the onboarding tunnel so that he can select his financial
tools and share as much data as he wants to max-out his eligible amount:

• In the normal case, redirect him to
  https://app.getdefacto.com/onboarding/continue/{onboarding_id}.
• When the response contains a secure_resume_link, redirect him to that link instead of the
  bare continue URL above. This happens when the business already has a bank-connected onboarding:
  to avoid exposing another party's financial data, that tunnel is gated and can only be reopened by
  a link carrying a short-lived secure token. The secure_resume_link is exactly that
  pre-authenticated continue URL. It is valid for 2 hours — if it expires, POST /onboarding again
  to obtain a fresh one.

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 168 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.