Skip to main content

PersonalClientDto

countryCodestringrequired

ISO 3166-1 alpha-2 country code

Example: AU
address objectrequired
streetstring

Business official street address. Allowed characters: letters, digits, spaces and , . - / # ( ) : '

Possible values: >= 4 characters and <= 256 characters, Value must match regular expression ^[A-Za-z0-9\s,.\-/#():']+$

Example: 19 Victoria Ave
citystring

City name of business official address. Allowed characters: letters, spaces and - . '

Possible values: <= 128 characters, Value must match regular expression ^[A-Za-z\s\-.']+$

Example: Sydney
statestring

State name of business official address. Allowed characters: letters, spaces and -

Possible values: <= 128 characters, Value must match regular expression ^[A-Za-z\s\-]+$

Example: New South Wales
zipstring

Zip code of business official address. Allowed characters: letters, digits, hyphens and spaces

Possible values: <= 32 characters, Value must match regular expression ^[A-Za-z0-9\- ]+$

Example: 2000
contactEmailstring

Personal contact email

Example: john@example.com
referenceIdstring<^[a-zA-Z0-9_][a-zA-Z0-9_-]{0,35}$>

The unique reference id of this entity creation. Optional, but highly recommended to use. When given, it fails the creation if a duplicate entity is found. Only alphanumeric characters, underscores and hyphens are allowed, and cannot start with a hyphen.

Possible values: <= 36 characters

Example: 1234567890
notestring

Note

Example: Manual onboard
transactionContinuationstring

Indicates whether the client’s expected transactions are one-off or ongoing/recurring (used for onboarding/KYC expected transaction profile).

Possible values: [ONEOFF, ONGOING]

Example: ONEOFF
expectedAnnualTransactionAmountnumber

Expected annual transaction amount (applicable when transactionContinuation is ONGOING).

Example: 100000
expectedAnnualTransactionCountnumber

Expected annual transaction count (applicable when transactionContinuation is ONGOING).

Example: 10
firstNamestringrequired

First name. Allowed characters: letters, spaces, apostrophes and hyphens

Possible values: <= 32 characters, Value must match regular expression ^[a-zA-Z '\-]+$

Example: John
lastNamestringrequired

Last name. Allowed characters: letters, spaces, apostrophes and hyphens

Possible values: Value must match regular expression ^[a-zA-Z '\-]+$

Example: Doe
phonestring<E.164>

Phone number

Example: +612...
nationalitystringrequired

Client nationality, ISO 3166-1 alpha-2 country code

Example: AU
dateOfBirthstringrequired

Date of birth

Example: 1990-01-01
occupationstringnullable

Client occupation. Allowed characters: letters, digits, spaces and / & - . , ' +

Possible values: <= 128 characters, Value must match regular expression ^[a-zA-Z0-9/&.,'\- +]+$

Example: Software Engineer
identificationTypePersonalClientIdentificationTypesnullable

Client identification type (required for PM role). Note: identificationType, identificationNumber and identificationIssueCountry must all be provided together to be saved

Possible values: [Drivers License, Social Security Number, Passport, Social Insurance Number, National Id]

Example: Passport
identificationNumberstringnullable

Client identification number (required for PM role). Note: identificationType, identificationNumber and identificationIssueCountry must all be provided together to be saved

Example: P12345678
identificationExpiryDatestringnullable

Client identification expiry date

Example: 2030-12-31
identificationIssueCountrystringnullable

Client identification issue country, ISO 3166-1 alpha-2 country code (required for PM role). Note: identificationType, identificationNumber and identificationIssueCountry must all be provided together to be saved

Possible values: <= 2 characters

Example: AU
idstringrequired

id of the client

Example: 401f4647-8372-495f-8de0-aafb3e1eaf93
clientNostringrequired

Human readable client unique No

Example: CAPAYAU-SYD-021233
uniquePayIdstringrequired

Unique CAPAY PAY ID which could be used for internal transfer

Example: 6244120284213583
isVerifiedbooleanrequireddeprecated

Whether the client is approved, this field will be deprecated soon, use status instead please

Example: true
statusClientStatusesrequired

Client status

Possible values: [PENDING APPROVAL, ACTIVE, INACTIVE, SUSPENDED]

Example: ACTIVE
createdTimestringrequired

The time when the client was created

Example: 2023-12-12T01:23:33Z
updatedTimestringrequired

The time when the client was last updated

Example: 2023-12-12T01:23:33Z
PersonalClientDto
{
"countryCode": "AU",
"address": {
"street": "19 Victoria Ave",
"city": "Sydney",
"state": "New South Wales",
"zip": "2000"
},
"contactEmail": "john@example.com",
"referenceId": "1234567890",
"note": "Manual onboard",
"transactionContinuation": "ONEOFF",
"expectedAnnualTransactionAmount": 100000,
"expectedAnnualTransactionCount": 10,
"firstName": "John",
"lastName": "Doe",
"phone": "+612...",
"nationality": "AU",
"dateOfBirth": "1990-01-01",
"occupation": "Software Engineer",
"identificationType": "Passport",
"identificationNumber": "P12345678",
"identificationExpiryDate": "2030-12-31",
"identificationIssueCountry": "AU",
"id": "401f4647-8372-495f-8de0-aafb3e1eaf93",
"clientNo": "CAPAYAU-SYD-021233",
"uniquePayId": "6244120284213583",
"status": "ACTIVE",
"createdTime": "2023-12-12T01:23:33Z",
"updatedTime": "2023-12-12T01:23:33Z"
}