მომხმარებლის გადამისამართება ბანკის ვებგვერდზე
გარე სისტემამ (ვებგვერდმა, აპლიკაციამ) უნდა უზრუნველყოს მომხმარებლის გადამისამართება საქართველოს ბანკის ავტორიზაციის გვერდზე, რომლის წარმატებით დასრულების შემდეგ, მომხმარებელი გადამისამართდება მის სისტემაში.
საქართველოს ბანკის ავტორიზაციის გვერდი Url-ზე: https://account.bog.ge/auth/realms/bog-id/protocol/openid-connect/auth?client_id={Client Identifier}&response_type=code&scope=openid%20{info_type}&login_with_mobile={t/f}&redirect_uri={redirect_uri}
Redirect პარამეტრები:
- client_id - ბანკის მიერ კომპანიისთვის გადაცემული, სისტემაში შესვლისთვის საჭირო იდენტიფიკატორი (client_id, რომელიც კომპანიას secret_key-სთან ერთად გადაეცემა).
- response_type - ყოველთვის გადაეცემა „code“ მნიშვნელობა
- scope - გადაეცემა იმ კატეგორიის/კატეგორიების კოდი, რომელი კატეგორიის ინფორმაციაზეც სურს კლიენტს მომხარებლის თანხმობა.
- redirect_uri - ვებგვერდის მისამართი, რომელზეც უნდა გადავიდეს მომხმარებელი აუტენტიფიკაციის წარმატებით გავლის შემდეგ.
- login_with_mobile - არასავალდებულო პარამეტრია, გადაეცემა true იმ შემთხვევაში თუ გვინდა გამოჩნდეს QR/mBank-ით ავტორიზაცია.
- ui_locales - ka/en შესაძლო მნიშვნელობებით, გვერდი გაიხსნება შესაბამის ენაზე.
კატეგორიები:
- FPI (Full personal info) – სრული პირადი ინფორმაცია
- DI (Document Info) - დოკუმენტის ინფორმაცია
- BI (Birth info) - ინფორმაცია დაბადების თარიღის და ადგილის შესახებ
- CI (Contact Info) - საკონტაქტო ინფორმაცია
- BPI (Basic personal info) - საბაზისო პირადი ინფორმაცია
- PI (Personal Info) – ძირითადი პირადი ინფორმაცია
იხილეთ გვერდი 'მომხმარებელზე ინფორმაციის გაგება' დეტალური აღწერისთვის.
დამატებითი პარამეტრები:
ასევე scope-ში დამატებით შესაძლებელია loginByPin პარამეტრის მითითება, რა შემთხვევაშიც მომხარებელს შეეძლება ავტორიზაციის გავლა პირადი ნომრის შეყვანის საშუალებით.
ავტორიზაციის Url loginByPin, login_with_mobile და ui_locales პარამეტრების დამატების შემთხვევაში:
https://account.bog.ge/auth/realms/bog-id/protocol/openid-connect/auth?client_id={Client Identifier}&response_type=code&scope=openid%20{info_type}%20loginByPin&redirect_uri={redirect_uri}&login_with_mobile=true&ui_locales=ka
Response პარამეტრები:
- code – მომხმარებლის აუტენტიფიკაციის საჭირო დროებითი კოდი.