In addition to organization identifications, the private identification structure is used to identify an individual in the related parties of a payment. The use of organization identifications or private identification of a related party is mutually exclusive.
Definition
Objects supporting private identification are:
- Originating account in payment orders and incoming payments
- Receiving account in payment orders and incoming payments
- Ultimate originator in payment orders and incoming payments
The private identification attributes are described below:
| Mambu Payments attribute | Presence | Description |
|---|---|---|
birth_date | Optional | Birth date in YYYY-MM-DD format. |
birth_city | Optional | Birth city. |
birth_country | Optional | Birth country code. |
other | Optional | Other type of identification. |
other.identification | Mandatory | Identification as a string, e.g. passport ID, driving license ID. |
other.identification_type | Conditional | One of:
other.identification_typeandother.custom_identification_type\ are mutually exclusive. |
other.custom_identification_type | Conditional | Custom type as string. other.identification_type and other.custom_identification_type are mutually exclusive. |
other.identification_issuer | Optional | Issuer of this identification. |
{
"type": "sepa",
"direction": "credit",
"originating_account": {
"private_identification": {
"birth_date": "1990-06-18",
"birth_city": "Paris",
"birth_country": "FR",
"other": {
"identification": "351B6213271",
"identification_type": "national_identity_number",
"custom_identification_type": "",
"identification_issuer": ""
}
},
"account_number": "FR7601234567890627967100010",
"bank_code": "SOGEFRPP",
"holder_name": "SoftwareCo"
},
"receiving_account": {
"private_identification": {
"other": {
"identification": "34JB01853",
"identification_type": "passport_number",
"custom_identification_type": "",
"identification_issuer": ""
}
},
"account_number": "FR7601234567891127967100082",
"bank_code": "BNPAFRPPXXX",
"holder_name": "PartnerCo"
},
"auto_approval": false,
"amount": 2500,
"currency": "EUR",
"reference": "Invoice 1234",
"connected_account_id": "24e3157c-4942-11ed-b878-0242ac120002"
}Can be stored in other the following identification type:
| ISO code | Mambu Payments attribute | Description |
|---|---|---|
| ARNU | alien_registration_number | The unique identification number assigned to a person by a government authority to identify them as a foreign national or resident. |
| CCPT | passport_number | The unique identification number of a passport, an official travel document issued by a national government. |
| CUST | customer_identification_number | Any other customer identification number issued by a corporate, bank or other organization. |
| DRLC | drivers_license_number | The unique identification number of an official document issued by a government authority to a person allowing them to drive a motor vehicle. |
| EMPL | employee_identification_number | The unique identification number assigned to an employee by their employer. |
| NIDN | national_identity_number | A unique number assigned to a person by a government authority for official identification purposes. |
| SOSE | social_security_number | The unique identification number assigned to a person by a government authority for social security purposes. |
| TELE | telephone_number | Telephone number. |
| TXID | tax_identification_number | The unique identification number assigned to a person by a tax authority. |
| POID | person_commercial_identification | Commercial identification of the person. |
