Submits an application for funding to Liberis.

🚧

Application

There are several fields on the application endpoint. Only a few of these are mandatory to create the application, however, there's a minimum set of fields required in order to create an application without Liberis needing to contact the customer for additional information. This is detailed in the table below and split by regional requirements (UK and US). You should endeavor to send as many these fields as possible in order to provide the most frictionless customer experience.

If you are creating an application for a region that is not US or UK, please speak to your partner manager for assistance.

1440

Minimum set of fields needed to create an application

{
    "reference": "CustomerMid",
    "applicationType": "BCA_Initial",
    "currency": "GBP",
    "applicants": [
        {
            "firstName": "John",
            "lastName": "Doe",
            "dateOfBirth": "2022-10-25T15:11:45Z",
            "primary":true
        }
    ]
}

Fields needed for a complete application, split by region

Required fieldRegion
referenceAll
applicationTypeAll
intendedUseOfFundsAll
bankAccountNumberUnited Kingdom and United States
bankRoutingNumberUnited States only
bankNameAll
sortCodeUnited Kingdom only
legalNameAll
tradingNameAll
legalConstitutionAll
registrationNumberUnited Kingdom only
registeredStreetAll
registeredCityAll
registeredStateUnited States only
registeredPostcodeAll (equivalent to Zip Code in United States)
registeredCountryAll
tradingStreetAll
tradingCityAll
tradingStateAll
tradingPostcodeAll (equivalent to Zip Code in United States)
tradingCountryAll
industryAll
selectedPrice (object)

(see below)
All
paymentChannels (object)All
applicants (object)
An applicant object is needed for the primary applicant and for each additional shareholder
All regions:
email
firstName
lastName
email
dateOfBirth
primary (need exactly one primary applicant)
ownershipPercentage
mailingStreet
mailingCity
mailingCountry
mailingPostcode
telephone

United Kingdom:
homeOwnership

United States:
mailingState
socialSecurityNumber
currencyAll
taxIdUnited States only
consentBureauSearchUnited Kingdom only
consentBureauSearchDateUnited Kingdom only

Price Details

Liberis provides up to 3 offers to the merchant. The selected price details need to be sent as part of the Application request

FieldData TypeDescription
split32-bit integerThe split percentage (i.e. the percentage of each transaction that will go towards paying for the advance.)
termdouble-precision numberThe number of months or part-months in which it is estimated that the advance will be paid
purchasePricedouble-precision numberThe advance amount
purchaseAmountdouble-precision numberThe total to be repaid
factorRatedouble-precision numberThe factor rate (multiple of the advance to derive the purchase amount)
Language
Credentials
OAuth2
Click Try It! to start a request and see the response here!