From 32bf00a1b76fc252ae05fb79fae2844996d7532f Mon Sep 17 00:00:00 2001 From: Nuryagdy Mustapayev Date: Tue, 26 Dec 2023 20:25:56 +0100 Subject: [PATCH] updated md files --- README.md | 5 +++-- docs/CHANGELOG.md | 45 +++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 48 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index a52951cd..a07b4f61 100644 --- a/README.md +++ b/README.md @@ -130,7 +130,7 @@ Bu paket ile amaçlanan; ortak bir arayüz sınıfı ile, tüm Türk banka sanal - [Docker ile test ortamı](#docker-ile-test-ortami) ### Ozellikler - - Standart E-Commerce modeliyle ödeme (`PosInterface::MODEL_NON_SECURE`) + - Non Secure E-Commerce modeliyle ödeme (`PosInterface::MODEL_NON_SECURE`) - 3D Secure modeliyle ödeme (`PosInterface::MODEL_3D_SECURE`) - 3D Pay modeliyle ödeme (`PosInterface::MODEL_3D_PAY`) - 3D Host modeliyle ödeme (`PosInterface::MODEL_3D_HOST`) @@ -138,6 +138,7 @@ Bu paket ile amaçlanan; ortak bir arayüz sınıfı ile, tüm Türk banka sanal - Sipariş/Ödeme geçmişi sorgulama (`PosInterface::TX_TYPE_HISTORY`) - Sipariş/Para iadesi yapma (`PosInterface::TX_TYPE_REFUND`) - Sipariş iptal etme (`PosInterface::TX_TYPE_CANCEL`) + - API istek verilerinin gateway API'na gönderilmeden önce değiştirebilme - Farklı Para birimler ile ödeme desteği - Tekrarlanan (Recurring) ödeme talimatları - [PSR-3](https://www.php-fig.org/psr/psr-3/) logger desteği @@ -260,7 +261,7 @@ Redirection yapmadan iframe üzerinden veya Popup window içinde ödeme akışı `postMessage` API ile banktan dönen cevabı gönderir. `form.php` postMessage API'dan gelen mesaji işler ve kullanıcıya gösterir. -#### Dikkkat edilmesi gerekenler +#### Dikkat edilmesi gerekenler - Popup window taraycı tarafından engellenebilir bu yüzden onun yerine modal box içinde iframe kullanılması tavsiye edilir. diff --git a/docs/CHANGELOG.md b/docs/CHANGELOG.md index cb69a87f..fc88235c 100644 --- a/docs/CHANGELOG.md +++ b/docs/CHANGELOG.md @@ -1,4 +1,49 @@ # Changelog +## [1.0.0] - 2024-01-?? +### New Features + +- API istek verilerinin gateway API'na gönderilmeden önce değiştirebilme. +Bu özellik `symfony/event-dispatcher` package'i kullanılarak eklendi. +Kullanım örnekleri için `/examples` ve `/docs` klasörüne bakabilirsiniz. +Eklenen Eventler: + - `\Mews\Pos\Event\Before3DFormHashCalculatedEvent` + - `\Mews\Pos\Event\RequestDataPreparedEvent` +- **AkOdePos** entegrasonu +- Param birimleri için yeni constantlar eklendi (orn. `PosInterface::CURRENCY_TRY`) +- yeni `\Mews\Pos\PosInterface::isSupportedTransaction()` methodu eklendi. +Bu method ile kütüphanenin ilgili gateway için hangi işlemleri destekledigini kontrol edebilirsiniz. + +### Changed +- Kütüphane PHP sürümü **v7.4**'e yükseltildi. +- Constant'lar `AbstractGateway` sınıfından `PosInterface`'e taşındı. +- Config yapısı değiştirildi. +**Test** ve **Prod** ortamları için artık farklı dosyalar kullanılması gerekiyor. +Bu değişim sonucunda `\Mews\Pos\PosInterface::setTestMode();` işleminin çok da önemi kalmadı. +Yine de **GarantiPos** için gereklidir. Yeni formata için `/config` klasörüne bakınız. +- Constant isimleri değiştirildi + - `TX_PAY` => `TX_TYPE_PAY_AUTH` + - `TX_PRE_PAY` => `TX_TYPE_PAY_PRE_AUTH` + - `TX_POST_PAY` => `TX_TYPE_PAY_POST_AUTH` +- `\Mews\Pos\PosInterface::prepare()` methodu kaldırıldı. +- Pos sınıfları oluşturmak için kullanılan `\Mews\Pos\Factory\PosFactory::createPosGateway()` +methodu artık konfigürasyon yolunu (örnek: `./config/pos_test.php`) kabul etmiyor. +Config verisi **array** olarak sağlanması gerekiyor. +- $order verisinden bir zorunlu olmayan alanlar kaldırıldı: + - email + - name + - user_id + - rand (artık kütüphane kendisi oluşturuyor) + +- _vftcode_ (PosNet), _koiCode_ (PosNet), _imece_ kart (EstPos), _extraData_ (EstPos), +_callbackUrl_ (EstPos) gibi ekstra değerler kütüphanedeki kodundan kaldırıldı. +Yerine yeni eklenen eventlarla API isteklere ekstra değerler ekleyebilirsiniz. +Kullanım örneği için örnek kodlara bakabilirsiniz. +- **Tekrarlanan ödeme** yapısı biraz değiştirildi (örnek kodlara bakınız). +- `$response = \Mews\Pos\PosInterface::getResponse();` veri yapısına birkaç ekstra veri eklendi. +Artık, ödeme **iptal**, **iade**, **durum** sorgulama işlemleri için `$response` içindeki veriler yeterli. +- `PosInterface`'e ödeme durumu (order_status) için yeni constant'lar +(örn: `PAYMENT_STATUS_ERROR`, `PAYMENT_STATUS_PAYMENT_COMPLETED`) eklendi +ve bu yeni constant'ları kullanacak şekilde güncellemeler yapıldı. ## [0.16.0] - 2023-11-20 ### New Features