Authentication and environments

Base URLs for the EU platform (when interacting with YouLends APIs)

When interacting with our EU specific endpoints, please use the below URLs.

Environment	Base URL
EU (production)	`https://youlendapi.com`
EU (staging)	`https://partners.staging-youlendapi.com`

Authentication URLs (to request an access token)

📘
Good to know
Please visit our Authentication guide for more information regarding authenticating in Belgium

Environment	URL
EU (production)	`https://youlend.eu.auth0.com/oauth/token`
EU (staging)	`https://youlend-stag.eu.auth0.com/oauth/token`

Onboarding APIs

This section focuses on all APIs that partners can interact with when onboarding a merchant.

Parameter callouts

Parameters	Description
`companyType`	`Bv` `Cv` `Nv` `Vof` `SoleTrader`
`companyNumber`	Belgian enterprise number (Ondernemingsnummer), 10 digits long (submit stage 1 will return an error if this param is not provided)
`mobilePhoneNumber`	The format for this parameter is: `+32xxxxxxxxx`
`countryISOCode`	`BEL`
`loanCurrencyISOCode`	`EUR`

Example request

{
  "thirdPartyCustomerId": "16d81dac",
  "confirmedCreditSearch": true,
  "countryISOCode": "BEL",
  "loanCurrencyISOCode": "EUR",
  "keyContactName": "Sophie Allard",
  "companyType": "Bv",
  "companyName": "Test Company",
  "companyNumber": "3876497658",
  "registeredAddress": {
    "line1": "5 Happy Road",
    "city": "Bruxelles",
    "areaCode": "1000",
    "country": "Belgium"
  },
  "contactPhoneNumber": "+3200000000",
  "contactEmailAddress": "[email protected]",
  "preferredLanguageCode": "nl",
  "confirmedCreditSearch": true
}