Param Sanal Pos Entegrasyonu

Bu proje PHP yazılım dili ve https://dev.param.com.tr/tr/api dökümantasyonu kullanılarak kodlandı.

Kredi kartı ile taksitli veya tek çekim tahsilat sağlamak amacıyla hazırlanmış entegrasyon api yardım dokümandır. Firmanın web sitesinden elektronik tahsilat altyapısını kullanarak ParamPOS sistemi ile yapılacak ödemeleri kapsar.

Örnek Çalışan Proje

http://okesmez.com/parampos-v2/test.php bağlantısından örnek çalışan projeye ulaşabilirisniz.

Konfigirasyon Tanımlamaları

• İşletmeye ait olan tanımlamalar. Config/index.php dosyası üzerinde tanımlanmalıdır.
• Config/index.php dosyası içerisinde tanımlı olarak bulunan WHICH(7.satır) parametresi iki değer alabiliyor. eğer test üzerinde işlem yürütmek istiyorsanız TEST, canlı servis adresi üzerinde çalışmak istiyorsanız PROD olarak tanımlamalısınız.
• Eğer canlı yani PROD ortamda çalışmak istiyorsanız. Config/index.php sayfasına aşağıdaki örneğe benzer bir datayı POST methodu ile göndermelisiniz.

 $_POST        = [
     '-KK_Sahibi-'          => 'okesmez',
     '-KK_No-'              => '4022774022774026',
     '-KK_SK_Ay-'           => 12,
     '-KK_SK_Yil-'          => 26,
     '-KK_CVC-'             => '000',
     '-KK_Sahibi_GSM-'      => '',
     '-Siparis_ID-'         => time(),
     '-Siparis_Aciklama-'   => 'Test Siparişi',
     '-Taksit-'             => 1, //1,2,3,5....
     '-Islem_Tutar-'        => '12,00',
     '-Toplam_Tutar-'       => '12,00',
     '-Islem_ID-'           => 'islemId'.time(),
     '-IPAdr-'              => $_SERVER['REMOTE_ADDR'],
     '-1a-'                 => 'Test Data 1',
     '-2a-'                 => 'Test Data 2',
     '-3a-'                 => 'Test Data 3',
 ];
 

• Parampos kullanılarak yapılan ödeme işlemlerinin başarılı ve başarısız tamamlanamsı durumuna göre yönlendirileceği adresleri yine Config/index.php dosyasında tanımlamalısınız.(30 ve 31. satırlar)

Örnek 3D PAY(Ödeme) örneği

• 3D Pay ile ödemeye ait örnek çalışan kodlar için https://github.com/ofke-yazilim/parampos-v2/blob/master/index.php dosyasınI inceleyebilirsiniz.

Örnek Kullanıcı Özel Pos Oranlarının Alınması

• Özel Taksit oranlarının çekildiği örnek çalışan kodlar için https://github.com/ofke-yazilim/parampos-v2/blob/master/installment.php dosyasını inceleyebilirisiniz.

Yeni Servis Entegrasyonu Eklemek

• Xml dizini içerisine, kullanılacak soap xml dosyası eklenir.(Örneğin 3D Pay için https://dev.param.com.tr/tr/api/oedeme-v2 adresinde bulunan tab menu içerisindeki Request sekmesinde bulunan xml verisi alınır.)
• Builder dizini içerisine gidilerek: class içerisine eklenmiş olan XML prametrelerini içerecek bir array tanımlanır. Array içerisindeki değerler yukarıda bahsettiğim linkte bulunan Gönderilecek Parametreler sekmesinde mevcuttur. Ardından tanımlanan bu array’ı return olarak döndürecek fonksiyon tanımlanır.
• Request dizinine girerek en üst kısma Servise ait endpoint tanımlaması yapılır. Parampos üzerinde çalışan tüm servis adreslerine ve endpointlerine https://test-dmz.param.com.tr:4443/turkpos.ws/service_turkpos_test.asmx adresinden ilgili methodlara tıklayarak ulaşabilirsiniz. Endpoint verileri açmış olduğunuz sayfada ? ve sonrasında tanımlı olan değerlerdir. Örneğin ?op=Pos_Odeme gibi.
• Request içerisinde tanımladığınız değer ayrıca servisi çağırdığınız zaman kullanacağınız type değerini de temsil eder.
• Request dizininde ayrıca sevise istek atacağımız xml verisini hazırlayacak bir fonksiyon ekliyoruz. Bu fonksiyon Builder içerisinden hazırlanan parametreleri: XML içerisinde tanımlamış olduğumuz xml dosyasında belirtilen uygun yerlere koyarak ilgili request xml verisini hazırlayacaktır.
• Response içerisinde: Request içerisinde tanımlana endpoint ile aynı isimde bir fonksiton tanımlaması yapılacak. Bu fonksiyon servisten gelen xml verisinii parse edecek şekilde düzenlenecek.
• Ardından aşağıda bulunan örnek kodlara uygun olarak ilgili servis verileri çağrılabilir.

// Turn off error reporting
    error_reporting(0);
    
    require_once 'Config/index.php'; //Konfigirasyon tanımlamaları alınıyor
    require_once 'Request/Request.php'; //Request için xml hazırlayan class ekleniyor
    require_once 'Builder/Builder.php'; // İstek parametrelerini array olarak ayarlar
    
    $request = new Request();
    $builder = new Builder();
    
    $data = []; //Request parametrelerini saklıyor.
    
    /**
     * Aşağıdaki hazırlanacak yeni servisin çalıştırılmasın sağlayan fonksiyonların çağrılması şeklini içerir.
     */
    $parameters = $builder->BURAYA BUILDER İÇERİSİNDE TANIMLANAN FONKSİYON İSMİ GELECEK();
    
    //Servise gönderilecek olan xml içeriği hazırlanıyor
    $request_xml = $request->BURAYA REQUEST İÇERİSİNDE TANIMLANAN FONKSİYON İSMİ GELECEK($parameters);
    
    //Servis çağrılıyor ve Response verisi alınıyor
    $response = $request->sendRequest($request_xml, 'BURAYA REQUEST İÇERİSİNDE ENDPOINT İÇİN TANIMLANAN DEĞER GELECEK');
    

Dosyaları Buradan İndirebilirsiniz.

Kaynak : Ömer Faruk KESMEZ