HHS Süreci
Rıza isteği sonrasında mobil uygulamalar üzerinden kullanıcıların nasıl yönlendirileceğini ve ilgili servislerin nasıl kullanılacağı açıklanmaktadır. Bu süreç iOS ve Android platformları için ayrı ayrı ele alınmış ve ilgili deep linkler ve URL'ler ile kullanıcıların hesap veya ödeme emri rızası türlerine göre yönlendirilmesi detaylandırılmıştır.
Model alanları bkm dokümanına göre set edilmiştir. Alan açıklamaları için BKM doküman linkleri sonda paylaşılmıştır.
1. Deep Linkler ve ULinkler
iOS
-
Burgan
- ULink: Burgan ULink
- Deep Link:
burgantest://openbanking?consentno=f4402c7c-3d80-416a-8c20-7e2c4fa7bb33
-
On
- ULink: On ULink
- Deep Link:
ontest://openbanking?consentno=7017ad15-3ba7-4e7b-b3f5-3487a94a0e08
Android
-
Burgan
- ULink: Burgan ULink
- Deep Link:
burgan://openbanking?consentno=f4402c7c-3d80-416a-8c20-7e2c4fa7bb33
-
On
- ULink: On ULink
- Deep Link:
onmobil://openbanking?consentno=18860349-68ba-4db0-8d9a-133f9d8c0033
2. Rıza Tipinin Belirlenmesi
Mobil uygulama, linkler içerisindeki rıza bilgilerini yakalar ve consent servisinden rıza tipini öğrenir.
API Çağrısı
- URL:
https://test-amorphie-consent.burgan.com.tr/OpenBankingConsentHHS/GetConsentWebViewInfo/{consentId}
- Örnek Curl:
Rıza türüne göre hesap bilgisi rızası ekranları ya da ödeme emri rızası ekranları açtırılır.
Rıza Türlerine Göre Yönlendirme
Hesap Rızası
- Rıza Bilgilerinin Getirilmesi
- URL:
https://test-amorphie-consent.burgan.com.tr/OpenBankingConsentHHS/GetAccountConsentById/{rizaNo}
UI a gelen rıza ile istek atılır aşağıda ki örnek responsedan rıza bilgileri getirilir.
- Kullanıcının Bilgilerinin Alınması
"businessLine" bilgisi ile Burgan/ON ayrımı yapıyoruz.
- URL:
https://test-entegrasyon-customerapi.burgan.com.tr/customer?keyword={customerNo}&api-version=3
- Örnek Response:
{
"recordCount": 2,
"returnCode": 0,
"returnDescription": "Başarılı",
"customerList": [
{
"customerNumber": 20119720,
"name": {
"first": "Name - 20119720",
"last": "SurName - 20119720"
},
"citizenshipNumber": "11111111111",
"taxNo": "",
"isStaff": false,
"gsmPhone": {
"country": "90",
"prefix": "532",
"number": "1214434"
},
"email": null,
"businessEmail": null,
"businessLine": "X",
"branchCode": 2000,
"branchName": "BURGAN DİJİTAL",
"recordStatus": "A",
"customerAddress": {
"district": "",
"street": "",
"addressDetail": "",
"town": "",
"city": "",
"address": ""
},
"identityNumber": "11111111111"
},
{
"customerNumber": 20129692,
"name": {
"first": "BELMA",
"last": "GÖREN"
},
"citizenshipNumber": "11111111111",
"taxNo": "",
"isStaff": true,
"gsmPhone": {
"country": "90",
"prefix": "532",
"number": "1214434"
},
"email": null,
"businessEmail": "BGoren@burgan.com.tr",
"businessLine": "B",
"branchCode": 9530,
"branchName": "MERKEZ",
"recordStatus": "A",
"customerAddress": {
"district": "District Test",
"street": "Street Test",
"addressDetail": "AddressDetail Test",
"town": "Town Test",
"city": "City Test",
"address": "District Test Street Test AddressDetail Test Town Test City Test"
},
"identityNumber": "11111111111"
}
]
}
-
Hesap Bilgilerinin Getirilmesi
- URL:
http://svtstr3app01.ebt.bank/fora/DigitalServices/AccountService.svc/hesaplar/{customerNo}?syfKytSayi={syfKytSayi}&syfNo={syfNo}&srlmKrtr={srlmKrtr}&srlmYon={srlmYon}
- Headers:
Content-Type: application/json
CHANNEL:INTERNET
branch:2000
user:EBT\INTERNETUSER
- Örnek Response:
-
Bakiye Bilgilerinin Getirilmesi
- URL:
http://svtstr3app01.ebt.bank/fora/DigitalServices/AccountService.svc/hesaplar/{customerNo}/bakiye
- Headers:
Content-Type: application/json
CHANNEL:INTERNET
branch:2000
user:EBT\INTERNETUSER
- Örnek Response:
-
YÖS Bilgilerinin Getirilmesi
- URL:
https://test-amorphie-consent.burgan.com.tr/OpenBankingYosInfo/code/{code}
- Örnek Response:
-
Consent Güncelleme
- URL:
https://test-amorphie-consent.burgan.com.tr/OpenBankingConsentHHS/UpdateAccountConsentForAuthorization
- Örnek Body:
-
Yetkilendirme Kodu Alma ve Yönlendirme
- Redirect URL:
http://test-amorphie-token.burgan.com.tr/public/OpenBankingAuthCode?consentId={consentId}
Ödeme Emri Rızası
-
Rıza Bilgilerinin Getirilmesi
- URL:
https://test-amorphie-consent.burgan.com.tr/OpenBankingConsentHHS/GetPaymentConsentById/{rizaNo}
- Örnek Response:
{
"AdditionalData": {
"rzBlg": {
"rizaNo": "a315d6d8-4ca5-49d9-b63e-da463409bf5a",
"olusZmn": "2024-05-23T13:12:41.570967Z",
"gnclZmn": "2024-05-23T13:12:41.5709846Z",
"rizaDrm": "B",
"rizaIptDtyKod": null
},
"katilimciBlg": {
"hhsKod": "0125",
"yosKod": "2710"
},
"gkd": {
"yetYntm": "Y",
"yonAdr": "https://tripsit.bkm.com.tr/boss/ab/yos-simulator-ui-v11/2710?drmKod=2bdc3da1-0f6e-4bba-9200-e39ceafcd626",
"ayrikGkd": null,
"hhsYonAdr": "https://yccw.adj.st/openbanking?consentno=a315d6d8-4ca5-49d9-b63e-da463409bf5a&adj_t=1a1840pb&adj_redirect=https%3A%2F%2Ftest-amorphie-token.burgan.com.tr%2Fpublic%2FOpenBankingAuthorize%3Friza_no%3Da315d6d8-4ca5-49d9-b63e-da463409bf5a",
"yetTmmZmn": "2024-05-23T13:17:41.8844043Z"
},
"odmBsltm": {
"kmlk": {
"kmlkTur": "K",
"kmlkVrs": "14785096134",
"krmKmlkTur": null,
"krmKmlkVrs": null,
"ohkTur": "B"
},
"islTtr": {
"prBrm": "TRY",
"ttr": "100.00"
},
"gon": {
"unv": "KERİM KELEN",
"hspNo": "TR660012502002018701700351",
"hspRef": null
},
"alc": {
"unv": "Serkan Eren",
"hspNo": "TR320010009999901234567890",
"kolas": null
},
"kkod": null,
"odmAyr": {
"odmKynk": "O",
"odmAmc": "04",
"refBlg": "Y-2701852-202302",
"odmAcklm": "Iıçoğuş ÇÖĞÜŞ",
"ohkMsj": "ÖHK Mesajı",
"odmStm": "E",
"bekOdmZmn": null
},
"hhsMsrfTtr": {
"prBrm": "TRY",
"ttr": "0,00000000"
},
"obhsMsrfTtr": null
},
"isyOdmBlg": {
"isyKtgKod": "5732",
"altIsyKtgKod": "5732",
"genelUyeIsyeriNo": "01234567"
}
},
"Id": "a315d6d8-4ca5-49d9-b63e-da463409bf5a",
"UserId": null
}
-
Kullanıcının Bilgilerinin Alınması
- URL:
https://test-entegrasyon-customerapi.burgan.com.tr/customer?keyword={customerNo}&api-version=3
- Örnek Response:
{
"recordCount": 2,
"returnCode": 0,
"returnDescription": "Başarılı",
"customerList": [
{
"customerNumber": 20119720,
"name": {
"first": "Name - 20119720",
"last": "SurName - 20119720"
},
"citizenshipNumber": "11111111111",
"taxNo": "",
"isStaff": false,
"gsmPhone": {
"country": "90",
"prefix": "532",
"number": "1214434"
},
"email": null,
"businessEmail": null,
"businessLine": "X",
"branchCode": 2000,
"branchName": "BURGAN DİJİTAL",
"recordStatus": "A",
"customerAddress": {
"district": "",
"street": "",
"addressDetail": "",
"town": "",
"city": "",
"address": ""
},
"identityNumber": "11111111111"
},
{
"customerNumber": 20129692,
"name": {
"first": "BELMA",
"last": "GÖREN"
},
"citizenshipNumber": "11111111111",
"taxNo": "",
"isStaff": true,
"gsmPhone": {
"country": "90",
"prefix": "532",
"number": "1214434"
},
"email": null,
"businessEmail": "BGoren@burgan.com.tr",
"businessLine": "B",
"branchCode": 9530,
"branchName": "MERKEZ",
"recordStatus": "A",
"customerAddress": {
"district": "District Test",
"street": "Street Test",
"addressDetail": "AddressDetail Test",
"town": "Town Test",
"city": "City Test",
"address": "District Test Street Test AddressDetail Test Town Test City Test"
},
"identityNumber": "11111111111"
}
]
}
-
Hesap Bilgilerinin Getirilmesi
- URL:
http://svtstr3app01.ebt.bank/fora/DigitalServices/AccountService.svc/hesaplar/{customerNo}?syfKytSayi={syfKytSayi}&syfNo={syfNo}&srlmKrtr={srlmKrtr}&srlmYon={srlmYon}
- Headers:
Content-Type: application/json
CHANNEL:INTERNET
branch:2000
user:EBT\INTERNETUSER
- Örnek Response:
-
Bakiye Bilgilerinin Getirilmesi
- URL:
http://svtstr3app01.ebt.bank/fora/DigitalServices/AccountService.svc/hesaplar/{customerNo}/bakiye
- Headers:
Content-Type: application/json
CHANNEL:INTERNET
branch:2000
user:EBT\INTERNETUSER
- Örnek Response:
-
YÖS Bilgilerinin Getirilmesi
- URL:
https://test-amorphie-consent.burgan.com.tr/OpenBankingYosInfo/code/{code}
- Örnek Response:
-
Consent Güncelleme
- URL:
https://test-amorphie-consent.burgan.com.tr/OpenBankingConsentHHS/UpdatePaymentConsentForAuthorization
- Örnek Body:
-
Yetkilendirme Kodu Alma ve Yönlendirme
- Redirect URL:
http://test-amorphie-token.burgan.com.tr/public/OpenBankingAuthCode?consentId={consentId}
BKM Dokümanı İlgili Linkler