spec release

Adyen · Nov 3, 2023 · 01c321d · 01c321d
1 parent 6091008
commit 01c321d
Show file tree

Hide file tree

Showing 6 changed files with 1,440 additions and 25 deletions.
diff --git a/json/LegalEntityService-v1.json b/json/LegalEntityService-v1.json
@@ -3717,6 +3717,10 @@
                   "readOnly" : true,
                   "type" : "array"
                },
+               "trust" : {
+                  "description" : "Information about the trust. Required if `type` is **trust**.",
+                  "$ref" : "#/components/schemas/Trust"
+               },
                "type" : {
                   "description" : "The type of legal entity.\n\n Possible values: **individual** or **organization**",
                   "enum" : [
@@ -3756,12 +3760,27 @@
                   "readOnly" : true,
                   "type" : "string"
                },
+               "settlorExemptionReason" : {
+                  "description" : "Defines the Kyc Exemption Reason for a Settlor associated with a trust.\n\nFor example, **professionalServiceProvider**, **deceased**, or **contributionBelowThreshold**.",
+                  "items" : {
+                     "type" : "string"
+                  },
+                  "readOnly" : true,
+                  "type" : "array"
+               },
                "type" : {
-                  "description" : "Defines the relationship of the legal entity to the current legal entity.\n\nPossible values for organizations: **uboThroughOwnership**, **uboThroughControl**, **director**, **signatory**, or **ultimateParentCompany**.\n\nPossible values for sole proprietorships: **soleProprietorship**.",
+                  "description" : "Defines the relationship of the legal entity to the current legal entity.\n\nPossible values for organizations: **uboThroughOwnership**, **uboThroughControl**, **director**, **signatory**, or **ultimateParentCompany**.\n\nPossible values for sole proprietorships: **soleProprietorship**.\n\nPossible value for trusts: **trust**\n\nPossible values for trust members: **definedBeneficiary**, **protector**, **secondaryTrustee**, **settlor**, **uboThroughControl**, or **uboThroughOwnership**.",
                   "enum" : [
+                     "definedBeneficiary",
+                     "director",
+                     "protector",
+                     "secondaryTrustee",
+                     "settlor",
                      "signatory",
+                     "trust",
                      "uboThroughControl",
-                     "uboThroughOwnership"
+                     "uboThroughOwnership",
+                     "undefinedBeneficiary"
                   ],
                   "type" : "string"
                }
@@ -3862,6 +3881,10 @@
                   "maxLength" : 150,
                   "type" : "string"
                },
+               "trust" : {
+                  "description" : "Information about the trust. Required if `type` is **trust**.",
+                  "$ref" : "#/components/schemas/Trust"
+               },
                "type" : {
                   "description" : "The type of legal entity.\n\n Possible values: **individual** or **organization**",
                   "enum" : [
@@ -3903,6 +3926,10 @@
                   "maxLength" : 150,
                   "type" : "string"
                },
+               "trust" : {
+                  "description" : "Information about the trust. Required if `type` is **trust**.",
+                  "$ref" : "#/components/schemas/Trust"
+               },
                "type" : {
                   "description" : "The type of legal entity.\n\n Possible values: **individual** or **organization**",
                   "enum" : [
@@ -4407,6 +4434,74 @@
             ],
             "type" : "object"
          },
+         "Trust" : {
+            "properties" : {
+               "countryOfGoverningLaw" : {
+                  "description" : "The two-character [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code of the governing country.",
+                  "type" : "string"
+               },
+               "doingBusinessAs" : {
+                  "description" : "The registered name, if different from the `name`.",
+                  "type" : "string"
+               },
+               "name" : {
+                  "description" : "The legal name.",
+                  "type" : "string"
+               },
+               "principalPlaceOfBusiness" : {
+                  "description" : "The business address. Required if the principal place of business is different from the `registeredAddress`.",
+                  "$ref" : "#/components/schemas/Address"
+               },
+               "registeredAddress" : {
+                  "description" : "The address registered at the registrar, such as the Chamber of Commerce.",
+                  "$ref" : "#/components/schemas/Address"
+               },
+               "registrationNumber" : {
+                  "description" : "The registration number.",
+                  "type" : "string"
+               },
+               "type" : {
+                  "description" : "Type of trust.\n\nPossible values for Australian trusts: **cashManagementTrust**, **corporateUnitTrust**, **deceasedEstate**, **discretionaryInvestmentTrust**, **discretionaryServicesManagementTrust**, **discretionaryTradingTrust**, **firstHomeSaverAccountsTrust**, **fixedTrust**, **fixedUnitTrust**, **hybridTrust**, **listedPublicUnitTrust**, **otherTrust**, **pooledSuperannuationTrust**, **publicTradingTrust**, **unlistedPublicUnitTrust**.",
+                  "enum" : [
+                     "cashManagementTrust",
+                     "corporateUnitTrust",
+                     "deceasedEstate",
+                     "discretionaryInvestmentTrust",
+                     "discretionaryServicesManagementTrust",
+                     "discretionaryTradingTrust",
+                     "firstHomeSaverAccountsTrust",
+                     "fixedTrust",
+                     "fixedUnitTrust",
+                     "hybridTrust",
+                     "listedPublicUnitTrust",
+                     "otherTrust",
+                     "pooledSuperannuationTrust",
+                     "publicTradingTrust",
+                     "unlistedPublicUnitTrust"
+                  ],
+                  "type" : "string"
+               },
+               "vatAbsenceReason" : {
+                  "description" : "The reason for not providing a VAT number.\n\nPossible values: **industryExemption**, **belowTaxThreshold**.",
+                  "enum" : [
+                     "industryExemption",
+                     "belowTaxThreshold"
+                  ],
+                  "type" : "string"
+               },
+               "vatNumber" : {
+                  "description" : "The VAT number.",
+                  "type" : "string"
+               }
+            },
+            "required" : [
+               "name",
+               "countryOfGoverningLaw",
+               "registeredAddress",
+               "type"
+            ],
+            "type" : "object"
+         },
          "VerificationError" : {
             "properties" : {
                "capabilities" : {