Ortak Ödeme / iFrame

  • Ortak Ödeme
  • iFrame

Ortak ödeme sayfası ile ödeme linki oluşturup bir arayüz üzerinden müşterilerinizden ödeme alabilirsiniz. Ödeme arayüzünü oluşturabilmek için To_Pre_Encrypting_OOS servisini çalıştırdığınızda response’ta result object içinde string bir değer dönmektedir.

Bu string değeri test ortamı için https://test-pos.param.com.tr/default.aspx?s= linkine,
Prod ortam için https://pos.param.com.tr/Tahsilat/Default.aspx?s= linkine ekleyerek ortak ödeme sayfasını oluşturabilirsiniz.

Ödeme işlemi yapıldıktan sonra ödeme sonucu Return_URL parametresindeki belirtiğiniz adrese post olarak gönderilir.

Test işlemleri sırasında test kartlarımızı kullanabilirsiniz.

Parametre Zorunlu Tip Uzunluk Açıklama
G Evet Nesne - ST_WS_Guvenlik Nesnesi
GUID Evet String İŞubeden alınacak GUID değeri
Borclu_Kisi_TC Hayır String 11 Ödeme yapacak kişinin T.C. Kimlik Numarası, opsiyoneldir, boş geçilebilir
Borclu_Aciklama Evet String 200 Ödenecek tutara ilişkin açıklama. Bu alan editable olsun istiyorsanız başına “e|”, readonly olsun istiyorsanız başına “r|” eklemelisiniz.
Borclu_Tutar Evet String Alınacak Tutar.
Borclu_GSM Hayır String 10 Telefon numarası
Borclu_Odeme_Tip Evet String Default “Diğer” geçebilirsiniz. Bu alan editable olsun istiyorsanız başına “e|”, readonly olsun istiyorsanız başına “r|” eklemelisiniz.
Borclu_AdSoyad Evet String 100 Ödeme yapacak kişinin adı ve soyadı. Bu alan editable olsun istiyorsanız başına “e|”, readonly olsun istiyorsanız başına “r|” eklemelisiniz.
Return_URL Evet String Ödeme sonrası sonucu geri dönmek için URL bilgisi
Islem_ID Evet String Ödeme işlemine ilişkin sisteminizde kayıtlı ödeme yapılacak avukata ait benzersiz ID veya Key.
Taksit Evet Integer 1 = 0 ise tüm taksitler listelenir. > 0 ise sadece o taksit seçeneği listelenir.
Terminal_ID Evet Integer 5 Tarafımızdan verilecek olan terminal numarası
Parametre Tip Uzunluk Açıklama
TO_Pre_Encrypting_OOSResult String -
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<TO_Pre_Encrypting_OOS xmlns="https://turkodeme.com.tr/">
<G>
<CLIENT_CODE>10738</CLIENT_CODE>
<CLIENT_USERNAME>Test</CLIENT_USERNAME>
<CLIENT_PASSWORD>Test</CLIENT_PASSWORD>
</G>
<GUID>0C13D406-873B-403B-9C09-A5766840D98C</GUID>
<Borclu_Kisi_TC></Borclu_Kisi_TC>
<Borclu_Aciklama>r|açıklama</Borclu_Aciklama>
<Borclu_Tutar>r|10,00</Borclu_Tutar>
<Borclu_GSM>r|5555555555</Borclu_GSM>
<Borclu_Odeme_Tip>r|</Borclu_Odeme_Tip>
<Borclu_AdSoyad>test</Borclu_AdSoyad>
<Return_URL>r|https://dev.param.com.tr/tr</Return_URL>
<Islem_ID>202220</Islem_ID>
<Terminal_ID>10738</Terminal_ID>
<Taksit>1</Taksit>
</TO_Pre_Encrypting_OOS>
</soap:Body>
</soap:Envelope>
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<soap:Header>
<ServiceSecuritySoapHeader xmlns="https://turkodeme.com.tr/">
<CLIENT_CODE>10738</CLIENT_CODE>
<CLIENT_USERNAME>Test</CLIENT_USERNAME>
<CLIENT_PASSWORD>Test</CLIENT_PASSWORD>
</ServiceSecuritySoapHeader>
</soap:Header>
<soap:Body>
<TO_Pre_Encrypting_OOSResponse xmlns="https://turkodeme.com.tr/">
<TO_Pre_Encrypting_OOSResult>ImBuIu4mlRqIABImnjl/ikGHMe5ZOjZjP3wx61Wa7FxC3Xrjn
DTCsn7PngJ8DPdEV840PmqT+jVgsm+KaWcIZQq/lcJQKD3TdM99+MUcOKLxxFyByUJP3DkY9zZ4/2TJ7Px2HzZdf
ccockhMooHuM+A8PxjHKdK8z4pOvW/tpo/U4i6/jJPT9ZnhHL4GdRNOtu9l6sGtPHeKYC/FHYAZpGNXjR9+RCZGP
/xTeFgC+Gl1o7dpRZaibII6PdPK1CNMdF8O1d1QI+PDCq/TxDSQxyyJgqovzYfBHT5mWjOx+WhiajrswNzVirR9h
pii+Hq3sk+LnH90Psobh5db3F4BPpgUIuS6moVERKgq5HIhLkR4fe5TMfxcvOhj3Pg0RBQR
</TO_Pre_Encrypting_OOSResult>
</TO_Pre_Encrypting_OOSResponse>
</soap:Body>
</soap:Envelope>

iFrame ile ödeme almak için TP_Modal_Payment servisini çalıştırdığınızda response’ta iFrame linki dönmektedir. İlgili link ile iFrame sayfasına yönlenebilirsiniz.

Ödeme işlemi yapıldıktan sonra, işlem sonucu Callback_URL parametresindeki belirtiğiniz adrese post olarak gönderilir.

Test işlemleri sırasında test kartlarımızı kullanabilirsiniz.

Parametre Zorunlu Tip Uzunluk Açıklama
Code Evet Integer 5 Terminal ID, tarafımızdan iletilecektir.
User Evet String Kullanıcı Adı, tarafımızdan iletilecektir.
Pass Hayır String Şifre, tarafımızdan iletilecektir.
GUID Evet String 36 Üye işyerine ait anahtar
GSM Evet String 10 Müşteri GSM No
Amount Evet String Tutar
Order_ID Evet String 36 Sipariş numarası
TransactionId Hayır String 36 İşleme ait Sipariş ID haricinde tekil ID opsiyoneldir.
Callback_URL Evet String 250 Ödeme işlemi başarılı/başarısız olursa işlem sonucunun post edileceği sayfa adresi
installment Evet Integer 2 Taksit sayısı, Tüm taksitler veya sadece o taksit sayısı ekranda gösterilmek isteniyorsa 0 ‘dan büyük bir değer girilmelidir. 0 : Tüm taksitleri gösterir >0 ise o taksit seçeneğini gösterir
MaxInstallment Evet Integer 2 Ekranda gösterilecek maximum taksit sayısını gösterir, Örneğin 6 yazılır ise 6 taksite kadar olan taksit seçeneklerini ekranda gösterir. 0 : Tüm taksitleri gösterir >0 ise o taksite kadar olan taksit seçeneklerini gösterir
Parametre Tip Uzunluk Açıklama
ResultCode Integer Sonuç kodu 0’dan büyük bir değer döner ise işlem başarılıdır ve URL bilgisi döner. Diğer durumlarda işlem başarısızdır.
ResultDescription String Sonuç açıklaması, İşlem başarısız olduğu durumlarda hata mesajı döner.
URL String Iframe/Modal içerisinde açılacak URL bilgisi döner
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<TP_Modal_Payment xmlns="https://turkpos.com.tr/">
<d>
<Code>10738</Code>
<User>test</User>
<Pass>test</Pass>
<GUID>0C13D406-873B-403B-9C09-A5766840D98C</GUID>
<GSM></GSM>
<Amount>r|100,00</Amount>
<Order_ID>r|Iframe002221355</Order_ID>
<TransactionId>r|IframeTransaction0021255</TransactionId>
<Callback_URL>r|https://webhook.site/606c70fc-18c7-4adc-a523-ce4d7f732365</Callback_URL>
<MaxInstallment>r|12</MaxInstallment>
</d>
</TP_Modal_Payment> </soap:Body> </soap:Envelope>
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<soap:Body>
<TP_Modal_PaymentResponse xmlns="https://turkpos.com.tr/">
<TP_Modal_PaymentResult>
<ResultCode>1</ResultCode>
<ResultDescription>Success</ResultDescription>
<URL>https://test-pos-mp.param.com.tr/Payment.aspx?token=Jj5cYWP+RX09ODuh8wrVSltngR7p5NSncBmWjxwifCaGXA5Yh7IAGY
LfhBhNbaqBz3+gGHOZcZq5ZSGeM9SX3qtpv/NpXVXS1xeRXyutBUi4/B0yx4oWiQwoE5VOMnqstRzZ0KS2tNTuJVnjPnK7mA5XhR+3Wa4fWWxZi9sm2Tvo
nJ/7p/kvaakJI94ePujcLvwM67AT595m1uAA4F1g4NsKmtRwVndXwdkeQIhj0vA0HS89sYIQigtvTuQIiQ6tc3YE4FWTFoPrU8e96NBaO6eGkBvYtSROcN
+E5Jco4ClPLN7zNT5A+XLLptMA+34JmiYBDpZP63kolmxhdivGfiCxK8MU1rznRGDXVPsciW8SzjjbN9A4v5K1SgtLFjoGdYyxj3olNVT3PftWj4iDmhIkm
xoEvjE5bN985SeUunEC5tYo2Hb6qg+935mohgVjZVz1gnh+MeYrBWcMwtaEnzvXnvrW3aa2NeF44ePIUVUIBMtcRCtymrHpHrEbs+u/0rLLf+FcpFQZx+wj
JWl0/g==</URL>
</TP_Modal_PaymentResult>
</TP_Modal_PaymentResponse>
</soap:Body>
</soap:Envelope>