PHPackages                             ravan/ziraat-bank - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. ravan/ziraat-bank

ActiveLibrary

ravan/ziraat-bank
=================

Ziraat Bankası HEK\_NKYWS (Hesap Hareketleri) SOAP API Wrapper for PHP 8+

00

Since Jul 22Compare

[ Source](https://github.com/ravanbabayev/ziraat-bank-php)[ Packagist](https://packagist.org/packages/ravan/ziraat-bank)[ RSS](/packages/ravan-ziraat-bank/feed)WikiDiscussions Synced today

READMEChangelogDependenciesVersions (1)Used By (0)

Ziraat Bankası SOAP API Wrapper for PHP 8+
==========================================

[](#ziraat-bankası-soap-api-wrapper-for-php-8)

[![Latest Version on Packagist](https://camo.githubusercontent.com/4929c54122221a8edc3b135c21da25ea4964f0dac7ccd6084de01d112e024826/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f726176616e2f7a69726161742d62616e6b2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/ravan/ziraat-bank)[![Total Downloads](https://camo.githubusercontent.com/26b676bfaf4b7fc15539030d7ae34d887aa839dfa560a8cf78695384cec94cc6/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f726176616e2f7a69726161742d62616e6b2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/ravan/ziraat-bank)[![Software License](https://camo.githubusercontent.com/55c0218c8f8009f06ad4ddae837ddd05301481fcf0dff8e0ed9dadda8780713e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](LICENSE)

\[TR\] T.C. Ziraat Bankası `HEK_NKYWS` (Hesap Hareketleri) SOAP entegrasyonu için geliştirilmiş framework bağımsız, PHP 8.0+ destekleyen modern kütüphane.

\[EN\] Modern framework-agnostic PHP 8.0+ library for T.C. Ziraat Bank `HEK_NKYWS` (Account Transactions) SOAP integration.

---

Özellikler / Features
---------------------

[](#özellikler--features)

- **PHP 8.0+ & PSR Standartları** ile tam uyum.
- **Framework Bağımsız (Agnostic):** Herhangi bir PHP projesinde veya doğrudan Laravel ile kullanılabilir.
- **19 Metot Desteği:** WSDL'de bulunan tüm SOAP metotlarını (sorgulamalar, PDF dekont, mutabakat) içerir.
- **Casing Tutarlılığı:** WSDL alan adlarındaki tutarsız casing yapısı korunarak hata yapma payı sıfıra indirilmiştir.
- **Laravel Desteği:** Auto-discovery, Config dosyası ve Facade desteği ile Laravel projelerinde anında entegrasyon.
- **PSR-3 Logger & PSR-16 Cache** desteği.

---

Kurulum / Installation
----------------------

[](#kurulum--installation)

Composer aracılığı ile paketi projenize dahil edin:

```
composer require ravan/ziraat-bank
```

*Not: SOAP servislerini kullanabilmek için PHP `ext-soap` eklentisinin aktif olması gerekmektedir.*

---

Kullanım / Usage
----------------

[](#kullanım--usage)

### 1. Sade PHP (Framework Bağımsız) / Standalone PHP

[](#1-sade-php-framework-bağımsız--standalone-php)

```
use Ravan\ZiraatBank\ZiraatBankService;

$service = new ZiraatBankService(
    kurumKod: 'kullanıcı-adınız',
    sifre: 'şifreniz',
    wsdl: 'https://hesap.ziraatbank.com.tr/HEK_NKYWS/HesapHareketleri.asmx?WSDL', // Opsiyonel varsayılan
    tcknVkn: '1234567890' // Opsiyonel
);

// Örnek: IBAN ile hesap özeti sorgulama
$response = $service->sorgulaOzetWS(
    ibanNo: 'TR...',
    baslangicTarihi: '20.07.2026',
    bitisTarihi: '22.07.2026'
);

print_r($response);
```

### 2. Laravel Entegrasyonu / Laravel Integration

[](#2-laravel-entegrasyonu--laravel-integration)

Paket, Laravel auto-discovery'yi destekler. Service provider ve Facade otomatik olarak yüklenir.

#### Yapılandırma Yayınlama / Publish Config

[](#yapılandırma-yayınlama--publish-config)

Ayarlar dosyasını (`config/ziraatbank.php`) oluşturmak için:

```
php artisan vendor:publish --provider="Ravan\ZiraatBank\Laravel\ZiraatBankServiceProvider" --tag="ziraatbank-config"
```

#### `.env` Tanımlamaları / .env Configuration

[](#env-tanımlamaları--env-configuration)

Aşağıdaki değişkenleri `.env` dosyanıza ekleyin:

```
ZIRAAT_HEK_USERNAME="kullanici_adiniz"
ZIRAAT_HEK_PASSWORD="sifreniz_buraya"
ZIRAAT_HEK_TCKNVKN="tckn_veya_vkn_numaraniz"
# Opsiyonel:
ZIRAAT_HEK_WSDL="https://hesap.ziraatbank.com.tr/HEK_NKYWS/HesapHareketleri.asmx?WSDL"
```

#### Laravel Facade Kullanımı / Facade Usage

[](#laravel-facade-kullanımı--facade-usage)

```
use Ravan\ZiraatBank\Laravel\Facades\ZiraatBank;

// Müşteri ve ek no ile hesap hareketleri
$sonuc = ZiraatBank::sorgulaHesapHareket(
    musteriNo: 123456,
    ekNo: 0,
    baslangicTr: '20.07.2026',
    bitisTr: '22.07.2026'
);
```

---

Metotlar / Available Methods
----------------------------

[](#metotlar--available-methods)

Aşağıda kütüphane içerisinde hazır bulunan 19 SOAP metodu ve ek yardımcı metotlar listelenmiştir.

### SOAP Servis Metotları

[](#soap-servis-metotları)

- `musteriHesapHareket(...)`
- `hesapEkstre(...)`
- `hesapEkstreZamanIle(...)`
- `sorgulaDetayWS(...)`
- `sorgulaDetayWSZamanIle(...)`
- `sorgulaOzetWS(...)`
- `sorgulaOzetWSZamanIle(...)`
- `hareketSorgulaVknIle(...)`
- `getirPdfDekont(...)`
- `getirPdfDekontZamanIle(...)`
- `getirPdfDekontDekontNoIle(...)`
- `sorgulaHesapHareket(...)`
- `sorgulaHesapHareketZamanIle(...)`
- `sorgulaHesapHareketZamanIleHizli(...)`
- `getirTanimliHesapBilgileri(...)`
- `sorgulaGelenParaTransfer(...)`
- `sorgulaMutabakatOzetZamanIle(...)`
- `sorgulaMutabakatDetayZamanIle(...)`
- `sorgulaMahsupDetayZamanIle(...)`

### Birleşik ve Yardımcı Metotlar / Helper Methods

[](#birleşik-ve-yardımcı-metotlar--helper-methods)

- **`ping()`**: WSDL endpoint'e erişilebilirliği test eder (`bool`).
- **`getBankAccounts()`**: TCKN/VKN'ye bağlı tüm aktif banka hesaplarını normalize edilmiş formatta listeler (Önbellekleme desteklidir).
- **`getAccountTransactions($accountId, $startDate, $endDate)`**: Belirli bir hesaba ait hareketleri çeker ve entegrasyon zamanına göre filtreler.
- **`getHesaplarVeHareketleri($tcknVkn, $baslangicTr, $bitisTr)`**: Tüm hesapları çeker ve her birinin hareketlerini birleştirerek tek bir dizi halinde döner.
- **`getLastExchange()`**: Son gönderilen/alınan XML istek ve yanıtlarını hata ayıklama (debug) için döner.

---

Hata Ayıklama (Debug) / Logging & Caching
---------------------------------------------

[](#hata-ayıklama-debug--logging--caching)

Kütüphane PSR-3 uyumlu logger ve PSR-16 uyumlu cache arabirimlerini destekler. Laravel üzerinde kullanıldığında uygulamanızın varsayılan Log ve Cache sistemleri otomatik olarak kütüphaneye enjekte edilir.

Sade PHP kullanımında ise bağımlılıklarınızı manuel olarak enjekte edebilirsiniz:

```
$service->setLogger($myPsr3Logger);
$service->setCache($myPsr16Cache);
```

---

Lisans / License
----------------

[](#lisans--license)

Bu paket [MIT Lisansı](LICENSE) altında dağıtılmaktadır.

###  Health Score

9

—

LowBetter than 0% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity0

Limited adoption so far

Community2

Small or concentrated contributor base

Maturity11

Early-stage or recently created project

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/6435328c8d3985f5931692448d5c9edb218c342aa0d33bd879e7323dba1bf9b9?d=identicon)[ravanbabayev](/maintainers/ravanbabayev)

### Embed Badge

![Health badge](/badges/ravan-ziraat-bank/health.svg)

```
[![Health](https://phpackages.com/badges/ravan-ziraat-bank/health.svg)](https://phpackages.com/packages/ravan-ziraat-bank)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)