Register a new Customer

post

https://eclipse-java-sandbox.ukheshe.rocks/eclipse-conductor/rest/v1/tenants/{tenantId}/customers

This will create a new customer profile under the tenant

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

tenantId

int64

required

Body Params

A customer of a Tenant. A physical human being with a legal identity. Customers can be grouped into an organisation if needed. Customers can belong to multiple organisations. Customers link to an organisation is through the posiiton they hold in that organisation.

accountableInstitutionCif

string

additionalIdentityNumber

string

length between 5 and 20

Additional identity number

asylumCountryOfIssuance

string

length between 2 and 2

ISO Alpha-2 country code for Issue of Asylum

asylumDateOfIssuance

string

length between 8 and 8

Mandatory If the asylum number is provided and must be in form of yyyyMMdd

asylumPaperExpiry

string

length between 8 and 8

Mandatory If the asylum ref number is provided and must be in form of yyyyMMdd

asylumRefNumber

string

length between 5 and 15

Asylum ref number

birthCity

string

length between 0 and 20

Customer City of birth

birthCountry

string

length between 0 and 60

Customer Country of birth. From 1st July 2022 it will only accept the ISO two character country code. for example if 'South Africa' has added as Passport place of issuance it will be replaced by 'ZA'.

communicationPreference

string

enum

Allowed:

countryOfResidence

string

Customer's resident country

dateOfBirth

string

length between 8 and 8

Customer Date of birth must be in form of yyyyMMdd

string

length between 10 and 50

Customers email address

externalUniqueId

string

required

length between 6 and 100

A globally unique identifier set by the tenant for this customer. Useful for correlating between the tenants systems and Eclipse

firstName

string

length between 2 and 50

Customer first/given name

gender

string

enum

The gender of the customer

Allowed:

industry

string

Industry customer belongs to

lastName

string

length between 2 and 50

Customers last/family name

locale

string

length between 2 and 2

ISO 639-1 language code of the customer

maidenName

string

length between 2 and 50

Customers maiden name

maritalStatus

string

enum

Maritial status of the customer

Allowed:

middleName

string

length between 2 and 50

Customers middle name

monthlyIncome

int64

Customer's expected income per month

nationalIdentityCountryOfIssuance

string

length between 2 and 2

ISO Alpha-2 country code for Issue of National Identity

nationalIdentityDateOfIssuance

string

length between 8 and 8

Mandatory If the national identity number is provided and must be in form of yyyyMMdd

nationalIdentityExpiry

string

length between 8 and 8

Mandatory If the national identity number is provided and must be in form of yyyyMMdd

nationalIdentityNumber

string

length between 5 and 20

National identity number

nationalIdentitySerialNumber

string

length between 0 and 20

national identity serial number of customer

nationality

string

length between 0 and 50

Nationality of Customer

nextMandatoryKycDate

date-time

nextOfKinInfo

string

length between 0 and 500

Next of kin info as a json

other

string

length between 0 and 5000

passportCountry

string

length between 2 and 2

ISO Alpha-2 country code

passportDateOfIssuance

string

length between 8 and 8

Mandatory If the passport number is provided and must be in form of yyyyMMdd

passportExpiry

string

length between 8 and 8

Mandatory If the passport number is provided and must be in form of yyyyMMdd

passportNumber

string

length between 5 and 20

National identity number

passportPlaceOfIssuance

string

length between 2 and 60

Mandatory If the passport number is provided.

permitExpiry

string

length between 8 and 8

Mandatory If the PERMIT is provided and must be in form of yyyyMMdd.

permitNumber

string

Permit number

phone1

string

Customers primary phone number

phone2

string

Customers secondary phone number

profession

string

Customer's profession

profileCompletionStatus

int32

Determines if the customer can update their own Profile, Adddress,Documents. This int is a bitmask. Least significant bit (bit 1) means the basic profile data like last name is complete and cannot be changed by the customer themselves. Bit 2 indicates Address data cannot be changed. Bit 3 means documents are complete. Bit 4 means attachments are complete. E.g. To disallow changing attachments, documents, and addresses only, this int would be set as 1110 = 14

purposeOfUse

string

Purpose of business Relationship

riskRating

string

schoolName

string

length between 0 and 50

School name of customer

sourceOfFunds

string

Customer's source of fund

status

string

enum

Status of the customer. This is set/updated by the tenant and acts as a flag. It has no associated logic or implications within Eclipse itself

Allowed:

taxNumber

string

length between 0 and 20

Tax number of customer

temporaryIdentityExpiry

string

length between 8 and 8

Mandatory If the temporary Id is provided and must be in form of yyyyMMdd. User should enter temporaryIdentityExpiry = issue date + 2 months

title

string

enum

The title/salutation of the customer

Allowed:

userTypeId

int32

Responses

400

Bad Request

200OK