Download the PHP package zeus/turkpos without Composer
On this page you can find all versions of the php package zeus/turkpos. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package turkpos
TURK Elektronik Para php sanal pos
!Ayrıntılı Döküman Destek dılo sürücü [email protected]
turkpos sanal pos entegre paketi
- Ödeme alabilir
- sorgulayabilir
- İptal edebilir
- ve diğer işlemler
Sınıflar!
- Soap
- Odeme
- TpOzelOranSkListe
- BinSanalPos
- TpDekontIslem
- TpDekontIslemGonder
- TpIslemIptalIade
- TpIslemOdeme
- TpIslemSorgulama
- TpOzelOranListele
- TpOzelOranSkGuncelle
- TpOzelOranSkListe
- TpMutabakatOzel
Sınıflarının kullanımı:
- listedeki sınıflarının kullanımı ilerde detaylıca ayrıntılı olarak açıklanacaktır
- web servisi apisine request edilen Soap sınıfı uygulamamızın çekirdekiğini oluşturmaktadır
Kurulumu
composer destekli paket psr-4 autoload standartllarına göre yazıldı
Başlangıç
Soap sınıfının methodları
- send()
- getResult()
- getSoapResultMethod()
- getAnyData()
- getSonucStr()
- getSonuc()
getSoapResultMethod methodan dönen başarılı ödeme işleminin sonucu
Soap sınıfının methodlarının kullanımları
Soap sınıfımız new keywordu build edelim
-
send
build edilen objecti arraya convert ederek turkpos sanal webservisine request eder
örnek kullanım
-
getResult
send methodu ile gönderilen requestin sonucu alır
örnek kullanım
method bize sonuç olarak aşağıdaki gibi bir çıktı üretir
-
getSoapResultMethod
getResult methodundan küçük bir farkı var bir key daha içeri girer getResult methodundan dönen datanın TP_Islem_OdemeResult sonucunu bize dönderir
örnek kullanım
örnek çıktı
dikkat ederseniz TP_Islem_OdemeResult keyi artık yok,
getSoapResultMethod data döndermediği durumda getResult methodu kullanılabilir ama genel olarak getSoapResultMethod tavsiye edilir-
getSonucStr
Bu methoda direk getSoapResultMethoddaki Sonuc stringini dönderir
örnek kullanım
` örnek çıktı
-
-
getSonuc
getSonucStr methodundan farklı olarak sayısal bir değer dönderir başarılı olması durumunda 1 aksi halde hatta kodunu dönderir
örnek kullanım
`
örnek çıktı
` aytrıntılı sayısal değerler ilerde liste olarak verilecektir
-
getAnyData
Hemen hemen en önemli methodlardan biridir ismi getAnyData olmasına rağmen herhangibir bil al anlamına gelmez,any keyini alır dönen datadan ayrıntılı dönen data any keyi ile alınır örnek BinSanalPos classını object edip soapın send methoduna gönderelim ve any keyini getAnyData ile alalım
`
getSoapResultMethod çıktısı
any keyini arraya convert etmemiz lazım o işte bunun için getAnyData() methodu kullanılır
örnek kullanım
işlemin başarılı çıktısı örnek
-
Config
Config classı static değişkenlere sahip olup bu sayede build edilmeden global olarak tüm projede bir kere tanımlanıp her yerde kullanılabilir
Config ayarları yapmak için gerekenler çok basit,her Turksanalpos işlemi için aşağıdaki işlemi configrationları yapmanız lazım Laravel gibi bir framewworkla çalışıyorsanız middleware ile sadece bir kere configation yaypıp tum controllerlara bind edebilirsiniz
Odeme
Ödeme işlemleri Odeme sınıfı ile yapılmaktadır,Odeme sınıfı başarılı olması durumunda sonuç olarak aşağıdaki gibi bir çıktı üretir
UCD_URL keyini alıp yönlendirme yapılarak 3d secure ile sms doğrulaması yapılarak ödeme alınır ,Odeme sınıfının örnek kullanımı
Bin Sanal pos
örnek kullanım
TpOzelOranListele
TpOzelOranListele sınıfının örnek kullanımı
TpOzelOranSkListe
TpOzelOranSkListe sınıfının örnek kullanımı
TpMutabakatOzel
TpMutabakatOzel sınıfının örnek kullanımı
TpIslemSorgulama
TpIslemSorgulama sınıfı yapılan işlemi sorgulama işlemi yapar örnek kullanımı
TpIslemIptalIade
TpIslemIptalIade sınıfı iptal iade işlemini yapar
örnek kullanımı
TpDekontIslem
TpDekontIslem sınıfının örnek kullanımı
TpDekontIslemGonder
TpDekontIslemGonder sınıfının örnek kullanımı
TpOzelOranSkGuncelle
örnek kullanım
AYRINTILI DOKUMAN
TURK ELEKTRONİK PARA A.Ş
Dış Kurum Entegrasyonları
TURKPOS API
Yardım Dokümanı
Sürüm 1.
1. SÜRÜM GEÇMİŞİ^
- Test ve gerçek ortam web servisleri ayrıldı.
- TP_Pre_Islem_Odeme metot isim değişikliği, parametre değişikliği yapıldı. TP_Islem_Odeme olarak çağrılacaktır.
- TP_Islem_Sorgulama metodu eklendi.
- TP_Islem_Iptal_Iade metodu eklendi.
- TP_Mutabakat_Ozet metodu eklendi.
- TP_Dekont_Islem metot ismi TP_Islem_Dekont_Gonder olarak değiştirildi.
- Şifreleme fonksiyonu eklendi. (SHA2B64)
- Hata kodları eklendi.
2. ÖZET
3. BAĞLANTI ADRESLERİ
3. 1. Gerçek Ortam
3.2. Test Ortamı
4. TANIMLAR
Firma : TURK Elektronik Para A.Ş.
5. METOTLAR
5. 1. TP_Ozel_Oran_Liste
5 .2. TP_Ozel_Oran_SK_Liste
Sonuç Parametreleri:
Örnek Sonuç Parametreleri:
5. 3. TP_Ozel_Oran_SK_Guncelle
Parametre Tip U Açıklama
G NS ST_WS_Guvenlik Nesnesi
Ozel_Oran_SK_ID L - Ozel_Oran_SK_Listeden dönen^ ID
değeri
GUID N 36 Üye İşyerine ait Anahtar
MO_1 N - Tek Çekim Oranı
MO_2 N - 2. Taksit Oranı
MO_3 N - 3. Taksit Oranı
MO_4 N - 4. Taksit Oranı
MO_5 N - 5. Taksit Oranı
MO_6 N - 6. Taksit Oranı
MO_7 N - 7. Taksit Oranı
MO_8 N - 8. Taksit Oranı
MO_9 N - 9. Taksit Oranı
MO_10 N - 10. Taksit Oranı
MO_11 N - 11. Taksit Oranı
MO_12 N - 12. Taksit Oranı
Sonuç Parametreleri:
Parametre Tip U Açıklama
Sonuc N - İşlem sonucu
Sonuc_Str N - İşlem sonuç açıklama
Örnek Sonuç Parametreleri:
5 .4. Ödeme Metotları
5.4.1. TP_Islem_Odeme
Ödeme işleminin başlatılacağı metottur. İşlem sonucu dönen 3D URL sine
yönlendirme yapılır ve kredi kartı ile ödeme işlemi başlar.
Test işlemi için Kredi kartı bilgileri:
Kart No:444444444444 4444
Son Kullanma Tarihi Ay Gün : 04 20
CVV : 444 giriniz.
İşlem Hash Değeri Hesaplama:
Bu servisin SHA2B64 metodu, parametresine gönderdiğiniz değer
sonucunda, bu değeri hashleyip Base64String e çevirir. Aşağıdaki örnekte
olduğu gibi, bu parametreleri yazılım dilinize uygun string birleştirme yöntemi
kullanarak birleştiriniz ve SHA2B64 metoduna gönderiniz. Elde ettiğiniz
sonuç Islem_Hash değeridir. Islem_Hash’i oluşturacak parametre
formatlarını, Gönderilecek Parametreler tablosuna bakarak oluşturunuz.
(Islem_Tutar’ın virgüllü olması gibi)
Dim Islem_Guvenlik_Str$ = CLIENT_CODE & GUID & SanalPOS_ID & Taksit &
Islem_Tutar & Toplam_Tutar & Siparis_ID & Hata_URL & Basarili_URL
<ST_Sonuc xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns="https://turkpos.com.tr/">
<Sonuc>1</Sonuc>
<Sonuc_Str>İşlem Başarılı</Sonuc_Str>
</ST_Sonuc>
Dim Islem_Hash$ = SHA2B64(Islem_Guvenlik_Str)
Komisyon Dahil Sipariş Tutarı Hesaplama
Komisyon Oran: TP_Ozel_Oran_SK_Liste metodundan seçilen taksitin
komisyon oranı
Islem_Tutar: Siparişinizin tutarı
Toplam_Tutar = Islem_Tutar + ((Islem_Tutar x Komisyon Oran) / 100)
şeklindedir.
Gönderilecek Parametreler:
Parametre Tip U Açıklama
G NS ST_WS_Guvenlik Nesnesi
SanalPOS_ID I 4
TP_Ozel_Oran_SK_Liste metodundan
müşteriye seçtirilen Kart Markasının
SanalPOS_ID değeri
GUID N 36 Üye İşyerine ait Anahtar
KK_Sahibi N 100 Kredi Kartı Sahibi
KK_No N 16 Kredi Kartı numarası
KK_SK_Ay N 2 2 hane Son Kullanma Ay
KK_SK_Yil N 4 4 haneli Son Kullanma Yıl
KK_CVC N 3 CVC Kodu
KK_Sahibi_GSM N 10
Kredi Kartı Sahibi GSM No, Başında 0
olmadan (5xxxxxxxxx)
Hata_URL N 256 Ödeme işlemi başarısız^ olursa
yönlenecek sayfa adresi
Basarili_URL N 256
Ödeme işlemi başarılı olursa
yönlenecek sayfa adresi
Siparis_ID N 50
Siparişe özel tekil ID. Bu değeri daha
önce gönderdiyseniz sistem yeni
Siparis_ID atar. İşlem sonucunda bu
Siparis_ID yi döner.
Siparis_Aciklama N 250 Siparişe ait açıklama
Taksit I 2 Seçilen Taksit Sayısı. Tek çekim için 1
gönderiniz.
Islem_Tutar N -
Sipariş Tutarı, (sadece virgüllü kuruş
formatında 1000,50)
Toplam_Tutar N -
Komisyon Dahil Sipariş Tutarı,
(sadece virgüllü kuruş formatında
1000,50)
Islem_Hash N - İşlem Hash Değeri
Islem_ID N -
İşleme ait Sipariş ID haricinde tekil
ID, opsiyoneldir.
IPAdr N 50 IP Adresi
Ref_URL N 256
Ödemenin gerçekleştiği sayfanın
URLsi
Data1 N 250 Extra Alan 1
Data2 N 250 Extra Alan 2
Data3 N 250 Extra Alan 3
Data4 N 250 Extra Alan 4
Data5 N 250 Extra Alan 5
Sonuç Parametreleri:
Parametre Tip U Açıklama
Sonuc N - İşlem sonucu
Sonuc_Str N - İşlem sonuç açıklama
Islem_ID L - SID Değeri
UCD_URL N - 3D URL si
Örnek Sonuç Parametreleri:
ST_TP_Islem_Odeme nesnesinden alacağınız Sonuc parametresi “0” dan
büyükse, 3D Güvenli Ödeme işlemini başlatmak için UCD_URL
parametresine yönlendirme yapınız. Kredi kartı ile ödeme işleminin başarılı
veya başarısız olma durumunda Hata_URL veya Basarili_URL değerlerine
POST sağlanır.
<ST_TP_Islem_Odeme xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns="https://turkpos.com.tr/">
<Islem_ID>1000611272</Islem_ID>
<UCD_URL>https://turkodeme.com.tr/Tahsilat/3D_Secure/
AkilliKart_3DPay_VKF. aspx?rURL=TURKPOS_3D_TRAN&SID= 1
</UCD_URL>
<Sonuc>1</Sonuc>
<Sonuc_Str>İşlem Başarılı</Sonuc_Str>
</ST_TP_Islem_Odeme>
POST Parametreleri:
Parametre Açıklama
TURKPOS_RETVAL_Sonuc Sonuç değeri
TURKPOS_RETVAL_Sonuc_Str Sonuç açıklaması
TURKPOS_RETVAL_GUID Üye İşyeri ait anahtarı
TURKPOS_RETVAL_Islem_Tarih İşlem Tarihi
TURKPOS_RETVAL_Dekont_ID Dekont Numarası
TURKPOS_RETVAL_Tahsilat_Tutari Müşteriden tahsil edilen tutar
TURKPOS_RETVAL_Odeme_Tutari
Net tutar. Tahsilat tutarından komisyon
tutarının çıkarılmış halidir.
TURKPOS_RETVAL_Siparis_ID Servise gönderdiğiniz işleme ait tekil
Siparis_ID
TURKPOS_RETVAL_Islem_ID Servise gönderdiğiniz Islem_ID
TURKPOS_RETVAL_Ext_Data
Metottaki Data1, Data2, Data3, Data4,
Data5 parametrelerinin “|” ile birleştirilmiş
hali döner.
Ext_Data = Data1 & "|" & Data2 & "|" &
Data3 & "|" & Data4 & "|" & Data
TURKPOS_RETVAL_Sonuc < 0 ise TURKPOS_RETVAL_Dekont_ID “0” döner.
TURKPOS_RETVAL_Dekont_ID değeri “0” dan büyük olduğu durumlarda kredi
kartından çekim işlemi tamamlanmış anlamına gelir.
5.4.2. KK_Saklama
Kredi kartı saklama işleminin yapıldığı metottur. TP_Islem_Odeme_WKS
metodu için KK_GUID değeri döner.
Gönderilecek Parametreler:
Parametre Tip U Açıklama
G NS ST_WS_Guvenlik Nesnesi
Kart_No N 16 Üye İşyerine ait Kart No
KK_Sahibi N 100 Kredi Kartı Sahibi
KK_No N 16 Kredi Kartı numarası
KK_SK_Ay N 2 2 hane Son Kullanma Ay
KK_SK_Yil N 4 4 haneli Son Kullanma Yıl
KK_CVC N 3 CVC Kodu
Data1 N 250 Extra Alan 1, Opsiyonel
Data2 N 250 Extra Alan 2, Opsiyonel
Data3 N 250 Extra Alan 3, Opsiyonel
Sonuç Parametreleri:
Parametre Tip U Açıklama
Sonuc N - İşlem sonucu
Sonuc_Str N - İşlem sonuç açıklama
GUID N - Kart Saklama Tekil GUID değeri
5.4.3. KK_Sakli_Liste
Saklı kartların listelendiği metottur.
Gönderilecek Parametreler:
Parametre Tip U Açıklama
G NS ST_WS_Guvenlik Nesnesi
Kart_No N 16 Üye İşyeri Kart No
KS_KK_Kisi_ID N 11
Kartı saklanacak kişinin T.C Kimlik
numarası veya kişiye ait 11 haneli
tekil değer. Opsiyoneldir.
Sonuç Parametreleri:
Parametre Tip U Açıklama
Sonuc N - İşlem sonucu
Sonuc_Str N - İşlem sonuç açıklama
ID N - Kart Saklama ID si
KK_GUID N - Kart Saklama GUID değeri
Tarih N - Saklama Tarihi
KK_No N - Kredi Kartı BIN Kodu
KK_Tip N - Kart Tipi
KK_Banka N - Kart Bankası
KK_Marka N - Kart Markası
5.4. 4. TP_Islem_Odeme_WKS
Kart saklamalı ödeme işleminin başlatılacağı metottur. İşlem sonucu dönen
3D URL sine yönlendirme yapılır ve kredi kartı ile ödeme işlemi başlar.
TP_Islem_Odeme metodundaki açıklamalar geçerli olmak kaydıyla
Gönderilecek Parametreler:
Parametre Tip U Açıklama
G NS ST_WS_Guvenlik Nesnesi
SanalPOS_ID I 4
TP_Ozel_Oran_SK_Liste metodundan
müşteriye seçtirilen Kart Markasının
SanalPOS_ID değeri
GUID N 36 Üye İşyerine ait Anahtar
KS_Kart_No N 100 Üye İşyeri Kart No
KK_GUID N 16
KK_Saklama metodundan dönen
GUID değeri
KK_Sahibi_GSM N 10
Kredi Kartı Sahibi GSM No, Başında 0
olmadan (5xxxxxxxxx)
Hata_URL N 250 Ödeme işlemi başarısız^ olursa
yönlenecek sayfa adresi
Basarili_URL N 250
Ödeme işlemi başarılı olursa
yönlenecek sayfa adresi
Siparis_ID N -
Siparişe özel tekil ID. Bu değeri daha
önce gönderdiyseniz sistem yeni
Siparis_ID atar. İşlem sonucunda bu
Siparis_ID yi döner.
Siparis_Aciklama N 250 Siparişe ait açıklama
Taksit I 2 Seçilen Taksit Sayısı. Tek çekim için 1
gönderiniz.
Islem_Tutar N -
Sipariş Tutarı, (sadece virgüllü kuruş
formatında 1000,50)
Toplam_Tutar N -
Komisyon Dahil Sipariş Tutarı,
(sadece virgüllü kuruş formatında
1000,50)
Islem_Hash N - İşlem Hash Değeri
Islem_Guvenlik_Tip N 2 NS (NonSecure) veya 3D gönderilir.
Islem_ID N -
İşleme ait Sipariş ID haricinde tekil
ID, opsiyoneldir.
IPAdr N 50 IP Adresi
Ref_URL N 256 Ödemenin gerçekleştiği sayfanın
URLsi
Data1 N 250 Extra Alan 1
Data2 N 250 Extra Alan 2
Data3 N 250 Extra Alan 3
Data4 N 250 Extra Alan 4
Data5 N 250 Extra Alan 5
Sonuç Parametreleri:
Parametre Tip U Açıklama
Sonuc N - İşlem sonucu
Sonuc_Str N - İşlem sonuç açıklama
Islem_ID L - SID Değeri
UCD_URL N - 3D URL si
Örnek Sonuç Parametreleri: 3D li işlemler için
ST_TP_Islem_Odeme_WKS nesnesinden alacağınız Sonuc parametresi “0” dan
büyükse, 3D Güvenli Ödeme işlemini başlatmak için UCD_URL
parametresine yönlendirme yapınız. Kredi kartı ile ödeme işleminin başarılı
veya başarısız olma durumunda Hata_URL veya Basarili_URL değerlerine
POST sağlanır.
POST Parametreleri:
Parametre Açıklama
TURKPOS_RETVAL_Sonuc Sonuç değeri
TURKPOS_RETVAL_Sonuc_Str Sonuç açıklaması
TURKPOS_RETVAL_GUID Üye İşyeri ait anahtarı
TURKPOS_RETVAL_Islem_Tarih İşlem Tarihi
TURKPOS_RETVAL_Dekont_ID Dekont Numarası
TURKPOS_RETVAL_Tahsilat_Tutari Müşteriden tahsil edilen tutar
TURKPOS_RETVAL_Odeme_Tutari
Net tutar. Tahsilat tutarından komisyon
tutarının çıkarılmış halidir.
TURKPOS_RETVAL_Siparis_ID Servise gönderdiğiniz işleme ait tekil
<ST_TP_Islem_Odeme xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns="https://turkpos.com.tr/">
<Islem_ID>1000611272</Islem_ID>
<UCD_URL>https://turkodeme.com.tr/Tahsilat/3D_Secure/
AkilliKart_3DPay_VKF. aspx?rURL=TURKPOS_3D_TRAN&SID= 1
</UCD_URL>
<Sonuc>1</Sonuc>
<Sonuc_Str>İşlem Başarılı</Sonuc_Str>
</ST_TP_Islem_Odeme>
Siparis_ID
TURKPOS_RETVAL_Islem_ID Servise gönderdiğiniz Islem_ID
TURKPOS_RETVAL_Ext_Data
Metottaki Data1, Data2, Data3, Data4,
Data5 parametrelerinin “|” ile birleştirilmiş
hali döner.
Ext_Data = Data1 & "|" & Data2 & "|" &
Data3 & "|" & Data4 & "|" & Data
TURKPOS_RETVAL_Sonuc < 0 ise TURKPOS_RETVAL_Dekont_ID “0” döner.
TURKPOS_RETVAL_Dekont_ID değeri “0” dan büyük olduğu durumlarda kredi
kartından çekim işlemi tamamlanmış anlamına gelir.
Örnek Sonuç Parametreleri: NonSecure işlemler için
Sonuc > 0 ise UCD_URL nin 'NONSECURE' eşitliği aranır. Eğer eşitse İşlem
sonlanır. Islem_ID değeri Dekont No değeridir.
Başarılı bir NonSecure işlemi için, Sonuc > 0, Islem_ID > 0 ve
UCD_URL='NONSECURE' olmalıdır. Aksi durumda işlem başarısızdır.
NONSECURE işlemin hatalı olması durumunda Sonuc_Str değer bankadan
gelen hata mesajını döner.
Eğer UCD_URL <> 'NONSECURE' ise 3D işlemi gibi ele alınır.
5. 5. TP_Islem_Sorgulama
İşlemin başarılı, başarısız, iptal veya iade durumunda olduğunu
öğrenebilirsiniz.
TP_Islem_Odeme metodu sonrasında, kredi kartı 3D şifre bilgilerinin
girilmesinin ardından işlemin başarılı veya başarısız olma durumuna göre,
Basarili_URL veya Hata_URL’ye POST sırasında bir hata oluştuğunda da bu
<ST_TP_Islem_Odeme>
<Islem_ID>1013521904</Islem_ID>
<UCD_URL>NONSECURE</UCD_URL>
<Sonuc>1</Sonuc>
<Sonuc_Str>İşlem Başarılı</Sonuc_Str>
</ST_TP_Islem_Odeme>
metot ile işlemin durumunu sorgulayabilirsiniz.
Gönderilecek Parametreler:
Parametre Tip U Açıklama
G NS - ST_WS_Guvenlik Nesnesi
GUID N 36 Üye İşyerine ait Anahtar
Dekont_ID L -
Başarılı işlem sonrası POST edilen
Dekont_ID, opsiyoneldir.
Siparis_ID N -
Başarılı işlem sonrası POST edilen
Sipariş ID
Islem_ID N -
TP_Islem_Odeme metoduna
gönderilen İşlem ID, opsiyoneldir.
Dekont_ID, Siparis_ID ve Islem_ID değerlerinden herhangi birini göndererek
işlem durumunu sorgulayabilrisiniz. Burada sadece Islem_ID ile sorgulama
yapmak isterseniz, siparişlerinizde tekil Islem_ID gönderdiğinize emin
olunuz.
Sonuç Parametreleri:
Parametre Tip U Açıklama
Sonuc N - İşlem sonucu
Sonuc_Str N - İşlem sonuç açıklama
Odeme_Sonuc N - Ödeme sonucu
Odeme_Sonuc_Aciklama N - Ödeme sonuç açıklama
Dekont_ID L -
Dekont Bilgisi, Başarısız ise “0” döner,
başarılı ise “0” dan büyük döner.
Siparis_ID N - Sipariş ID
Islem_ID N - Metoda gönderilen Islem_ID si
Toplam_Tutar M - Komisyon dahil Sipariş tutarı
Taksit I 2 Taksit bilgisi
Ext_Data N -
Ödeme Metodundaki Data1, Data2,
Data3, Data4, Data5 alanlarının “|” ile
birleştirilmiş hali döner.
Örnek Sonuç Parametreleri:
5. 6. TP_Mutabakat_Ozet
Belirli tarihleri arasındaki üye işyerinin işlemleri özet biçiminde alabilirsiniz.
Gönderilecek Parametreler:
Parametre Tip U Açıklama
G NS - ST_WS_Guvenlik Nesnesi
GUID N 36 Üye İşyerine ait Anahtar
Tarih_Bas N 20 Başlangıç Tarihi (dd.MM.yyyy
HH:mm:ss – 20.11.2015 00:00:00)
Tarih_Bit N 20
Bitiş Tarihi (dd.MM.yyyy HH:mm:ss –
20.11.2015 15:15:00)
Sonuç Parametreleri:
Parametre Tip U Açıklama
Sonuc N - İşlem sonucu
Sonuc_Str N - İşlem sonuç açıklama
Basarili_Islem_Sayi I - Başarılı işlem sayısı
Basarili_Islem_Toplam_Tutar M - Başarılı işlem toplam tutarı
Iptal_Islem_Sayi I - İptal işlem sayısı
Iptal_Islem_Toplam_Tutar M - İptal işlem toplam tutarı
Iade_Islem_Sayi I - İade işlem sayısı
Iade_Islem_Toplam_Tutar M - İade işlem toplam tutarı
<DT_Bilgi>
<DT_Islem_Sorgulama diffgr:id="DT_Islem_Sorgulama1" msdata:rowOrder="0">
<Odeme_Sonuc>1</Odeme_Sonuc>
<Odeme_Sonuc_Aciklama>İşlem Başarılı</Odeme_Sonuc_Aciklama>
<Tarih>17.11.2015 14:49:19</Tarih>
<Dekont_ID>1009834621</Dekont_ID>
<Siparis_ID />
<Islem_ID />
<Komisyon_Oran>1.7500</Komisyon_Oran>
<Komisyon_Tutar>1.7500</Komisyon_Tutar>
<Toplam_Tutar>1.0000</Toplam_Tutar>
<Taksit>1</Taksit>
<Ext_Data>||||</Ext_Data>
</DT_Islem_Sorgulama>
</DT_Bilgi>
<Sonuc>1</Sonuc>
<Sonuc_Str>Başarılı</Sonuc_Str>
Örnek Sonuç Parametreleri:
5. 7. TP_Islem_Iptal_Iade_Kismi
Başarılı bir kredi kartı işleminin iptal veya iadesini yapmak için kullanılır.
Gönderilecek Parametreler:
Parametre Tip U Açıklama
G NS - ST_WS_Guvenlik Nesnesi
GUID N 36 Üye İşyerine ait Anahtar
Durum N 10
İptal için IPTAL
İade için IADE
Dekont_ID L - İşlemin Dekont ID si
Tutar M -
İptal/İade Tutarı, IPTAL için tüm tutar
yazılmalıdır. IADE için tüm tutar veya
daha küçük tutar (kısmi) yazılmalıdır.
Sonuç Parametreleri:
Parametre Tip U Açıklama
Sonuc N - İşlem sonucu
Sonuc_Str N - İşlem sonuç açıklama
Örnek Sonuç Parametreleri
5. 8. TP_Islem_Dekont_Gonder
Dekontun eposta olarak gönderilmesini sağlar.
<DT_Bilgi>
<DT_Mutabakat_Ozet diffgr:id="DT_Mutabakat_Ozet1" msdata:rowOrder="0">
<Basarili_Islem_Sayi>0</Basarili_Islem_Sayi>
<Basarili_Islem_Toplam_Tutar>0.0000</Basarili_Islem_Toplam_Tutar>
<Iptal_Islem_Sayi>0</Iptal_Islem_Sayi>
<Iptal_Islem_Toplam_Tutar>0.0000</Iptal_Islem_Toplam_Tutar>
<Iade_Islem_Sayi>0</Iade_Islem_Sayi>
<Iade_Islem_Toplam_Tutar>0.0000</Iade_Islem_Toplam_Tutar>
</DT_Mutabakat_Ozet>
</DT_Bilgi>
<Sonuc>1</Sonuc>
<Sonuc_Str>Başarılı</Sonuc_Str>
<ST_Sonuc xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns="https://turkpos.com.tr/">
<Sonuc>1</Sonuc>
<Sonuc_Str>İşlem Başarılı</Sonuc_Str>
</ST_Sonuc>
Gönderilecek Parametreler:
Parametre Tip U Açıklama
G NS - ST_WS_Guvenlik Nesnesi
GUID N 36 Üye İşyerine ait Anahtar
Dekont_ID L - İşlemin Dekont ID si
E_Posta N 100 Kişi e-posta adresi
Sonuç Parametreleri:
Parametre Tip U Açıklama
Sonuc N - İşlem sonucu
Sonuc_Str N - İşlem sonuç açıklama
5. 9. SHA2B
Şifreli veri üretmek için kullanılır.
Gönderilecek Parametreler:
Parametre Tip U Açıklama
Data N - Şifrelenecek Veri
Sonuç Parametreleri:
Parametre Tip U Açıklama
Sonuc N - İşlem sonucu^
5. 10. BIN_SanalPos
Sistemde kayıtlı bin kodlarını ve işlem yapılabilecek SanalPOS_ID bilgisini
öğrenebilirsiniz. Bilgilendirme amaçlıdır.
Gönderilecek Parametreler:
Parametre Tip U Açıklama
G NS - ST_WS_Guvenlik Nesnesi
BIN N 6
Boş bırakılırsa tüm BIN kodları
döner. Dolu gönderilişe o BIN
koduna ait bilgiler döner.
Sonuç Parametreleri:
Parametre Tip U Açıklama
Sonuc N - İşlem sonucu
BIN N - Kredi Kartı BIN kodu
Kart_Banka N - Kredi Kartı Bankası
DKK I -
1 ise Diğer Kredi Kartı SanalPos_ID si
kullanılır
0 ise BIN, Sanal POS uyumu var. Kart
markasına ait SanalPOS_ID den çekim
yapılır.
6. HATA KODLARI
Servislere gerçek ortamda HTTPS protokolü üzerinden erişilecektir. İşlemlerin
gerçekleşmesi için kurum internet çıkış IP adresi veya IP Blokları, web sitesi
adresi iletilmeli ve tarafımızdan gerekli tanımlar yapılmalıdır.
Kodu Açıklama
1 Başarılı
-
1 Başarısız
- 100 Hesap bulunamadı.
- 101 Güvenlik hatası.
- 102 İşlem Hash geçersiz.
- 103 GUID uzunluğu geçersiz.
- 104 Siparis_ID en fazla 36 karakter olabilir.
- 105 Kredi kartı CVV uzunluğu geçersiz. 3 hane olmalıdır.
- 106 Kredi kartı yıl uzunluğu geçersiz.
- 107 Kredi kartı son kullanma ay uzunluğu geçersiz.
- 108 Müşteri GSM no geçersiz.
- 109 SanalPOS_ID uzunluğu geçersiz.
- 110 Taksit geçersiz.
- 111 IP formatı geçersiz.
- 112
Tutar formatı geçersiz. Nokta kullanmayınız. Kuruş formatında virgüllü
gönderiniz.
- 113 Tutar, 0 dan küçük veya eşit olmamalıdır.
- 114 Test kullanıcısı ile işlem yapılamaz.
- 115 Tutar formatı geçersiz. Virgülden sonra 2 basamak şeklinde olmalıdır.
- 116 Başarılı URL veya Hata URL boş olamaz.
- 117 GSM No numeric olmalıdır.
- 118 Kredi Kartı No uzunluğu geçersiz.
- 119 Kredi Kart No formatı hatalı.
- 120 Tarih formatı hatalı.
- 121 Kredi Kartı sahibi bilgisini eksiksiz giriniz.
- 200 Komisyon bilgisi bulunamadı.
- 201 SanalPOS_ID ye ait taksit geçersiz.
- 202 Toplam tutara eklenen komisyon hatalı.
- 203 Kesilecek komisyon bilgisi hesaplanırken hata oluştu.
- 204 SanalPOS Tipi hatalı.
- 205 Ödeme bilgileri kayıt edilirken hata oluştu. İşlemi tekrarlayınız.
- 206 Sanal POS İşlemi kaydedilemedi.
- 207 Sistem Hatası
- 208 SanalPOS Tipi veya Kart No bulunamadı.
- 209 İşlem bilgisi bulunamadı.
- 210 İptal/İadeye uygun işlem bulunamadı.
- 211 İşlem iptal durumunda.
- 212 İşlem iade durumunda.
- 213 İade olabilecek işlem İptal edilmek isteniyor.
- 214 İptal olabilecek işlem İade edilmek isteniyor.
- 215
SanalPOS_ID ile Kredi Kartı BIN kodu uyumsuz. Kredi Kartı markasına göre
yanlış SanalPOS_ID seçiliyor.
- 216 GUID ile Güvenlik nesnesi eşleşmiyor.
- 217 İptal veya İade edilecek Tutar, işlem tutarından büyük olamaz.
- 218 İptal edilecek işlemin için Tutar hatalı.
- 219 Durum parametresi boş olamaz. IPTAL veya IADE gönderiniz.
- 220 Debit Kart ile taksitli işlem yapılamaz.
- 221 İade Tutarı, İade Edilebilir Tutar’dan büyük olamaz.
- 222 Tarih aralığı 7 günden fazla olamaz.
- 223 Test kredi kartı ile gerçek ortamda işlem yapılamaz.
- 300 Kart saklama yapılamadı.
- 301 Kart çözümleme başarısız.
7. GÜVENLİK
Servislere gerçek ortamda HTTPS protokolü üzerinden erişilecektir. İşlemlerin
gerçekleşmesi için kurum internet çıkış IP adresi veya IP Blokları, web sitesi
adresi iletilmeli ve tarafımızdan gerekli tanımlar yapılmalıdır.