Belgium guide

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.

EnvironmentBase 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

EnvironmentURL
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

ParametersDescription
companyTypeBv Cv Nv Vof SoleTrader
companyNumberBelgian enterprise number (Ondernemingsnummer), 10 digits long (submit stage 1 will return an error if this param is not provided)
mobilePhoneNumberThe format for this parameter is: +32xxxxxxxxx
countryISOCodeBEL
loanCurrencyISOCodeEUR

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
}