Sign in

v1

latestOpenAPI 3.1.02026-07-24416405768.8 KB
b) Tenant Configuration & Onboarding

Register a new tenant

Only available to administrators.

post/eclipse-conductor/rest/v1/tenants

Request body

allowInitialTenantSetupboolean

If it is true then it will create admin users and tenant wallets based on either default config or config passed on tenantSetupTemplate.

businessType'CLOSE_CORPORATION' | 'LIMITED_COMPANY' | 'PARTNERSHIP' | 'PERSONAL_LIABILITY_COMPANY' | 'PUBLIC_LISTED_COMPANY' | 'SOLE_PROPRIETOR' | 'STATE_OWNED_COMPANY' | 'TRUST' | 'UNREGISTERED'
categoryCodeinteger

Four digit Category code for this tenant.

companyNumberstring

Legal company number of the tenant

emailstring

Primary email address of the tenant

{"stackTrail":"components:schemas:NewEclipseTenant:properties:exportedTenantConfigurations","oasType":"schema","type":"unknown","description":"Optional. It is tenant detail like wallet type, wallet, admin users exported Tenant Configuration as JSON"}
industrialClassificationstring
industrialSectorstring
institutionstring

Optional. The accountable institution that the tenant falls under

merchantIdstring

Merchant Id used for some card payment types to the tenants wallet

namestring

Name of the tenant - typically company name

phone1string required

Tenants primary phone number

taxNumberstring

Tax number of the tenant

tenantSetupPermissionTemplatestring
tenantSetupTemplatestring

Initial tenant setup config template. Used when allowInitialTenantSetup is true. if no value passed then use default template

tradingNamestring
vatNumberstring

VAT number of Tenant

Response

OK

base64ExportedTenantConfigurationstring

Optional. It is tenant detail like wallet type, wallet, admin users exported Tenant Configuration as JSON

businessType'CLOSE_CORPORATION' | 'LIMITED_COMPANY' | 'PARTNERSHIP' | 'PERSONAL_LIABILITY_COMPANY' | 'PUBLIC_LISTED_COMPANY' | 'SOLE_PROPRIETOR' | 'STATE_OWNED_COMPANY' | 'TRUST' | 'UNREGISTERED'
categoryCodeinteger

Four digit Category code for this tenant.

companyNumberstring

Legal company number of the tenant

createdstring date-time

ISO 8601 date/time of when the record was first created

emailstring

Primary email address of the tenant

industrialClassificationstring
industrialSectorstring
institutionstring

Optional. The accountable institution that the tenant falls under

lastModifiedstring date-time

ISO 8601 date/time of when the record was last modified

merchantIdstring

Merchant Id used for some card payment types to the tenants wallet

namestring

Name of the tenant - typically company name

phone1string required

Tenants primary phone number

primaryPoolAccountNumberstring
status'ACTIVE' | 'BARRED' | 'INACTIVE'

Status of the eclipse organisation. ACTIVE:Organisation is active, INACTIVE:Organisation is in active, BARRED:Organisation is in barred

taxNumberstring

Tax number of the tenant

tenantIdinteger

Unique identifier for a tenant. System generated upon creation of a new tenant. Should be passed as a path parameter for many of the API's which are specific to the tenant

tradingNamestring
vatNumberstring

VAT number of Tenant

versioninteger required

A number indicating the version of the record. Updates will only be accepted if the passed in version is the same as the current version on record. This is in order to prevent concurrent modifications by multiple users.

walletIdentifiersstring[]

Example response

{
  "created": "2022-03-10T12:15:50-04:00",
  "lastModified": "2022-03-10T12:15:50-04:00"
}