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 (formerly Numeral) attribute	Presence	Description
`birth_date`	optional	Individual birth date in `YYYY-MM-DD` format
`birth_city`	optional	Individual birth city
`birth_country`	optional	Individual birth country code
`other`	optional	Individual other type of identification
`other.identification`	mandatory	Individual identification as a string, e.g. passport ID, driving license ID
`other.identification_type`	conditional	One of: "alien_registration_number", "passport_number", "customer_identification_number", "drivers_license_number", "employee_identification_number", "national_identity_number", "social_security_number", "telephone_number", "tax_identification_number", "person_commercial_identification" `other.identification_type` and `other.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 (formerly Numeral) 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.