მომხმარებელზე ინფორმაციის გაგება

მოცემული მეთოდის საშუალებით, გარე სისტემა იღებს მონაცემებს მომხმარებლის შესახებ. ინფორმაციის მოცულობა დაყოფილია კატეგორიებად. კლიენტი scope პარამტრში უთითებს თუ რომელი კატეგორიის ინფორმაციაზე სურს მომხარებლის თანხმობა. შესაძლებელია შემდეგი კატეგორიებიდან არჩევა:

• FPI (Full personal info) – სრული პირადი ინფორმაცია
• DI (Document Info) - დოკუმენტის ინფორმაცია
• BI (Birth info) - ინფორმაცია დაბადების თარიღის და ადგილის შესახებ
• CI (Contact Info) - საკონტაქტო ინფორმაცია
• BPI (Basic personal info) - საბაზისო პირადი ინფორმაცია
• PI (Personal Info) – ძირითადი პირადი ინფორმაცია

მომხმარებლის სარეგისტრაციო ინფორმაციის მოთხოვნის შედეგად შესაძლებელია მივიღოთ მოცემული მონაცემები Json ფორმატში. ქვემოთ მოცემულ ცხრილში შეგიძლიათ იხილოთ თითოეულ კატეგორიაში შემავალი ინფორმაცია:

		FPI	DI	BPI	PI	BI	CI
firstName	სახელი	✅		✅	✅
lastName	გვარი	✅		✅	✅
pin	პირადი ნომერი	✅			✅
citizenshipCountry	მოქალაქეობის ქვეყნის ISO Alpha-2 კოდი	✅			✅
sex	სქესი	✅		✅	✅
birthDate	დაბადების თარიღი	✅				✅
birthCountry	დაბადების ადგილი – ქვეყანა ISO Alpha-2 კოდი	✅				✅
birthPlace	დაბადების ადგილი – ქალაქი	✅				✅
photo	ფოტოსურათი, Base64 ფორმატში	✅			✅
type	დოკუმენტის ტიპი	✅	✅
docNo	დოკუმენტის ნომერი	✅	✅
issueDate	დოკუმენტის გაცემის თარიღი	✅	✅
issuerCountry	დოკუმენტის გამცემი ქვეყანა	✅	✅
issuer	დოკუმენტის გამცემი ორგანო	✅	✅
expiryDate	დოკუმენტის მოქმედების ვადა	✅	✅
homeAddress	რეგისტრაციის მისამართი						✅
actualAddress	ფაქტობრივი საცხოვრებელი ადგილი						✅
phone	ტელეფონის ნომერი						✅
mail	ელ.ფოსტა						✅

Header-ის პარამეტრები

Content-Typerequiredapplication/json

AuthorizationrequiredBearer <jwt_token>

გადაეცემა Bearer <jwt_token> მნიშვნელობა, სადაც jwt_token არის აუტენტიფიკაციის მეთოდის Response-ის access_token პარამეტრში დაბრუნებული მნიშვნელობა.

channeloptionalString

კომპანიის client_id.

operationIdrequiredString

კომპანიის მიერ დაგენერირებული, ოპერაციის უნიკალური იდენტიფიკატორი.

REQUEST

GET https://bogid.bog.ge/v1/customer-data
Content-Type: application/json
Authorization: Bearer <jwt_token>
channel: "123456",
operationId: "123456"

Response

resultCodeString

ოპერაციის შედეგის კოდი. 0 - თუ ოპერაცია დასრულდა წარმატებით.

errorKey String

შეცდომის კოდი.

errorMessageString

შეცდომის ტექსტი.

userDataObject

ინფორმაცია მომხმარებლის შესახებ.

firstNameString

სახელი

lastNameString

გვარი

birthDateDate

დაბადების თარიღი

pinString

პირადი ნომერი

identityDocumentArray

ერთი ან რამდენიმე ჩანაწერიანი მასივი, ინფორმაციით დოკუმენტის შესახებ

typeString

დოკუმენტის ტიპი

docNoString

დოკუმენტის ნომერი

issueDateDate

დოკუმენტის გაცემის თარიღი

issuerCountryString

დოკუმენტის გამცემი ქვეყანა

issuerString

დოკუმენტის გამცემი ორგანო

expiryDateDate

დოკუმენტის მოქმედების ვადა

sexString

სქესი

citizenshipCountryString

მოქალაქეობის ქვეყნის ISO Alpha-2 კოდი

birthCountryString

დაბადების ადგილი. ქვეყნის ISO Alpha-2 კოდი

birthPlaceString

დაბადების ქალაქი

homeAddressString

რეგისტრაციის მისამართი

actualAddressString

ფაქტობრივი საცხოვრებელი ადგილი

photoString

ფოტოსურათი, Base64 ფორმატში

phoneString

ტელეფონის ნომერი

mailString

ელ.ფოსტა

RESPONSE

{
  "resultCode": "String",
  "errorKey ": "String",
  "errorMessage": "String",
  "userData": {
      "firstName": "String",
      "lastName": "String",
      "birthDate": "Date",
      "pin": "String",
      "identityDocument" : [
          {
            "type": "String",
            "docNo": "String",
            "issueDate":  "Date",
            "issuerCountry":  "String",
            "issuer":  "String",
            "expiryDate": "Date"
          },
          {
            "type": "String",
            "docNo": "String",
            "issueDate":  "Date",
            "issuerCountry":  "String",
            "issuer":  "String",
            "expiryDate": "Date"
          }
      ],
      "sex": "String",
      "citizenshipCountry" : "String",
      "birthCountry": "String",
      "birthPlace": "String",
      "homeAddress": "String",
      "actualAddress": "String",
      "photo": "String",
      "phone": "String",
      "mail": "String",

  }
}