The Fast Track Onboarding API is designed for partners who want to provide financing to their merchants using their own capital, and need YouLend to perform KYC and AML-related checks as required by regulation, disburse funds to the merchant, and manage repayments and reconciliation. This page covers onboarding a merchant via the Fast Track API.

Unlike the standard Onboarding API, where YouLend provides capital and carries the risk of potential defaults, the Fast Track API is for partners who bring their own capital and take on the risk themselves.

Overview

Most integrations with the Fast Track Onboarding API will cover the following steps:

1. Create a Lead

Create a financing application for the merchant

2. Submit KYC Docs

Provide documentation for KYC and AML checks

3. Financing Agreement

Submit financing agreement documents

4. KYC & AML Checks

YouLend performs regulatory checks

5. Approve Funding

Approve the disbursement of funds

6. Disburse & Manage

YouLend disburses funds and manages operations

1. Create a Fast Track lead

Create a financing application for the merchant.

Key endpoint: Create a lead

⚠️
YouLend expect partners to have adequate justification for sharing personal details about a merchant and that the merchant has agreed that their personal details will be shared with YouLend and processed in line with YouLend's Privacy Policy and Terms of Service.

📘
Partners can use the variable thirdPartyCustomerId to share their own internal customer ID for the merchant, making it easier to match the lead to your internal systems.

2. Submit KYC and supporting documents

Provide YouLend with the documentation required to perform KYC and AML checks on the merchant. This may include:

Key endpoints:

Submit KYC documents for the merchant (e.g. government-issued ID such as passports or driver's licenses)
Submit KYC documents for significant persons (Directors and Ultimate Beneficial Owners of the business)
Submit additional supporting documents as required

📘
You can use the Update a lead endpoint to update the merchant's details at any point before KYC checks are completed.

3. Submit financing agreement documents

Submit the financing agreement documents that outline the terms of the financing arrangement between the partner and the merchant.

Key endpoint: Submit a financing agreement document

4. YouLend performs KYC and AML checks

YouLend will perform the required KYC and AML checks on the merchant. You can track the progress of these checks either by polling the Retrieve lead status endpoint or by subscribing to webhooks.

Key endpoint: Retrieve lead status

👍
We recommend using webhooks to be notified of KYC check outcomes. See our webhook events guide for more information.

Fast Track Webhook Events

Event Code	Description
`FAS10002`	Potential problems with KYC checks, please provide additional information
`FAS10003`	Fast Track KYC Checks Rejected
`FAS10007`	Fast Track KYC Checks Completed

If you receive a FAS10002 event, you will need to provide additional information or documentation to resolve the issue before KYC checks can be completed.

Example FAS10002 Webhook Payload

{
  "EventCode": "FAS10002",
  "Message": "Potential problems with KYC checks, please provide additional information",
  "EventProperties": {
    "FastTrackLeadId": "b5799179-4d2b-42ca-83e6-804c6c7e0198",
    "SignificantPersonsErrors": [
      {
        "ThirdPartyPersonId": "person-123",
        "PersonErrors": [
          {
            "ErrorCode": "SPE0001",
            "ErrorMessage": "Unable to identify sig person, no id"
          }
        ]
      }
    ],
    "KycErrors": [
      {
        "ErrorCode": "CPE0005",
        "ErrorMessage": "Ownership structure unclear"
      }
    ]
  }
}

If you receive a FAS10002 event, review the SignificantPersonsErrors and KycErrors arrays to identify what additional information or documentation is needed before KYC checks can be completed.

Example FAS10003 Webhook Payload

{
  "EventCode": "FAS10003",
  "Message": "Fast Track KYC Checks Rejected",
  "EventProperties": {
    "FastTrackLeadId": "a1d4e8b2-7c3f-4a91-b6e5-9f2d8c4a71e3",
    "RejectionReason": "KYC checks rejected"
  }
}

If you receive a FAS10003 event, the KYC checks for this lead have been rejected. Review the RejectionReason field for details on why the checks failed.

Example FAS10007 Webhook Payload

{
  "EventCode": "FAS10007",
  "Message": "Fast Track KYC Checks Completed",
  "EventProperties": {
    "FastTrackLeadId": "c7f2a3e1-5b84-4d09-ae62-1f8b3d6c94a7"
  }
}

If you receive a FAS10007 event, the KYC checks have been completed successfully and the lead is ready for funding approval.

5. Approve funding

Once KYC checks have been completed successfully (FAS10007), approve funding for the merchant. This informs YouLend that you, as the capital provider, have approved the disbursement of funds.

Key endpoint: Approve funding

6. YouLend disburses funds and manages ongoing operations

After funding is approved, YouLend disburses the funds to the merchant's designated bank account and manages repayment collection, reconciliation, and reporting on an ongoing basis.