Identification-Information-v2: Difference between revisions

From Barion Documentation
Jump to navigation Jump to search
(Created page with "{{PageTitle|title=Barion API: Fetch information about an organization}} {{TableOfContents}} {{api_callmethod |method=GET |uri=/v2/Identification/Information }} The <code>/i...")
 
 
(15 intermediate revisions by the same user not shown)
Line 12: Line 12:
Prerequisites before use:
Prerequisites before use:
* [[Creating_an_account|Creating an account in Barion]]
* [[Creating_an_account|Creating an account in Barion]]
* [[Creating_a_shop|Creating a shop in Barion]]
* [[Calling_the_API|Calling the Barion API]]
* [[Calling_the_API|Calling the Barion API]]




<span class="api-ver">v2</span> This API endpoint is available in '''API v2''' only.
<span class="api-ver">v2</span> This API endpoint is available in '''API v2''' only.
<span class="api-ver">partners</span> This API endpoint is available for '''trusted Barion partners''' only.
<span class="api-ver">partners</span> This API endpoint is available for '''trusted Barion partners''' only.


Line 26: Line 26:
* Required
* Required
|| The secret API key of the trusted partner, generated by Barion.
|| The secret API key of the trusted partner, generated by Barion.
|-
|-
| Email || string ||  
| Email || string ||  
* Required
* Required
|| The e-mail address of an existing organization in Barion
|| The e-mail address of the organization in Barion
|-
| Password || string ||
* Required
|| The password of the organization in Barion
|}
|}


Line 39: Line 41:
|-
|-
| CompanyRegisterInfo || [[CompanyRegisterInfo]] || A bundle object containing the detailed information about the organization
| CompanyRegisterInfo || [[CompanyRegisterInfo]] || A bundle object containing the detailed information about the organization
|}


== Possible error responses ==
{| class="wikitable api-table"
! Error code || Description
|-
| NoIdentifiedPartnerFound || The given partner key was not valid
|-
| PartnerDataCannotBeRetrieved || The trusted partner data could not be retrieved (possibly has no rights for this endpoint)
|-
| AuthenticationFailed || Authentication failed for the target organization (incorrect login name or password)
|-
| RemoteRegisterInfoReturnedWithError || The company register service returned an error
|-
| RegisterInfoCannotBeRetrievedFromDb || The company register record could not be retrieved from the Barion database. Please contact the Barion support.
|-
| RegisterInfoCannotBeRetrievedFromRemote || The company register record could not be retrieved from the remote service. Possible causes:
* The given company is not based in Hungary (there is no service to call)
* The company register remote service is down
|-
| CompanyRegisterDoesNotExistsForCountry || No company register service exists for the organization's country
|}
|}
== Example ==
'''Request'''
<syntaxhighlight lang="html">https://api.barion.com/v2/identification/information?PartnerKey=630ee026-3e19-469f-8325-afc9bd1ae6a6&[email protected]&Password=5tr0Ng_Pa55w0rD</syntaxhighlight>
'''Response'''
<syntaxhighlight lang="json">
{
    "CompanyRegisterInfo": {
        "RegistrationNumber": "12345678-1234",
        "OrganizationName": "Barion Payment Zrt.",
        "OrganizationShortName": "Barion Payment Zrt.",
        "HeadQuarter": {
            "Address": "1117 Budapest, Infopark sétány 1. I épület",
            "Country": "Magyarország",
            "CountryCode": "HU",
            "Zip": "1117",
            "City": "Budapest",
            "Street": "Infopark sétány",
            "Housenumber": "1. I épület 5. emelet"
        },
        "PostalAddress": {
            "Address": "1117 Budapest, Infopark sétány 1. I épület",
            "Country": "Magyarország",
            "CountryCode": "HU",
            "Zip": "1117",
            "City": "Budapest",
            "Street": "Infopark sétány",
            "Housenumber": "1. I épület 5. emelet"
        },
        "MainActivity": "Egyéb szoftverkiadás",
        "MainActivityCodde": "5829",
        "TaxNumber": "00112233",
        "Branch": "00112233",
        "Ownership": "Zártkörűen működő részvénytársaság",
        "RegisteredAt": "2015-09-01T00:00:00",
        "DeletedAt": "0001-01-01T00:00:00",
        "DeletionMode": null,
        "Note": null,
        "Representatives": [
            {
                "RepresentationMode": "Meghatalmazott",
                "CanSign": true,
                "Office": "végelszámoló",
                "Email": "[email protected]",
                "Person": {
                    "FullName": "Teszt Tibor",
                    "LastName": "Teszt",
                    "FirstName": "Tibor",
                    "BirthDate": "1978-05-23T00:00:00.000",
                    "MothersName": "Teszt Teréz",
                    "MothersLastName": "Teszt",
                    "MothersFirstName": "Teréz",
                    "TaxNumber": "9955884466",
                    "Address": {
                        "Address": "1134 Budapest, Szilágyi utca 2.",
                        "Country": "Magyarország",
                        "CountryCode": "HU",
                        "Zip": "1134",
                        "City": "Budapest",
                        "Street": "Szilágyi utca",
                        "Housenumber": "2."
                    },
                    "AddressString": "1134 Budapest, Szilágyi utca 2."
                }
            }
        ],
        "Members": [
            {
                "Person": {
                    "FullName": "Példa Péter",
                    "LastName": "Példa",
                    "FirstName": "Péter",
                    "BirthDate": "1980-12-03T00:00:00.000",
                    "MothersName": "Péda Panna",
                    "MothersLastName": "Példa",
                    "MothersFirstName": "Panna",
                    "TaxNumber": "001122889977",
                    "Address": {
                        "Address": "1152 Budapest, Kossuth utca 35.",
                        "Country": "Magyarország",
                        "CountryCode": "HU",
                        "Zip": "1152",
                        "City": "Budapest",
                        "Street": "Kossuth utca",
                        "Housenumber": "35."
                    },
                    "AddressString": "1152 Budapest, Kossuth utca 35."
                }
            }
        ]
    }
}
</syntaxhighlight>

Latest revision as of 07:41, 9 August 2017

Barion API: Fetch information about an organization

GET /v2/Identification/Information

The /identification/information API endpoint is used to fetch information about an organization for the remote identification process.

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.
Email string
  • Required
The e-mail address of the organization in Barion
Password string
  • Required
The password of the organization in Barion

Output properties

Property name Property type Description
CompanyRegisterInfo CompanyRegisterInfo A bundle object containing the detailed information about the organization

Possible error responses

Error code Description
NoIdentifiedPartnerFound The given partner key was not valid
PartnerDataCannotBeRetrieved The trusted partner data could not be retrieved (possibly has no rights for this endpoint)
AuthenticationFailed Authentication failed for the target organization (incorrect login name or password)
RemoteRegisterInfoReturnedWithError The company register service returned an error
RegisterInfoCannotBeRetrievedFromDb The company register record could not be retrieved from the Barion database. Please contact the Barion support.
RegisterInfoCannotBeRetrievedFromRemote The company register record could not be retrieved from the remote service. Possible causes:
  • The given company is not based in Hungary (there is no service to call)
  • The company register remote service is down
CompanyRegisterDoesNotExistsForCountry No company register service exists for the organization's country

Example

Request

https://api.barion.com/v2/identification/information?PartnerKey=630ee026-3e19-469f-8325-afc9bd1ae6a6&[email protected]&Password=5tr0Ng_Pa55w0rD

Response

{
    "CompanyRegisterInfo": {
        "RegistrationNumber": "12345678-1234",
        "OrganizationName": "Barion Payment Zrt.",
        "OrganizationShortName": "Barion Payment Zrt.",
        "HeadQuarter": {
            "Address": "1117 Budapest, Infopark sétány 1. I épület",
            "Country": "Magyarország",
            "CountryCode": "HU",
            "Zip": "1117",
            "City": "Budapest",
            "Street": "Infopark sétány",
            "Housenumber": "1. I épület 5. emelet"
        },
        "PostalAddress": {
            "Address": "1117 Budapest, Infopark sétány 1. I épület",
            "Country": "Magyarország",
            "CountryCode": "HU",
            "Zip": "1117",
            "City": "Budapest",
            "Street": "Infopark sétány",
            "Housenumber": "1. I épület 5. emelet"
        },
        "MainActivity": "Egyéb szoftverkiadás",
        "MainActivityCodde": "5829",
        "TaxNumber": "00112233",
        "Branch": "00112233",
        "Ownership": "Zártkörűen működő részvénytársaság",
        "RegisteredAt": "2015-09-01T00:00:00",
        "DeletedAt": "0001-01-01T00:00:00",
        "DeletionMode": null,
        "Note": null,
        "Representatives": [
            {
                "RepresentationMode": "Meghatalmazott",
                "CanSign": true,
                "Office": "végelszámoló",
                "Email": "[email protected]",
                "Person": {
                    "FullName": "Teszt Tibor",
                    "LastName": "Teszt",
                    "FirstName": "Tibor",
                    "BirthDate": "1978-05-23T00:00:00.000",
                    "MothersName": "Teszt Teréz",
                    "MothersLastName": "Teszt",
                    "MothersFirstName": "Teréz",
                    "TaxNumber": "9955884466",
                    "Address": {
                        "Address": "1134 Budapest, Szilágyi utca 2.",
                        "Country": "Magyarország",
                        "CountryCode": "HU",
                        "Zip": "1134",
                        "City": "Budapest",
                        "Street": "Szilágyi utca",
                        "Housenumber": "2."
                    },
                    "AddressString": "1134 Budapest, Szilágyi utca 2."
                }
            }
        ],
        "Members": [
            {
                "Person": {
                    "FullName": "Példa Péter",
                    "LastName": "Példa",
                    "FirstName": "Péter",
                    "BirthDate": "1980-12-03T00:00:00.000",
                    "MothersName": "Péda Panna",
                    "MothersLastName": "Példa",
                    "MothersFirstName": "Panna",
                    "TaxNumber": "001122889977",
                    "Address": {
                        "Address": "1152 Budapest, Kossuth utca 35.",
                        "Country": "Magyarország",
                        "CountryCode": "HU",
                        "Zip": "1152",
                        "City": "Budapest",
                        "Street": "Kossuth utca",
                        "Housenumber": "35."
                    },
                    "AddressString": "1152 Budapest, Kossuth utca 35."
                }
            }
        ]
    }
}