Organization KYCFields
KYC fields for organizations (businesses).
Contains business entity identification information for corporate customers. All field keys are automatically prefixed with "organization." when serialized.
This class supports 17 total fields:
15 text fields
2 binary fields (document images)
Field categories:
Business identity: name, registration details, VAT number
Registered address: country, state, city, postal code
Contact information: email, phone, website
Corporate structure: directors, shareholders
Documents: incorporation papers, proof of address
Financial accounts: bank accounts (via nested fields)
Example - Basic organization:
val org = OrganizationKYCFields(
name = "Example Corp",
VATNumber = "123456789",
registrationNumber = "987654321",
registrationDate = "2020-01-01",
addressCountryCode = "USA",
directorName = "Jane Smith",
email = "contact@example.com"
)
// Extract fields for submission (automatically adds "organization." prefix)
val fields = org.fields()
// Result: {"organization.name": "Example Corp", "organization.VAT_number": "123456789", ...}Example - With documents:
val org = OrganizationKYCFields(
name = "Example Corp",
photoIncorporationDoc = loadImageBytes("articles_of_incorporation.pdf"),
photoProofAddress = loadImageBytes("utility_bill.jpg")
)
val files = org.files()
// Result: {"organization.photo_incorporation_doc": ByteArray(...), ...}Example - With nested financial account:
val org = OrganizationKYCFields(
name = "Example Corp",
financialAccountKYCFields = FinancialAccountKYCFields(
bankName = "Corporate Bank",
bankAccountNumber = "9876543210"
)
)
val fields = org.fields()
// Result: {
// "organization.name": "Example Corp",
// "organization.bank_name": "Corporate Bank",
// "organization.bank_account_number": "9876543210"
// }See also:
StandardKYCFields for the parent container
FinancialAccountKYCFields for bank account information
Constructors
Properties
Country code for address (ISO 3166-1 alpha-3)
Nested payment card information (not commonly used for organizations)
Organization registered managing director
Nested financial account information
Number of shareholders
Image of incorporation documents
Image of utility bill or bank statement with organization's name and address
Postal code identifying organization's locale
Organization registered address
Date the organization was registered (as string)
Organization registration number
Name of shareholder (can be recursively queried for ultimate beneficial owners)
Name of state/province/region/prefecture