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.