Terminology

Comprehensive glossary of key terms and definitions used throughout the YouLend API ecosystem, covering business entities, cash advance terms, application processes, and technical concepts.

This page provides a comprehensive glossary of key terms and definitions used throughout the YouLend API ecosystem. Understanding these terms is essential for successful integration and operation within the YouLend platform.

📘

Cash Advances vs. Loans: YouLend provides cash advances based on revenue-based financing, not traditional loans. While the API documentation may use "loan" terminology for simplicity and familiarity, the actual financial product is a cash advance where repayment is tied to a percentage of daily card sales. This distinction is legally important in certain jurisdictions where traditional lending regulations may not apply to revenue-based financing products.

Core Business Entities

TermDefinitionContext
LeadA potential customer application for fundingPrimary entity in onboarding process
Lead IDUnique identifier (GUID) for a customer applicationUsed across all APIs for tracking
Third Party Customer IDPartner's unique identifier for a merchantExternal reference maintained by lending partners
MerchantBusiness entity seeking fundingCore customer type
BorrowerThe entity that receives and repays the cash advanceLegal entity responsible for repayment
Lending PartnerYouLend's business partner who refers customersChannel partner in the ecosystem
Significant PersonKey individuals associated with a business (Directors, Beneficial Owners)Required for KYC compliance

Cash Advance and Funding Terms

TermDefinitionContext
Cash AdvanceRevenue-based financing provided to merchantCore financial product (legally distinct from loans)
LoanAPI terminology for cash advance (for simplicity)Used in documentation but actual product is cash advance
AdvanceAlternative term for cash advancePreferred product terminology
Factor RateMultiplier applied to determine total repayment amountPricing mechanism (e.g., 1.1 means 10% fee)
Funded AmountActual amount disbursed to merchantWhat merchant receives
Original AmountTotal amount merchant must repayFunded Amount × Factor Rate
Current AmountOutstanding balance remainingDynamic value that decreases with payments
SweepPercentage of daily card transactions used for repaymentRepayment mechanism (e.g., 10% of daily sales)
Maturity DateFinal date by which advance must be fully repaidContract term
Auto Repayment SweepAutomated collection of agreed percentage from transactionsPayment automation feature
Revenue-Based FinancingFinancing model where repayment is tied to business revenueLegal structure of YouLend's cash advances
Sales-Based Repayment (SBR)Repayment through percentage of daily card salesPrimary repayment method for revenue-based financing

Application Process Terms

TermDefinitionContext
Pre-QualificationInitial eligibility assessmentScreening mechanism
Pre-ApprovalPreliminary approval based on payment dataQuick assessment tool
OnboardingComplete process of application, approval, and fundingEnd-to-end customer journey
Stage 1Initial application submission phaseFirst phase of onboarding
KYC (Know Your Customer)Identity verification and compliance documentationRegulatory requirement
Credit Risk CheckAssessment of merchant's creditworthinessUnderwriting process
UnderwritingProcess of evaluating merchant's eligibility and determining terms for cash advanceRisk assessment and approval decision
Fast TrackExpedited onboarding process for pre-approved merchantsAccelerated processing

Document Types

TermDefinitionContext
Bank StatementsFinancial records showing account activityRequired for underwriting
Proof of IdentityDocumentation verifying individual identityKYC requirement
Proof of AddressDocumentation confirming residential/business addressKYC requirement
Management AccountsInternal financial statementsBusiness financial documentation
Payment DataTransaction history from payment processorsCore underwriting data
Cash Advance AgreementLegal contract for the fundingSigned contract document
Direct Debit MandateAuthorization for automatic paymentsPayment setup document

Payment and Settlement Terms

TermDefinitionContext
Instant SettlementImmediate funding against future card receiptsAccelerated funding product
Settlement CycleTime period for transaction processing and paymentOperational timeline
MID (Merchant ID)Payment processor identifier for merchantTechnical identifier
Payment GatewayService that processes card transactionsTechnology platform
ChargebackDisputed transaction reversed by card issuerRisk factor in payments
RefundMoney returned to customerTransaction adjustment
Transaction DataDetailed payment processing informationCore data for decision making

Geographic and Regulatory

TermDefinitionContext
Country ISO CodeThree-letter country identifier (e.g., GBR, USA)Geographic classification
Currency ISO CodeThree-letter currency identifier (e.g., GBP, USD)Financial denomination
Company TypeLegal structure of business (Ltd, LLC, etc.)Regulatory classification
SIC CodeStandard Industrial Classification codeBusiness activity classification
MCC (Merchant Category Code)Payment industry business classificationRisk categorization
VAT NumberValue Added Tax registration identifierTax compliance identifier

Technical and Integration Terms

TermDefinitionContext
WebhookHTTP callback for real-time notificationsIntegration mechanism
Bearer TokenAuthorization token for API requestsAuthentication method
Embed TokenTemporary token for embedded componentsUI integration feature

Application Status Terms

TermDefinitionContext
Stage 1 IncompleteInitial application not yet submittedApplication status
Stage 1 SubmittedApplication submitted for reviewApplication status
Offers ProvidedCash advance offers generated and presentedApplication status
Offer AcceptedMerchant has accepted a cash advance offerApplication status
Contract SignedLegal agreements have been executedApplication status
Onboarding CompleteFull process finished, ready for fundingApplication status
Pending InformationAdditional details required from merchantApplication status

Note: This terminology reference is based on the YouLend API documentation and covers the essential concepts used across all platform APIs. While API documentation may use "loan" terminology for familiarity, all YouLend products are revenue-based cash advances. For specific implementation details, refer to the individual API documentation sections.