mews/pos-bundle

Virtual POS bundle for Turkey banks.

2.0.0 2026-07-15 08:07 UTC

Requires

• php: >=8.0
• mews/pos: ^2.0
• psr/event-dispatcher: ^1.0
• symfony/config: ^5.0 | ^6.0 | ^7.0 | ^8.0
• symfony/dependency-injection: ^5.0 | ^6.0 | ^7.0 | ^8.0
• symfony/event-dispatcher: ^5.0 | ^6.0 | ^7.0 | ^8.0
• symfony/http-kernel: ^5.0 | ^6.0 | ^7.0 | ^8.0
• symfony/options-resolver: ^5.0 | ^6.0 | ^7.0 | ^8.0

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.95.0
• nyholm/psr7: ^1.8
• phpstan/phpstan: 2.2.x-dev
• phpstan/phpstan-strict-rules: 2.0.x-dev
• phpstan/phpstan-symfony: 2.0.x-dev
• phpunit/phpunit: ^10.0
• psr/http-client: ^1.0
• symfony/framework-bundle: ^8.0
• symfony/http-client: ^8.0
• symfony/monolog-bundle: ^3.1
• symfony/yaml: ^8.0

MIT

• Muharrem ERİN
• Nuryagdy Mustapayev

• symfony payment
• symfony sanal pos
• symfony vitual pos

Published on Packagist.org on 2026-07-15 08:09 UTC

README

Temel Paket

mews/pos

Ana başlıklar

• Minimum Gereksinimler
• Kurulum
• Servis Kullanımı
• Örnek 3D Secure Ödeme
• Konfigurasyon Yapısı ve Örnekler
• API ve 3D Form verisini degiştirme
• PosQuery Servisleri (geçmiş, taksit, BIN sorguları)

Minimum Gereksinimler

• PHP >= 8.0
• mews/pos ^2.0
• Symfony 5|6|7|8

Kurulum

1. $ composer require mews/pos-bundle

2. config/packages/mews_pos.yaml dosyası oluşturun
3. ve içine bu alttaki config örneği ekleyin:

   mews_pos:
     banks:
       asseco: # herhangi unique bir isim
         gateway_class: Mews\Pos\Gateway\AssecoPos
         credentials:
           merchant_id: 700xxxxxx
           user_name: ISXXXXXX #AssecoPos: kullanici adi
           user_password: ISYYYYY #AssecoPos: kullanici sifresi
           secret_key: TRPXXXXX
         gateway_endpoints: # ilgili ortamin (test/prod) URL'leriyle degistiriniz:
           payment_api: 'https://entegrasyon.asseco-see.com.tr/fim/api'
           gateway_3d: 'https://entegrasyon.asseco-see.com.tr/fim/est3Dgate'
           gateway_3d_host: 'https://sanalpos.sanalakpos.com.tr/fim/est3Dgate' # optional, 3D Host ödemeler için zorunlu
         gateway_configs:
           lang: !php/const Mews\Pos\PosInterface::LANG_TR # optional, default: LANG_TR
       yapikredi:
         gateway_class: Mews\Pos\Gateway\PosNetPos
         credentials:
           merchant_id: 670XXXXXXX # Üye İşyeri Numarası.
           terminal_id: 67XXXXXX # Üye İşyeri Terminal Numarası
           user_name: 27XXX # Üye İşyeri POSNET Numarası
           secret_key: 10,92,92,02,02,02,02,02,01 # Şifreleme anahtar
         gateway_endpoints:
           payment_api: 'https://setmpos.ykb.com/PosnetWebService/XML'
           gateway_3d: 'https://setmpos.ykb.com/3DSWebService/YKBPaymentService'

Diğer banka konfigurasyon örnekleri için bkz. Konfigurasyon Yapısı ve Örnekler.

Servis Kullanımı

POS Gateway inject etme

mews_pos.yaml'daki ilk banka PosInterface tipiyle doğrudan inject edilebilir:

use Mews\Pos\PosInterface;

class MyService
{
    public function __construct(private PosInterface $pos) {}
}

Belirli bir bankayı inject etmek için argüman adını mews_pos.yaml'daki banka anahtarıyla eşleştirin:

use Mews\Pos\PosInterface;

class MyService
{
    public function __construct(
        private PosInterface $asseco,       // mews_pos.yaml'daki "asseco" bankası
        private PosInterface $yapikredi,    // mews_pos.yaml'daki "yapikredi" bankası
    ) {}
}

Tüm bankalara erişmek için TaggedIterator kullanın:

use Mews\Pos\PosInterface;
use Symfony\Component\DependencyInjection\Attribute\TaggedIterator;

class MyService
{
    public function __construct(
        #[TaggedIterator('mews_pos.gateway')]
        private iterable $banks,
    ) {}
}

Tam controller örneği için bkz. Örnek 3D Secure Ödeme.

PosQuery inject etme

PosQueryInterface, ödeme işlemiyle ilişkili olmayan banka sorguları (işlem geçmişi, taksit oranları, BIN sorgusu vb.) için kullanılır. Her gateway PosQuery desteği sunmaz; bundle yalnızca mews/pos kütüphanesinin o gateway için bir PosQuery sınıfı tanımladığı durumlarda servisi oluşturur.

mews_pos.yaml'daki ilk banka PosQuery destekliyorsa doğrudan inject edilebilir:

use Mews\Pos\PosQuery\PosQueryInterface;

class MyService
{
    public function __construct(private PosQueryInterface $posQuery) {}
}

Belirli bir bankayı inject etmek için argüman adını banka anahtarıyla eşleştirin:

use Mews\Pos\PosQuery\PosQueryInterface;

class MyService
{
    public function __construct(
        private PosQueryInterface $asseco,
        private PosQueryInterface $yapikredi,
    ) {}
}

Tüm PosQuery servislerine erişmek için:

use Mews\Pos\PosQuery\PosQueryInterface;
use Symfony\Component\DependencyInjection\Attribute\TaggedIterator;

class MyService
{
    public function __construct(
        #[TaggedIterator('mews_pos.query')]
        private iterable $posQueries,
    ) {}
}

Tam örnek ve desteklenen sorgu tipleri için bkz. PosQuery Servisleri.

License

MIT