Bu aşamaya gelmeniz için banka hareketlerini çekeceğiniz hesap için bankaya talimat vermeniz gerekiyor. Banka sizin vereceğiniz bir ip adresinde kullanılabilir kullanıcı adı ve parola tanımlıyor, sizde bu aşamada o ip adresi üzerinden sorgu oluşturabiliyorsunuz.
Bankaya başvuru
Başvuru formunu projenin içinde bulabilirsiniz, gerekli alanları doldurup bankanın herhangi bir şubesine vermeniz yeterli. Bir kaç gün içerisinde geri dönüş yapacaklardır. E Posta olarak kullanıcı adını, sms olarak parolayı gönderiyorlar.
Ayarlar
// Kodda göreceğiniz gibi olarak header ayarlarını yaptık. Daha sonra EkstreSorgulama metodu için gerekli parametleri girdik. Header parametlerinden WSS-Password Type, “PasswordText” türünde olmalıdır.
// Bu alana size gönderdikleri kullanıcı adı ve parolayı girin.
1
2
$username="";
$password="";
// Bu alanada hesap ekstresi için sorgulamak istediğiniz tarihleri girin.
1
2
$start_date='2020-12-12';
$end_date='2020-12-15';
İstek Parametreleri
BaslangicTarihi – DateTime – Sorgulama yapılacak tarih aralığına ait başlangıç tarihi BitisTarihi – DateTime – Sorgulama yapılacak tarih aralığına ait bitiş tarihi
Cevap Parametreleri
HataKodu string – Hata Kodu* HataAciklama string – Hata açıklama* HesapTuru string – Hesabın türünü belirtir, vadeli – vadesiz HesapNo string (Hesap[]) – Şube kodu – Müşteri Numarası – Hesap Numarası bilgilerini içerir MusteriNo string – Müşteri numarasıdır SubeKodu string – Hesabın bağlı bulunduğu şube kodudur SubeAdi string – Hesabın bağlı olduğu şube adıdır HesapAcilisTarihi string – Hesabın açıldığı tarih bilgisidir. (GG/AA/YYYY) SonHareketTarihi string – Hesabın işlem gördüğü son tarih bilgisidir Bakiye string – Sorgulanan tarih aralığındaki son bakiye bilgisidir HesapAdi string – Hesap sahibi tarafından verilen takma ad bilgisidir HesapCinsi string – Hesaın döviz cinsi bilgisidir BlokeMeblag string – Hesaba ait bloke edilmiş, kullanılmayan tutardır KullanilabilirBakiye string – Hesabın sorgulandığı andaki bakiye bilgisidir KrediLimit string – Hesabın sorgulandığı andaki açık hesap limitidir. KrediliKullanilabilirBakiye string – Hesabın sorgulandığı andaki bakiye + Kredi limit dahil bakiye bilgisidir VadeTarihi string – Son vade tarihidir yalnızca vadeli hesaplarda görünüdür FaizOrani string – Faiz oranı bilgisidir yalnızca vadeli hesaplarda görünür
Cevap Parametreleri – Hareketler
Tarih string – İşlem tarihidir Saat string – İşlem saatidir SiraNo string – Muhasebe sıra numarasıdır HareketTutari string – İşlemin muhasebe tutarıdır. Borç/Alacak bilgisi için “+/-” ve ayraç olarak “,” kullanılır. Bakiye string – İşlem sonrası bakiye bilgisidir EktreAciklama – İşlem açıklaması <br Aciklama – Bazı özel işlemler için kullanılan açıklama bilgisidir Örn : Dosyalı transfer işlem açıklamaları IslemKod string – Yapılan işlemin MT940 ekstre standardı işlem kodları bilgisidir.(MSC,TRF, FEX vs) ReferansNo string – Referans numarası DekontNo string – Dekont Numarası Iptal string – İlgili işlemin iptal edilip edilmediğini gösterir , (E: Evet iptal edilmiş, H: Hayır iptal edilmemiş) KarsiMusteriNo string – İşlemi yapan tarafın müşteri numarası KarsiAdSoyad string – İşlemi yapan tarafın ad soyad bilgisi KarsiBankaKod string – İşlemi yapan tarafın bağlı olduğu banka kodu KarsiSubeKod string – İşlemi yapan tarafın bağlı olduğu şube kodu KarsiHesapIBAN string – İşlemi yapan tarafın IBAN bilgisi KarsiKimlikNo string – İşlemi yapan tarafın kimlik bilgisidir. (TC No, Vergi No, Yabancı Kimlik No) IslemYapanKimlikNo string – İşlemi gerçekleştiren kişinin kimlik bilgisidir İslemYapanAdSoyad string – İşlemi gerçekleştiren kişinin ad soyad bilgisidir AtmNo string – İşlemin gerçekleştiği ATM bilgisidir
Burda dikkat etmeniz gereken Üst taraftaki bakiye, hesabın güncel bakiyesi değildir. İki tarih arasındaki hareketlerin bakiyesidir. Hesabın güncel bakiyesi “KullanilabilirBakiye” parametresidir, burası sizi yanıltmasın, nerden biliyorum :)) Bunlardan haric BagliHesapEkstreRequest, DekontSorgulama diye iki adet sorgulama var onlarıda gelecek günlerde paylaşıyor olacağım.
PHP Halk Bankası Hesap Hareketleri
Selamlar, bu yılın ilk postu olsun 🙂
Halk bankası online ektstre için php ile nasıl entegrasyon kuracağınıza ait dosyaları github’da paylaştım.
https://github.com/selimhallac/halkbank-hesap-hareketleri-web-servis
Halk Bankası Hesap Hareketleri Web Servis
Bu aşamaya gelmeniz için banka hareketlerini çekeceğiniz hesap için bankaya talimat vermeniz gerekiyor.
Banka sizin vereceğiniz bir ip adresinde kullanılabilir kullanıcı adı ve parola tanımlıyor, sizde bu aşamada o ip adresi üzerinden sorgu oluşturabiliyorsunuz.
Bankaya başvuru
Başvuru formunu projenin içinde bulabilirsiniz, gerekli alanları doldurup bankanın herhangi bir şubesine vermeniz yeterli. Bir kaç gün içerisinde geri dönüş yapacaklardır.
E Posta olarak kullanıcı adını, sms olarak parolayı gönderiyorlar.
Ayarlar
// Kodda göreceğiniz gibi olarak header ayarlarını yaptık. Daha sonra EkstreSorgulama metodu için gerekli parametleri girdik.
Header parametlerinden WSS-Password Type, “PasswordText” türünde olmalıdır.
// Bu alana size gönderdikleri kullanıcı adı ve parolayı girin.
// Bu alanada hesap ekstresi için sorgulamak istediğiniz tarihleri girin.
İstek Parametreleri
BaslangicTarihi – DateTime – Sorgulama yapılacak tarih aralığına ait başlangıç tarihi
BitisTarihi – DateTime – Sorgulama yapılacak tarih aralığına ait bitiş tarihi
Cevap Parametreleri
HataKodu string – Hata Kodu*
HataAciklama string – Hata açıklama*
HesapTuru string – Hesabın türünü belirtir, vadeli – vadesiz
HesapNo string (Hesap[]) – Şube kodu – Müşteri Numarası – Hesap Numarası bilgilerini içerir
MusteriNo string – Müşteri numarasıdır
SubeKodu string – Hesabın bağlı bulunduğu şube kodudur
SubeAdi string – Hesabın bağlı olduğu şube adıdır
HesapAcilisTarihi string – Hesabın açıldığı tarih bilgisidir. (GG/AA/YYYY)
SonHareketTarihi string – Hesabın işlem gördüğü son tarih bilgisidir
Bakiye string – Sorgulanan tarih aralığındaki son bakiye bilgisidir
HesapAdi string – Hesap sahibi tarafından verilen takma ad bilgisidir
HesapCinsi string – Hesaın döviz cinsi bilgisidir
BlokeMeblag string – Hesaba ait bloke edilmiş, kullanılmayan tutardır
KullanilabilirBakiye string – Hesabın sorgulandığı andaki bakiye bilgisidir
KrediLimit string – Hesabın sorgulandığı andaki açık hesap limitidir.
KrediliKullanilabilirBakiye string – Hesabın sorgulandığı andaki bakiye + Kredi limit dahil bakiye bilgisidir
VadeTarihi string – Son vade tarihidir yalnızca vadeli hesaplarda görünüdür
FaizOrani string – Faiz oranı bilgisidir yalnızca vadeli hesaplarda görünür
Cevap Parametreleri – Hareketler
Tarih string – İşlem tarihidir
Saat string – İşlem saatidir
SiraNo string – Muhasebe sıra numarasıdır
HareketTutari string – İşlemin muhasebe tutarıdır. Borç/Alacak bilgisi için “+/-” ve ayraç olarak “,” kullanılır.
Bakiye string – İşlem sonrası bakiye bilgisidir
EktreAciklama – İşlem açıklaması <br Aciklama – Bazı özel işlemler için kullanılan açıklama bilgisidir Örn : Dosyalı transfer işlem açıklamaları
IslemKod string – Yapılan işlemin MT940 ekstre standardı işlem kodları bilgisidir.(MSC,TRF, FEX vs)
ReferansNo string – Referans numarası
DekontNo string – Dekont Numarası
Iptal string – İlgili işlemin iptal edilip edilmediğini gösterir , (E: Evet iptal edilmiş, H: Hayır iptal edilmemiş)
KarsiMusteriNo string – İşlemi yapan tarafın müşteri numarası
KarsiAdSoyad string – İşlemi yapan tarafın ad soyad bilgisi
KarsiBankaKod string – İşlemi yapan tarafın bağlı olduğu banka kodu
KarsiSubeKod string – İşlemi yapan tarafın bağlı olduğu şube kodu
KarsiHesapIBAN string – İşlemi yapan tarafın IBAN bilgisi
KarsiKimlikNo string – İşlemi yapan tarafın kimlik bilgisidir. (TC No, Vergi No, Yabancı Kimlik No)
IslemYapanKimlikNo string – İşlemi gerçekleştiren kişinin kimlik bilgisidir
İslemYapanAdSoyad string – İşlemi gerçekleştiren kişinin ad soyad bilgisidir
AtmNo string – İşlemin gerçekleştiği ATM bilgisidir
Burda dikkat etmeniz gereken Üst taraftaki bakiye, hesabın güncel bakiyesi değildir. İki tarih arasındaki hareketlerin bakiyesidir. Hesabın güncel bakiyesi “KullanilabilirBakiye” parametresidir, burası sizi yanıltmasın, nerden biliyorum :))
Bunlardan haric BagliHesapEkstreRequest, DekontSorgulama diye iki adet sorgulama var onlarıda gelecek günlerde paylaşıyor olacağım.