Renewals Integrations

There are two approaches a partner can take to facilitate renewals.

1. Partner hosts the entire renewals experience in their environment
   1. Most suitable for partners with a fully embedded solution
2. Partner performs renewals outreach, and the merchant completes their renewals journey with YouLend
   1. Most suitable for partners with a hybrid or referral solution

Fully Embedded Renewals

Partners using the Preapproval API can receive preapproved and/or prequalified offers for renewals simply by using their existing process of calling the preapproval API.

Provided the partner uses a consistent thirdPartyCustomerId, YouLend will automatically use any previous fundings in the calculation of preapproved or prequalified offers.

Partners can surface these prequalified or preapproved offers to their merchants in the partner hosted dashboard.

Creating a renewal lead is the same as creating an initial lead, except with the addition of the renewal object in the Create lead request.

 "renewal": 
    		{
    		"isRenewalLead": true,
    		"previousLeadId": "string"
    		}

The rest of the application process remains unchanged, visit our Introduction to Onboarding page to learn more.

Renewals Outreach Only

Partners can use a single API call to fetch To view the list of merchants that are currently eligible for a renewal.

Simply can send a GET call to this endpoint. And a list of merchants eligible for renewal is returned. This includes and identifying merchants that are eligible for an earlier renewal (i.e. they are eligible for a renewal before having fully paid off their existing financing.

👍

Best practice

You can use the maxDisplayableFundableAmountin marketing comms to show merchants how much they are eligible for when they apply for a renewal - this is similar to a prequalified offer.

Response example

{
    "metadata": {
        "totalResults": 1850,
        "currentOffset": 0,
        "nextOffset": 3
    },
    "results": [
        {
            "loanId": "string",
            "leadId": "string",
            "isEligibleForRenewal": true,
            "hasActiveLoan": false,
            "thirdPartyCustomerId": "org_52155",
            "maxDisplayableFundableAmount": 1992.0
        },
        {
            "loanId": "string",
            "leadId": "string",
            "isEligibleForRenewal": true,
            "hasActiveLoan": false,
            "thirdPartyCustomerId": "org_22345",
            "maxDisplayableFundableAmount": 1092.0
        },
        {
            "loanId": "string",
            "leadId": "string",
            "isEligibleForRenewal": true,
            "hasActiveLoan": true,
            "thirdPartyCustomerId": "org_12345",
            "maxDisplayableFundableAmount": 51720.0
        }
    ]
}