Provide masterdata for account holding party
Code samples
POST /v1/accountHoldingPartyData
Body parameter
{
"accountReplaced": true,
"accountReplacedNotes": "Chargeback rate exceeded",
"characteristics": {
"customerSince": "2020-05-16",
"depositDelay": "7d",
"discountFrequency": "WEEKLY",
"entryModeDistribution": [
{
"labels": [
"MAGNETIC_STRIPE"
],
"share": 0.75
}
],
"expectedIncomeDaily": 45000,
"expectedIncomeMonthly": 110000,
"expectedIncomeYearly": 150000,
"expectedTicketSizeAverage": 127.45,
"expectedTicketSizeMax": 20000,
"expectedTransactionCountDaily": 5000,
"expectedTransactionCountMonthly": 50000,
"expectedTransactionCountYearly": 500000,
"expectedVolumeDaily": 50000,
"expectedVolumeMonthly": 150000,
"expectedVolumeVolatility": "SEASONAL"
},
"companyDetails": {
"assessments": [
{
"date": "2020-01-24",
"name": "FICO",
"notes": "Manually reviewed",
"referenceId": "56461a6315",
"score": 756,
"status": "DONE"
}
],
"businessDescription": "Specialized on elderly women",
"businessPurposes": [
"5065",
"5085"
],
"companyId": "C0785283592",
"companyName": "The BORing company",
"countryOfRegistration": "PT",
"division": "Mortgage",
"inBusinessSince": "2019-03",
"legalForm": "2HBR",
"organizationType": "NON_PROFIT",
"shareholders": [
{
"companyDetails": {},
"contactDetails": {
"addressValidSince": "2017-04",
"allAssignedCustomerIds": [
"I-234982-324-1232",
"I-342512-121-4123"
],
"contactId": "K3408534094",
"contactName": "Adam Smith",
"contactNameExtended": "c/o Mrs Camber",
"country": "DE",
"emailAddresses": [
"noreply@company.com",
"john.smith@shoutlook.com"
],
"phoneNumbers": [
"+4915178859632",
"+4915178858526"
],
"region": "BY",
"regionExtended": "Maricopa",
"street": "Leopoldstr. 12",
"streetExtended": "apt. RE-243",
"town": "München",
"webLinks": [
"https://aml-ai.tech",
"https://linkedin.com"
],
"zip": 81737
},
"liability": "PERSONAL",
"personalDetails": {
"assessments": [
{
"date": "2020-01-24",
"name": "FICO",
"notes": "Manually reviewed",
"referenceId": "56461a6315",
"score": 756,
"status": "DONE"
}
],
"countryOfBirth": "FR",
"countryOfResidence": "DE",
"dateOfBirth": "1977-01-08",
"gender": "f",
"identityDocuments": [
{
"id": "F8624KW3J6",
"kind": "PASSPORT",
"link": "https://intranet.bank.com/customers/98234792/passport"
}
],
"nationality": "BE",
"personName": {
"firstName": "Barbara-Maria",
"lastName": "Kensigton",
"middleNames": "Helen Kate"
},
"placeOfBirth": "Paris",
"socialSecurityNumber": "078-05-112"
},
"role": "string",
"share": 0.51
}
],
"staff": [
{
"contactDetails": {
"addressValidSince": "2017-04",
"allAssignedCustomerIds": [
"I-234982-324-1232",
"I-342512-121-4123"
],
"contactId": "K3408534094",
"contactName": "Adam Smith",
"contactNameExtended": "c/o Mrs Camber",
"country": "DE",
"emailAddresses": [
"noreply@company.com",
"john.smith@shoutlook.com"
],
"phoneNumbers": [
"+4915178859632",
"+4915178858526"
],
"region": "BY",
"regionExtended": "Maricopa",
"street": "Leopoldstr. 12",
"streetExtended": "apt. RE-243",
"town": "München",
"webLinks": [
"https://aml-ai.tech",
"https://linkedin.com"
],
"zip": 81737
},
"personalDetails": {
"assessments": [
{
"date": "2020-01-24",
"name": "FICO",
"notes": "Manually reviewed",
"referenceId": "56461a6315",
"score": 756,
"status": "DONE"
}
],
"countryOfBirth": "FR",
"countryOfResidence": "DE",
"dateOfBirth": "1977-01-08",
"gender": "f",
"identityDocuments": [
{
"id": "F8624KW3J6",
"kind": "PASSPORT",
"link": "https://intranet.bank.com/customers/98234792/passport"
}
],
"nationality": "BE",
"personName": {
"firstName": "Barbara-Maria",
"lastName": "Kensigton",
"middleNames": "Helen Kate"
},
"placeOfBirth": "Paris",
"socialSecurityNumber": "078-05-112"
},
"role": "string"
}
]
},
"contactDetails": {
"addressValidSince": "2017-04",
"allAssignedCustomerIds": [
"I-234982-324-1232",
"I-342512-121-4123"
],
"contactId": "K3408534094",
"contactName": "Adam Smith",
"contactNameExtended": "c/o Mrs Camber",
"country": "DE",
"emailAddresses": [
"noreply@company.com",
"john.smith@shoutlook.com"
],
"phoneNumbers": [
"+4915178859632",
"+4915178858526"
],
"region": "BY",
"regionExtended": "Maricopa",
"street": "Leopoldstr. 12",
"streetExtended": "apt. RE-243",
"town": "München",
"webLinks": [
"https://aml-ai.tech",
"https://linkedin.com"
],
"zip": 81737
},
"customerGroupId": 32112388,
"customerId": 4681354,
"customerSince": "2014-01-15",
"customerStatus": "string",
"customerType": "CORPORATION",
"dba": [
{
"addressValidSince": "2017-04",
"allAssignedCustomerIds": [
"I-234982-324-1232",
"I-342512-121-4123"
],
"contactId": "K3408534094",
"contactName": "Adam Smith",
"contactNameExtended": "c/o Mrs Camber",
"country": "DE",
"emailAddresses": [
"noreply@company.com",
"john.smith@shoutlook.com"
],
"phoneNumbers": [
"+4915178859632",
"+4915178858526"
],
"region": "BY",
"regionExtended": "Maricopa",
"street": "Leopoldstr. 12",
"streetExtended": "apt. RE-243",
"town": "München",
"webLinks": [
"https://aml-ai.tech",
"https://linkedin.com"
],
"zip": 81737
}
],
"personalDetails": {
"assessments": [
{
"date": "2020-01-24",
"name": "FICO",
"notes": "Manually reviewed",
"referenceId": "56461a6315",
"score": 756,
"status": "DONE"
}
],
"countryOfBirth": "FR",
"countryOfResidence": "DE",
"dateOfBirth": "1977-01-08",
"gender": "f",
"identityDocuments": [
{
"id": "F8624KW3J6",
"kind": "PASSPORT",
"link": "https://intranet.bank.com/customers/98234792/passport"
}
],
"nationality": "BE",
"personName": {
"firstName": "Barbara-Maria",
"lastName": "Kensigton",
"middleNames": "Helen Kate"
},
"placeOfBirth": "Paris",
"socialSecurityNumber": "078-05-112"
},
"referenceAccount": {
"accountEmailId": "harles.hollinten@mail.com",
"accountId": 435863453,
"accountNumber": "DE12500105170648489890",
"bankCountry": "FR",
"bankIdentifier": "SSKMDEMM",
"expiry": 202911,
"holder": "John Smith",
"last4Digits": 435863453,
"productCode": "BPD",
"productType": "CREDIT_CARD",
"scheme": "SEPA"
},
"riskLevel": "low",
"signedProducts": [
"checking-account",
"visa-debit-card",
"mortgage"
],
"taxId": "079 / 123 / 12347"
}
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| body | body | AccountHoldingPartyData | true | accountHoldingPartyData |
Example responses
200 Response
Responses
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | Successfully received masterdata | TransactionResponse |
| 201 | Created | Created | None |
| 401 | Unauthorized | Unauthorized | None |
| 403 | Forbidden | Forbidden | None |
| 404 | Not Found | Not Found | None |