Create a lead.

post

https://partners.staging-youlendapi.com/onboarding/Leads

Create a new application (both for initial applications and renewals).

Body Params

A YL.Web.Api.ThirdParty.Onboarding.Models.ThirdPartyOnboardingModel containing the data required to create the lead.

thirdPartyCustomerId

string

required

length ≥ 1

Gets or sets the third party's unique id for a merchant.

companyName

string

required

length between 2 and 200

Gets or sets the merchant's company name.

countryISOCode

string

enum

required

length ≥ 1

Gets or sets the ISO country code for the merchant.

loanCurrencyISOCode

string

required

length ≥ 1

Gets or sets the ISO currency code for the merchant.

keyContactName

string

required

length between 1 and 255

Gets or sets the key merchant contact who will be applying for the loan.

companyType

string

enum

required

length ≥ 1

Gets or sets the key merchant company type.

registeredAddress

object

required

Address Data Model.

contactPhoneNumber

string

required

length between 8 and 20

Gets or sets the merchant's contact phone number.

contactEmailAddress

string

required

length between 1 and 255

Gets or sets the merchant's key contact email address.

confirmedCreditSearch

boolean

Gets or sets a value indicating whether the lead has given their consent for a credit search. This parameter has to be true in order for the lead to be able to submit the application (stage 1).

thirdPartyLeadId

string | null

Gets or sets the third party's id for the specific application (lead).

monthlyCardRevenue

double

Gets or sets the monthly card revenue for the merchant.

numberOfPaymentsPerMonth

int32

Gets or sets the number of payments a merchant has each month.

sweepPercentage

double

Gets or sets the percentage of daily sales the merchant wants to use to pay back the loan.

monthsTrading

int32

Gets or sets the number of months the merchant has been trading.

loanAmount

double

Gets or sets the size of loan the merchant wants.

companyWebsite

string | null

Gets or sets the merchants company website URL.

companyNumber

string | null

Gets or sets the registered company number for the merchant.

vatNumber

string | null

Gets or sets the VAT number for the merchant.

mid

string | null

Gets or sets the MID for the merchant.

merchantIds

array of strings | null

Gets or sets the MerchantIds for the merchant if there is more than one.

merchantIds

additionalInfo

object | null

Gets or sets a list of key values pairs representing any additional lead data not already covered.

signupClientIp

string | null

Gets or sets the Ip address of the merchant.

notificationURL

string | null

(DEPRECATED - please see https://docs.youlend.com/reference/webhooks-intro for how to subscribe to notifications).

employerIdentificationNumber

string | null

Gets or sets the merchant's tax identification number (required for USA).

renewal

object

Renewal data model.

tradingAddress

object

Address Data Model.

tradingName

string | null

Gets or sets the merchant's trading name.

preApprovalId

uuid

Gets or sets the PreApprovalId.

ownerUserId

uuid

Gets or sets the OwnerUserId.

preferredLanguageCode

string | null

enum

Gets or sets the PreferredLanguageCode.

preferredRepaymentMethod

string | null

enum

Gets or sets the preferred repayment method for the merchant. Accepted values: "Sales-Based Repayment", "Direct Debit Fixed".

Allowed:

secondaryLendingPartnerDetails

object

Secondary lending partner details model.

industries

array of objects | null

Gets or sets the Industries.

industries

Headers

api-version

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

200Returns a CreateThirdPartyAdvanceOnboardingResultModel.

400Bad Request

404Not Found