Open an account for a private client – version 2

In order to have better auto-approval conversion rate, we would like to introduce personal application version 2 changes. The overall process is kept the same, there are several changes in fields that are collected, also some formatting changes introduced to maintain API consistency. API should be available to test in stage from April, 2025.

Header changes:

NameDescriptionValue/Example
AuthorizationAccess token with required scopeBearer 8e36ce9d-6f51-479d-8ade-dff2952b4acb
X-Request-IDID of the request, unique to the call.598397fc-c27f-4830-a8c0-f3bcc0f2a800
Accept application/json;version=2
Content-Type application/json
x-connectpay-requestidID of the request, unique to the call.4d662590-731f-42f9-926f-aae0cec66a06

Instead of X-Request-ID we introduce x-connectpay-requestid for tracing requests for both request and response headers.

Request body changes:

Parameter NameIs mandatory?DescriptionTypeConstraintAdditional comment
person.IdYesPersonId obtained from the Initiate IDV API.String <UUID>[1…36 characters] 
person.isUboYesConfirmation that the client is the beneficial owner of the funds in the bank accountBooleanTrue
False
 
person.pep.isPepYesDeclaration regarding whether the person is PEPBooleanYes
No
 
person.pep.positionNoPEP position name is a client is a PEPStringMin length 1
Max length 100
Not null
Not digits
Not characters:~!@#$%^*()_+={}[]\|:;",<>/?
Conditional Mandatory when isPep is true
person.address.countryCodeYesAddress country of the clientStringMin length 2
Max length 2
Not null
Not digits
Not characters:~!@#$%^*()_+={}[]\|:;",<>/?
Country Codes Alpha-2
person.address.addressLine1YesFreeform Address of a client, line 1StringMin length 3
Max length 100
Not null
 
person.address.addressLine2NoFreeform Address of a client, line 2StringMin length 3
Max length 100
 
person.address.cityYesAddress city of a clientStringMin length 3
Max length 100
Not null
 
person.address.postcodeYesAddress postal code of a clientStringMin length 3
Max length 15
Not null
 
person.taxIdentification.taxCountry.countryCodeYesCountry where customer is a taxpayerStringNot null 
person.taxIdentification.taxCountry.tinYesTaxpayer identification number of a clientStringNot nullConditional Mandatory Parameter, optional when residenceCountry.countryCode is LT
person.taxIdentification.additionalCountries[countryCode]NoCountry where customer is a taxpayer (additional)StringNot null 
person.taxIdentification.additionalCountries[tin]NoTaxpayer identification number of a client (additional)StringNot null 
account.connectionToLithuaniaYesDefines connection to LithuaniaArray of stringsWorkOwnRealEstateHaveCompanyInLt
StudyingInLt
ResidencePermitSpouseIsLtCitizen
TaxRefundsStateBenefits
HaveCounterpartiesLocatedInLt
EuroAccount
values changed to PascalCase
account.purposesOfAccount.[]YesDefines the purposes of the accountMultiselectStringSalary
IndividualOrSoleTraderIncome
PersonalOrHouseholdExpenses
ForeignTransactions
VirtualCurrencyOrGamblingRelatedTransactions
InvestmentTransactionsOrLoanPayments
Other
if value is not from the defined list, it should be added as Other
values changed to PascalCase
account.purposesOfAccountAdditionalInformation.businessActivityRegistrationNoNoTextString Conditional Mandatory when purposesOfAccount has IndividualOrSoleTraderIncome
account.purposesOfAccountAdditionalInformation.businessActivityIndustryNoTextString Conditional Mandatory when purposesOfAccount has IndividualOrSoleTraderIncome
account.purposesOfAccountOtherNoTextString[ 1 .. 30 ] charactersWhen purposesOfAccount has Other
account.sourceOfIncomeYesSelectStringEmploymentOrIndividualBusinessIncome
Pension
Savings
Alimony
SocialBenefits
Scholarship
Other
if value is not from the defined list, it should be added as Other
values changed to PascalCase
account.sourceOfIncomeOtherNoTextString[ 1 .. 30 ] charactersWhen sourceOfIncome has Other
account.requestedProducts[]NoList of defined CP productsStringRailsSwiftvalues changed to PascalCase
account.monthlyGrossTurnoverYesExpected account turnover of a client String 0_1000
1001_3000
3001_15000
15001_50000
50001_OrMore
values changed to PascalCase
account.intendedCountriesToTransactWithYesCountry list from where and to where funds will be sentArray of stringMin length 2
Max length 2
Not null
Not digits
Not characters:~!@#$%^*()_+={}[]\|:;",<>/?
Enum: "LT" "AF" "AL" "DZ" "AS" "AD" "AO" "AI" "AQ" "AG" "AR" "AM" "AW" "AU" "AT" "AZ" "BS" "BH" "BD" "BB" "BY" "BE" "BZ" "BJ" "BM" "BT" "BO" "BA" "BW" "BV" "BR" "IO" "BN" "BG" "BF" "BI" "KH" "CM" "CA" "CV" "KY" "CF" "TD" "CL" "CN" "CX" "CC" "CO" "KM" "CK" "CR" "CI" "HR" "CU" "CY" "CZ" "DK" "DJ" "DM" "DO" "TL" "EC" "EG" "SV" "GQ" "ER" "EE" "ET" "FK" "FO" "FJ" "FI" "FR" "GF" "PF" "TF" "GA" "GM" "GE" "DE" "GH" "GI" "GR" "GL" "GD" "GP" "GU" "GT" "GN" "GW" "GY" "HT" "HM" "HN" "HK" "HU" "IS" "IN" "ID" "IR" "IQ" "IE" "IL" "IT" "JM" "JP" "JO" "KZ" "KE" "KI" "KW" "KG" "LA" "LV" "LB" "LS" "LR" "LY" "LI" "LU" "MO" "MG" "MW" "MY" "MV" "ML" "MT" "MH" "MQ" "MR" "MU" "YT" "MX" "MC" "MN" "MS" "MA" "MZ" "MM" "NA" "NR" "NP" "NL" "AN" "NC" "NZ" "NI" "NE" "NG" "NU" "NF" "MP" "NO" "OM" "PK" "PW" "PA" "PG" "PY" "PE" "PH" "PN" "PL" "PT" "PR" "QA" "RE" "RO" "RU" "RW" "KN" "LC" "VC" "WS" "SM" "ST" "SA" "SN" "SC" "SL" "SG" "SK" "SI" "SB" "SO" "ZA" "GS" "ES" "LK" "SH" "PM" "SD" "SR" "SJ" "SZ" "SE" "CH" "SY" "TW" "TJ" "TH" "TG" "TK" "TO" "TT" "TN" "TR" "TM" "TC" "TV" "UG" "UA" "AE" "GB" "US" "UM" "UY" "UZ" "VU" "VA" "VE" "VN" "VG" "VI" "WF" "EH" "YE" "YU" "ZM" "ZW" "AX" "BQ" "CG" "CD" "CW" "GG" "IM" "KP" "KR" "MK" "FM" "MD" "ME" "PS" "BL" "MF" "RS" "SX" "SS" "TZ" "KS" "JE" "FX"
account.occupationYesJob or profession, referring to the work they do to receive funds for a livingstringEmployee
IndividualActivity
Retired
Student
Unemployed
Other
if value is not from the defined list, it should be added as Other
account.occupationAdditionalDetails.companyNoCustomer’s workplace namestringMin length 3
Max length 100
Not null
Conditional mandatory if Employee selected in account.occupation
account.occupationAdditionalDetails.positionNoCustomer’s position at their workplacestringMin length 3
Max length 100
Not null
Conditional mandatory if Employee selected in account.occupation
merchant.paymentMethodNoHow the payments are made:CardPISarray of StringCard
Pis
values changed to PascalCase
merchant.targets.countriesNoCountries where the payments will come fromarray of StringMin length 2
Max length 2
Not null
Not digits
Not characters:~!@#$%^*()_+={}[]\|:;",<>/?
Country Codes Alpha-2
merchant.targets.monthlyGrossTurnover.amount & .currencyNoPlanned monthly payment volume in EurStringNot null
numeric entry
Currently supported – EUR only
 
  1. Fields that values were changed to PascalCase: account.connectionToLithuania, account.purposesOfAccount, account.sourceOfIncome, account.requestedProducts, merchant.paymentMethod
  2. Source of Income selection is updated. New values introduced: Pension, Savings, Alimony, Social Benefits, Scholarship. Old values removed: Business profit or dividends, sale of investments or liquidation of portfolio, property sale, loan and financing, inheritance, gift.
  3. Monthly gross turnover values slightly updated – adding more clarity on ranges.
  4. New field introduced – Intended countries to transact with where a customer should provide a list of countries where and from where funds will be moving.
  5. New field introduced – Occupation. To understand job or profession, referring to the work customers do to receive funds.
  6. New field introduced – Company. Filled when Occupation is Employee. Customer’s workplace.
  7. New field introduced – Position. Filled when Occupation is Employee. Customer’s position at their workplace.

Full request sample can be seen below:

{
  "person": {
    "personId": "6e0ab99b-f0f7-4ca9-b6d9-35670f5e4bf5",
    "isUbo": true,
    "pep": {
      "isPep": true,
      "position": "string"
    },
    "address": {
      "addressLine1": "string",
      "addressLine2": "string",
      "postcode": "string",
      "city": "string",
      "countryCode": "LT"
    },
    "taxIdentification": {
      "taxCountry": {
        "countryCode": "LT",
        "tin": 123123
      },
      "additionalTaxCountries": [
        {
          "countryCode": "LT",
          "tin": 1231232
        }
      ]
    }
  },
  "account": {
    "connectionToLithuania": [
      "WorkOwnRealEstateHaveCompanyInLt"
    ],
    "requestedProducts": [
      "RailsSwift"
    ],
    "purposesOfAccount": [
      "Salary"
    ],
    "purposesOfAccountAdditionalInformation": {
      "businessActivityRegistrationNo": 123123,
      "businessActivityIndustry": "Test Industry"
    },
    "purposesOfAccountOther": "string",
    "sourceOfIncome": "Other",
    "sourceOfIncomeOther": "Alternate source of income",
    "monthlyGrossTurnover": 1001_3000,
    "intendedCountriesToTransactWith": "LT",
    "occupation": "Employee",
    "occupationAdditionalDetails":{
      "company": "UAB Test123",
      "position": "Midle management"
    }
  },
  "merchant": {
    "paymentMethod": [
      "Card"
    ],
    "targets": {
      "countries": [
        "LT"
      ],
      "monthlyGrossTurnover": {
        "amount": 0,
        "currency": "str"
      }
    }
  }
}
Application states

Identity verification with ConnectPay provider

Identity verification using your provider’s data

Accounts using BaaS

Notifications

Scroll to Top