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:
Name | Description | Value/Example |
---|---|---|
Authorization | Access token with required scope | Bearer 8e36ce9d-6f51-479d-8ade-dff2952b4acb |
Accept | application/json;version=2 | |
Content-Type | application/json | |
x-connectpay-requestid | ID 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 Name | Is mandatory? | Description | Type | Constraint | Additional comment |
---|---|---|---|---|---|
person.Id | Yes | PersonId obtained from the Initiate IDV API. | String <UUID> | [1…36 characters] | |
person.isUbo | Yes | Confirmation that the client is the beneficial owner of the funds in the bank account | Boolean | True False | |
person.pep.isPep | Yes | Declaration regarding whether the person is PEP | Boolean | Yes No | |
person.pep.position | No | PEP position name is a client is a PEP | String | Min length 1 Max length 100 Not null Not digits Not characters: ~!@#$%^*()_+={}[]\|:;",<>/? | Conditional Mandatory when isPep is true |
person.address.countryCode | Yes | Address country of the client | String | Min length 2 Max length 2 Not null Not digits Not characters: ~!@#$%^*()_+={}[]\|:;",<>/? | Country Codes Alpha-2 |
person.address.addressLine1 | Yes | Freeform Address of a client, line 1 | String | Min length 3 Max length 100 Not null | |
person.address.addressLine2 | No | Freeform Address of a client, line 2 | String | Min length 3 Max length 100 | |
person.address.city | Yes | Address city of a client | String | Min length 3 Max length 100 Not null | |
person.address.postcode | Yes | Address postal code of a client | String | Min length 3 Max length 15 Not null | |
person.taxIdentification.taxCountry.countryCode | Yes | Country where customer is a taxpayer | String | Not null | |
person.taxIdentification.taxCountry.tin | Yes | Taxpayer identification number of a client | String | Not null | Conditional Mandatory Parameter, optional when residenceCountry.countryCode is LT |
person.taxIdentification.additionalCountries[countryCode] | No | Country where customer is a taxpayer (additional) | String | Not null | |
person.taxIdentification.additionalCountries[tin] | No | Taxpayer identification number of a client (additional) | String | Not null | |
account.connectionToLithuania | Yes | Defines connection to Lithuania | Array of strings | WorkOwnRealEstateHaveCompanyInLt StudyingInLt ResidencePermitSpouseIsLtCitizen TaxRefundsStateBenefits HaveCounterpartiesLocatedInLt EuroAccount | values changed to PascalCase |
account.purposesOfAccount.[] | Yes | Defines the purposes of the accountMultiselect | String | Salary 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.businessActivityRegistrationNo | No | Text | String | Conditional Mandatory when purposesOfAccount has IndividualOrSoleTraderIncome | |
account.purposesOfAccountAdditionalInformation.businessActivityIndustry | No | Text | String | Conditional Mandatory when purposesOfAccount has IndividualOrSoleTraderIncome | |
account.purposesOfAccountOther | No | Text | String | [ 1 .. 30 ] characters | When purposesOfAccount has Other |
account.sourceOfIncome | Yes | Select | String | EmploymentOrIndividualBusinessIncome | if value is not from the defined list, it should be added as Other values changed to PascalCase |
account.sourceOfIncomeOther | No | Text | String | [ 1 .. 30 ] characters | When sourceOfIncome has Other |
account.requestedProducts [] | No | List of defined CP products | String | RailsSwift | values changed to PascalCase |
account.monthlyGrossTurnover | Yes | Expected account turnover of a client | String | 0_1000 | values changed to PascalCase |
account.intendedCountriesToTransactWith | Yes | Country list from where and to where funds will be sent | Array of string | Min 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.occupation | Yes | Job or profession, referring to the work they do to receive funds for a living | string | Employee | if value is not from the defined list, it should be added as Other |
account.occupationAdditionalDetails.company | No | Customer’s workplace name | string | Min length 3 Max length 100 Not null | Conditional mandatory if Employee selected in account.occupation |
account.occupationAdditionalDetails.position | No | Customer’s position at their workplace | string | Min length 3 Max length 100 Not null | Conditional mandatory if Employee selected in account.occupation |
merchant.paymentMethod | No | How the payments are made:CardPIS | array of String | Card Pis | values changed to PascalCase |
merchant.targets.countries | No | Countries where the payments will come from | array of String | Min length 2 Max length 2 Not null Not digits Not characters: ~!@#$%^*()_+={}[]\|:;",<>/? | Country Codes Alpha-2 |
merchant.targets.monthlyGrossTurnover .amount & .currency | No | Planned monthly payment volume in Eur | String | Not null numeric entry Currently supported – EUR only |
- Fields that values were changed to PascalCase:
account.connectionToLithuania, account.purposesOfAccount, account.sourceOfIncome, account.requestedProducts, merchant.paymentMethod
- 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.
- Monthly gross turnover values slightly updated – adding more clarity on ranges.
- 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.
- New field introduced – Occupation. To understand job or profession, referring to the work customers do to receive funds.
- New field introduced – Company. Filled when Occupation is Employee. Customer’s workplace.
- 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"
}
}
}
}

Important! Application approval results in IBAN opening automatically. No additional actions to open an account are required. To receive an IBAN account number, use baasClientId
received in Get application status API after application approval in Get BaaS Client accounts API.