Business Details
  • 22 Dec 2023
  • 1 Minute to read
  • Dark
    Light

Business Details

  • Dark
    Light

Article summary

Business Details

This first screen in the onboarding journey is the Business Details screen, which is populated with the Create Merchant API request.

The Organisation Activities section details can be obtained by running a Get Business Classification endpoint and finding the relevant entry. You should use this data to choose an appropriate value suitable to the business to populate the Organization Category and Nature of Organization. The system will populate the other relevant fields (subtype description, business classification and MCC) based on these.

 

The minimum details required to populate this form, and their respective API calls, are listed in the following table.

 

Entity

Evolve Application form field

API Field name

merchant
(Merchant organisation details)

Merchant Type

type

 

Organisation category

organizationDetails/subtype

Business Legal name

organizationDetails/legalName

Business Trading name

organizationDetails/tradeName

Ownership Type

organizationDetails/ownershipType

Company Registration Number

organizationDetails/registrationAddress

Address line1

organizationDetails/registrationAddress/line1

Post Code

organizationDetails/registrationAddress/zipCode

City

organizationDetails/registrationAddress/city

 

Country (3 char ISO)

organizationDetails/registrationAddress/countryCode

Phone

organizationDetails/phone

 

Trading Website

organizationDetails/tradingWebsite

 

Entity

Minimal data

Field name

merchant

(Merchant organisation details)

Organisational Type

type

merchant

(Merchant organisation details)

Organisational Type

type

 

Organisation category

organizationDetails/subtype

Business Legal name

organizationDetails/legalName

Business Trading name

organizationDetails/tradeName

Company Registration Number

organizationDetails/registrationAddress

Address line1

organizationDetails/registrationAddress/line1

Post Code

organizationDetails/registrationAddress/zipCode

City

organizationDetails/registrationAddress/city

 

Country (3 char ISO)

organizationDetails/registrationAddress/countryCode

Phone

organizationDetails/phone

 

Trading Website

organizationDetails/tradingWebsite

 

Business Classification Code

businessClassificationCode  

 

ISV ID

isvId

 

External ID

ExternalId

The following is an example Create Merchant API call.

{
    "isvId": "{{isvId}}",
    "type": "GENERIC",
    "subtype": "PROFESSIONAL_SERVICES",
    "businessClassificationCode": "8911-003",
    "organizationDetails": {
        "legalName": "Bernards Bulk Bananas",
        "tradeName": "Richies",
        "ownershipType": "LIMITED_COMPANY",
        "companyNo": "34534534534",
        "registrationAddress": {
            "line1": "101 Banana Street",
            "zipCode": "B26 3QJ",
            "city": "Somerville",
            "countryCode": "GBR"
        },	
        "tradingWebsite": "www.onboardingmerchant.co.uk",
        "phone": "004434585487"
    },
    "externalId": "XYZ12345673612342"
}


Selecting Business Classification

The Organisation Activities section details can be obtained by running a Get Business Classification endpoint.

This will return a list of business classifications. That includes the code as well as the descriptive name that is displayed to the user. You should use this data to choose the value corresponding to the business to populate the Organization Category and Nature of Organization. The system will populate the other relevant fields (subtype description, business classification, mcc) based on these. Below is an example from the list.

    {
        "merchantSubtype": "HEALTHCARE_PRIVATE_SECTOR",
        "businessClassification": "Vet / Animal Medical Practitioner",
        "businessClassificationCode": "0742-001",
        "mcc": "0742",
        "status": "ACTIVE",
        "uploadedAt": "2020-11-24T10:21:49.284Z",
        "uploadedBy": "bo"
    }
	


Was this article helpful?