Identification-RemoteSelfEmployed-v2

From Barion Documentation
Revision as of 10:25, 4 July 2017 by Vinczei (talk | contribs) (Created page with "{{PageTitle|title=Barion API: remote KYC identification process for self-employed persons}} {{TableOfContents}} {{api_callmethod |method=POST |uri=/v2/Identification/RemoteS...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

Barion API: remote KYC identification process for self-employed persons

POST /v2/Identification/RemoteSelfEmployed

The /identification/remoteselfemployed API endpoint is used to complete a remote identification process for a person self-employed under their company (organization) business previously registered in the Barion system.

Prerequisites before use:

v2 This API endpoint is available in API v2 only.

partners This API endpoint is available for trusted Barion partners only.

Input properties

Property name Property type Limitations and constraints Description
PartnerKey Guid
  • Required
The secret API key of the trusted partner, generated by Barion.
ClientEmail string
  • Required
The e-mail address of the client that is being identified
ClientPassword string
  • Required
The Barion password of the client that is being identified
IdentifierAgent IdentifierAgent
  • Required
Information about the agent who is initiating the identification process
OrganizationData OrganizationData
  • Required
The details about the organization.
Owner RemoteRepresentative
  • Required
Details about the owner of the company

Output properties

Property name Property type Description
IsSuccessful bool Indicates wether the identification process was successfully completed or not

Example

Request

{
  "PartnerKey": "9e9e72fe-96be-4dd3-8957-03e9e1d3f591",
  "ClientEmail": "[email protected]",
  "ClientPassword": "57R0ngP4S5w0RĐ",
  "IdentifierAgent": {
    "FirstName": "Adam",
    "LastName": "Agent",
    "UserName": "adam2017"
  },
  "OrganizationData": {
    "OrganizationName": "TesztTesztTeszt Korlátolt Felelelősségű Társaság",
    "OrganizationShortName": "Teszt Kft.",
    "HeadQuarters_Country": "HUN",
    "HeadQuarters_City": "Budapest",
    "HeadQuarters_Street": "Teszt utca",
    "HeadQuarters_HouseNumber": "1",
    "HeadQuarters_Zip": "1234",
    "PostalAddress_Country": "HUN",
    "PostalAddress_City": "Szeged",
    "PostalAddress_Street": "Dugonics tér",
    "PostalAddress_HouseNumber": "2.",
    "PostalAddress_Zip": "6700"
  },
  "Owner": {
    "FirstName": "Tibor",
    "LastName": "Teszt",
    "BirthFirstName": "Tibor",
    "BirthLastName": "Teszt",
    "MothersFirstName": "Mária",
    "MothersLastName": "Teszt",
    "BirthDate": "1964-02-22T00:00:00",
    "BirthPlace": "Budapest, HU",
    "Nationality": "HUN",
    "Address_Country": "HUN",
    "Address_City": "Budapest",
    "Address_Street": "Test street",
    "Address_HouseNumber": "1",
    "Address_Zip": "12345",
    "Documents": [
      {
        "DocumentType": 1,
        "DocumentNumber": "IDCARD001",
        "DocumentValidUntil": "2025-05-05T00:00:00",
        "DocumentImages": [
          {
            "Data": "\/9j\/4RIuRXhpZgAATU0AKgAAAAgABwESAAMAAAABAAEAAAEaAAUAAAABAAAAYgEbAAU...", /* example truncated */
            "MimeType": "image\/jpeg"
          }
        ]
      }
    ]
  }
}

Response

{
    "IsSuccessful": true,
    "Errors": []
}