France 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 France

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
companyTypeSARL EINomPropre SNC SocieteCooperative SA SAS EURL
companyNumber9-digit SIREN number (submit stage 1 will return an error if this param is not provided)
mobilePhoneNumberThe format for this parameter is: +33xxxxxxxxx
countryISOCodeFRA
loanCurrencyISOCodeEUR
placeOfBirthThis param within the Update significant persons endpoint is mandatory for France. The format for this param is: {city}, {country}

Example: Paris, FRA

Example Create Lead Request

{
  "thirdPartyCustomerId": "16d81dac",
  "confirmedCreditSearch": true,
  "countryISOCode": "FRA",
  "loanCurrencyISOCode": "EUR",
  "keyContactName": "Sophie Allard",
  "companyType": "SARL",
  "companyName": "Test Company",
  "companyNumber": "274376432",
  "registeredAddress": {
    "line1": "5 Happy Road",
    "city": "Paris",
    "areaCode": "70123",
    "country": "France"
  },
  "contactPhoneNumber": "+3200000000",
  "contactEmailAddress": "[email protected]",
  "preferredLanguageCode": "fr",
  "confirmedCreditSearch": true
}

🚧

Be aware

In France, all merchants will be required to sign via the docusign flow in all scenarios, this is because Clicksign is not available in this country