chore: Sync account schemas

Author: Lightspark Eng

mintlify/openapi.yaml

@@ -0,0 +1,30 @@
+type: object
+required:
+- accountType
+- paymentRails
+- iban
+properties:
+  accountType:
+    type: string
+    enum:
+    - AED_ACCOUNT
+  paymentRails:
+    type: array
+    items:
+      type: string
+      enum:
+      - BANK_TRANSFER
+  iban:
+    type: string
+    description: The IBAN of the bank account
+    example: DE89370400440532013000
+    minLength: 15
+    maxLength: 34
+    pattern: ^[A-Z]{2}[0-9]{2}[A-Za-z0-9]{11,30}$
+  swiftCode:
+    type: string
+    description: The SWIFT/BIC code of the bank
+    example: DEUTDEFF
+    minLength: 8
+    maxLength: 11
+    pattern: ^[A-Z]{4}[A-Z]{2}[A-Z0-9]{2}([A-Z0-9]{3})?$

openapi.yaml

@@ -0,0 +1,33 @@
+title: Individual Beneficiary
+type: object
+required:
+- beneficiaryType
+- fullName
+properties:
+  beneficiaryType:
+    type: string
+    enum:
+    - INDIVIDUAL
+  fullName:
+    type: string
+    description: The full name of the beneficiary
+  birthDate:
+    type: string
+    description: The birth date of the beneficiary
+  nationality:
+    type: string
+    description: The nationality of the beneficiary
+  email:
+    type: string
+    description: The email of the beneficiary
+  phoneNumber:
+    type: string
+    description: The phone number of the beneficiary
+  registrationNumber:
+    type: string
+    description: The registration number of the beneficiary
+  countryOfResidence:
+    type: string
+    description: The country of residence of the beneficiary
+  address:
+    $ref: ./Address.yaml

openapi/components/schemas/common/AedAccountInfo.yaml

@@ -18,10 +18,21 @@ properties:
       - PIX
   pixKey:
     type: string
-    description: The PIX key of the bank
+    description: The PIX key (email, phone, CPF, CNPJ, or random)
+    minLength: 1
+    maxLength: 77
   pixKeyType:
     type: string
-    description: The type of PIX key of the bank
+    description: The type of PIX key
+    enum:
+    - email
+    - phone
+    - cpf
+    - cnpj
+    - random
   taxId:
     type: string
-    description: The tax ID of the bank account
+    description: The tax ID (CPF or CNPJ)
+    minLength: 11
+    maxLength: 14
+    pattern: ^[0-9]{11,14}$

openapi/components/schemas/common/AedBeneficiary.yaml

@@ -17,7 +17,15 @@ properties:
       - SEPA_INSTANT
   iban:
     type: string
-    description: The IBAN of the bank
-  swiftBic:
+    description: The IBAN of the bank account
+    example: DE89370400440532013000
+    minLength: 15
+    maxLength: 34
+    pattern: ^[A-Z]{2}[0-9]{2}[A-Za-z0-9]{11,30}$
+  swiftCode:
     type: string
-    description: The SWIFT BIC of the bank
+    description: The SWIFT/BIC code of the bank
+    example: DEUTDEFF
+    minLength: 8
+    maxLength: 11
+    pattern: ^[A-Z]{4}[A-Z]{2}[A-Z0-9]{2}([A-Z0-9]{3})?$

openapi/components/schemas/common/BrlAccountInfo.yaml

@@ -17,7 +17,15 @@ properties:
       - SEPA_INSTANT
   iban:
     type: string
-    description: The IBAN of the bank
-  swiftBic:
+    description: The IBAN of the bank account
+    example: DE89370400440532013000
+    minLength: 15
+    maxLength: 34
+    pattern: ^[A-Z]{2}[0-9]{2}[A-Za-z0-9]{11,30}$
+  swiftCode:
     type: string
-    description: The SWIFT BIC of the bank
+    description: The SWIFT/BIC code of the bank
+    example: DEUTDEFF
+    minLength: 8
+    maxLength: 11
+    pattern: ^[A-Z]{4}[A-Z]{2}[A-Z0-9]{2}([A-Z0-9]{3})?$

openapi/components/schemas/common/DkkAccountInfo.yaml

@@ -17,13 +17,15 @@ properties:
       - FASTER_PAYMENTS
   sortCode:
     type: string
-    description: UK bank sort code (6 digits, may include hyphens)
-    example: '20-00-00'
-    pattern: '^[0-9]{2}-?[0-9]{2}-?[0-9]{2}$'
+    description: The UK sort code
+    example: '123456'
+    minLength: 6
+    maxLength: 6
+    pattern: ^[0-9]{6}$
   accountNumber:
     type: string
     description: UK bank account number (8 digits)
-    example: '12345678'
     minLength: 8
     maxLength: 8
+    example: '12345678'
     pattern: ^[0-9]{8}$

openapi/components/schemas/common/EurAccountInfo.yaml

@@ -18,15 +18,18 @@ properties:
       - BANK_TRANSFER
   bankName:
     type: string
-    description: Name of the bank
-    example: HSBC Hong Kong
+    description: The name of the bank
+    minLength: 1
+    maxLength: 255
   accountNumber:
     type: string
     description: Hong Kong bank account number
+    minLength: 1
+    maxLength: 34
     example: '123456789012'
   swiftCode:
     type: string
-    description: SWIFT/BIC code (8 or 11 characters)
+    description: The SWIFT/BIC code of the bank
     example: HSBCHKHHHKH
     minLength: 8
     maxLength: 11

openapi/components/schemas/common/GbpAccountInfo.yaml

@@ -2,8 +2,8 @@ type: object
 required:
 - accountType
 - paymentRails
-- accountNumber
 - bankName
+- accountNumber
 - swiftCode
 - phoneNumber
 properties:
@@ -17,17 +17,21 @@ properties:
       type: string
       enum:
       - BANK_TRANSFER
+  bankName:
+    type: string
+    description: The name of the bank
+    minLength: 1
+    maxLength: 255
+    example: Bank Central Asia
   accountNumber:
     type: string
     description: Indonesian bank account number
+    minLength: 1
+    maxLength: 34
     example: '1234567890'
-  bankName:
-    type: string
-    description: Name of the bank
-    example: Bank Central Asia
   swiftCode:
     type: string
-    description: SWIFT/BIC code (8 or 11 characters)
+    description: The SWIFT/BIC code of the bank
     example: CENAIDJA
     minLength: 8
     maxLength: 11
@@ -36,4 +40,6 @@ properties:
     type: string
     description: Indonesian phone number for e-wallet payments
     example: '+6281234567890'
+    minLength: 7
+    maxLength: 15
     pattern: ^\+62[0-9]{9,12}$