Hesap bilgi rızasını başlatmak için ilgili endpoint ve https metod bilgisi aşağıda verilmiştir.
| HTTP Method | URL |
|---|---|
| POST | /hbh/riza/v1/hesap-bilgi-rizasi-baslat |
| Parametre | Tip | Zorunlu | Açıklama |
|---|---|---|---|
| hhs_Kod | string | Evet | Banka/Kurum Kodu (4 karakter olmalıdır) |
| YetYntm | string | Evet | Yetkilendirme Yönetimi (1 karakter olmalıdır) |
| izin_Tur | obje | Evet | İzin Türleri |
| kmlkTur | string | Evet | Kimlik Türü (1 karakter olmalıdır) |
| kmlkVrs | string | Evet | Kimlik Değeri (Minimum 1 , Maksimum 30 karakter olmalıdır.) |
| krm_KmlkTur | string | Hayır | Kimlik Türü (1 Karakter olmalıdır) |
| krm_KmlkVrs | string | Hayır | Kurumsal Kimlik Değeri (Minimum 1 Maksimum 30 karakter olmalıdır) |
| erisimIzni_GunSayisi | int | Evet | Erişim İzni Gün Sayısı (Minimum 1 , Maksimum 183 karakter olmalıdır) |
| erisimIzni_HesapIslemBslZmn | string | Hayır | Hesap Hareketi Sorgulama Zaman Aralığı Başlangıcı |
| erisimIzni_HesapIslemBtsZmn | string | Hayır | Hesap Hareketi Sorgulama Zaman Aralığı Bitiş |
| gkd_yonAdr | string | Hayır | Güvenli Kimlik Doğrulama(GKD) Yönlendirme Adresi (Maksimum 1000 Karakter Olmalıdır) |
| Parametre | Tip | Açıklama |
|---|---|---|
| gkd_Yap | bool | Güvenli Kimlik Doğrulama |
| hhs_Kod | string | Banka / Kurum Kodu (Hesap Hizmet Sağlayıcısı) |
| hhs_Unvan | string | Banka / Kurum Unvanı (Hesap Hizmet Sağlayıcısı) |
| riza_No | string | Rıza Numarası |
| riza_Drm | string | Rıza Durumu |
| riza_Drm_Aciklama | string | Rıza Durumu Açıklama |
| riza_IptDtyKod | string | Rıza İptal Detay Kodu |
| riza_IptDty_Aciklama | string | Rıza İptal Detay Açıklaması |
| riza_OhkMsj | string | Ödeme Hizmeti Kullanıcısı Mesajı |
| gkd_DrmKod | string | Güvenli Kimlik Doğrulama Durum Kodu |
| gkd_YetYntm | string | Yetkilendirme Yöntemi |
| gkd_YetYntm_Aciklama | string | Yetkilendirme Yöntemi Açıklaması |
| gkd_YonAdr | string | Güvenli Kimlik Doğrulama(GKD) Yönlendirme Adresi |
| gkd_BldAdr | string | Bildirim Adresi |
| gkd_YetTmmZmn | string | Yetkilendirme Tamamlanma Zamanı |
| gkd_HhsYonAdr | string | Banka/Kurum Yönlendirme Adresi |
İSTEK (Body-raw) :
{
"hhs_Kod": "21844885",
"YetYntm": "A",
"izin_Tur": ["01","02","03","04","05"],
"kmlkTur": "K",
"kmlkVrs": "22395370500",
"krm_KmlkTur": null,
"krm_KmlkVrs": null,
"erisimIzni_GunSayisi": 30,
"erisimIzni_HesapIslemBslZmn": "2022-02-17",
"erisimIzni_HesapIslemBtsZmn": "2024-02-17",
"gkd_yonAdr":"https://localhos:7221/gw/hbh/riza/v1/hesap-bilgi-rizasi-yonlendirme"
}YANIT:
{
"gkd_Yap": true,
"hhs_Kod": "2129",
"hhs_Unvan": "Sipay_HHS_YapiVeKrediBankasi",
"riza_No": "bf0rcea7643c42debaf49b8c47216125",
"riza_Drm": "B",
"riza_Drm_Aciklama": "Yetki Bekleniyor",
"riza_IptDtyKod": "",
"riza_IptDty_Aciklama": "",
"riza_OhkMsj": "ÖHK Mesajı",
"gkd_YetYntm": "Y",
"gkd_YetYntm_Aciklama": "Yönlendirmeli GKD",
"gkd_YonAdr": "https://bkmpsd2.walletgate.io/yonlendirme",
"gkd_BldAdr": null,
"gkd_YetTmmZmn": "2022-10-06T18:04:40+03:00",
"gkd_HhsYonAdr": "https://tripsit.bkm.com.tr/boss/ab/hhsSimulator/2129/hesap-bilgisi-rizasi/bf0ccea2643c42debac49b8c47216125/goruntule"
}
BAŞARISIZ YANIT:
{
"path": "/hbh/riza/v1/hesap-bilgi-rizasi-baslat",
"timestamp": "2023-02-20T15:25:22+03:00",
"httpCode": 400,
"httpMessage": "BadRequest",
"errorCode": "Api.Business.Error",
"message": "'TCKN' türünde '22395370506' numaralı kimlik bilginiz bulunmaktadır. 'TCKN' türünda farklı bir kimlik ile işlem yapamazsınız!"
}