Satıcının web sitesinde (veya mobil uygulamada) "Checkout" (Ödeme) butonuna basan her bir müşteride, siparişin başlatılabilmesi için LiveUpdate (LU) API kullanılarak bir HTTP POST https://secure.payu.com.tr/order/lu.php adresinde başlatılmalıdır. Bunun ardından müşteri, işlemi onaylamak üzere gerekli olan bilgileri girebileceği PayU ödeme sayfalarına yönlendirilir. LiveUpdate API ürün tabanlıdır, yani siparişler satıcı tarafından kendi ürün kodu (önerilen) aracılığıyla satıcının hesabında benzersiz bir şekilde tanımlanan en az bir ürün içermelidir. PayU sunucusu verileri aşağıdaki yapıda ve sırada beklemektedir: MERCHANT ORDER_REF Satıcının kimliği, Kontrol Panelinde (Hesap Yönetimi / Hesap Ayarları) mevcuttur. Satıcının sistemindeki sipariş referans numarası (kolay sipariş kimliği için). ORDER_DATE Siparişin sistemde başlatıldığı tarih, YYYY-AA-GG SS:DD:SS formatında (örn.: "2012-05-01 21:15:45"). ORDER_PNAME[] ORDER_PGROUP[] Ürün isimlerini içeren dizin (maksimum uzunluk: ürün ismi başına 155 karakter). Ürün gruplarının kimliklerini içeren dizin
ORDER_PCODE[] ORDER_PINFO[] ORDER_PRICE[] ORDER_QTY[] ORDER_VAT[] ORDER_PRICE_TYPE[] ORDER_SHIPPING PRICES_CURRENCY DISCOUNT DESTINATION_CITY DESTINATION_STATE PAY_METHOD Ürün kodlarını içeren dizin (maksimum uzunluk: ürün kodu başına 50 karakter). Aynı ürün kodu ile birden fazla ürünün gönderilecek olması halinde (aynı veya sonraki işlemlerde), PayU ilgili ORDER_PCODE ile ürünü güncelleyecektir (diğer bütün ürün bilgilerini (ismi, fiyatı, vergiler) üzerine yazarak). Ek ürün bilgilerini içeren dizin (opsiyonel, ürün ismi altında ödeme sayfalarında görüntülenir). Ürün fiyatlarını içeren dizin, pozitif sayı, ondalık ayırıcı olarak "." ile birlikte. Her bir ürünün miktarını içeren dizin. Siparişteki her bir ürün için KDV değerlerini içeren dizin. ORDER_PRICE[] kodunun KDV içerip içermediğini belirten dizin. Olası değerler: "BRÜT" (KDV dahil) ve "NET" (PayU tarafından KDV eklenecek). Parametre opsiyoneldir, ancak belirtilmemesi halinde varsayılan değer "NET" olacaktır. Siparişi ilişkin gönderim masrafları. Fiyatların, vergilerin, gönderim masraflarının ve indirimlerin ifade edildiği para birimi. Kabul edilen değerler: TRY, EUR, USD. Parametrenin belirtilmemesi halinde, varsayılan değer TRY olacaktır. *Fiyatların belirtildiği para birimi dışında bir para birimi ile işlem yapılacak olması halinde CURRENCY parametresini kullanınız. Siparişe ilişkin indirim değeri, pozitif sayı, ondalık ayırıcı olarak "." ile birlikte (opsiyonel). Siparişin teslimatının yapılacağı şehir (opsiyonel). Parametrenin belirtilmesi halinde, müşteri PayU ödeme sayfalarında bu değeri değiştiremeyecektir. Siparişin teslimatının yapılacağı eyalet (ülke) (opsiyonel). Parametrenin belirtilmesi halinde, müşteri PayU ödeme sayfalarında bu değeri değiştiremeyecektir. Doğrulamaya yönelik olası değerler, Kontrol Paneli içerisinde "State/Country List" altında mevcuttur. İşleme ait ödeme yöntemi (opsiyonel). Parametrenin belirtilmesi halinde, müşteri PayU ödeme sayfalarında bu değeri değiştiremeyecektir. Parametrenin belirtilmemesi halinde, hesapta aktif ödeme yöntemlerini içeren bir açılır liste görüntülenir. Olası değerler: CCVISAMC - VISA/MasterCard (varsayılan) INSTALLMENT_OPTIONS Taksitli ödeme seçenekleri "2,3,4,5,6,7,8,9,10,11,12" â tüm taksit seçenekleri gösterilir "2,3,7,10,12" - 2,3,7,10,12 taksit seçenekleri gösterilir "2"â 2 taksit olmak üzere tek bir taksit seçeneği gösterilir "," â hiçbir taksit seçeneği gösterilmez (taksit ve tek seferde ödeme bölümü gösterilmez) "" â Satıcı ayarları uygulanır ORDER_HASH Gönderilen veriye ilişkin HMAC_MD5 imzası. (HMAC, RFC 2104'de tanımlanmaktadır) TESTORDER TEST MODU'nda işlemleri başlatmak üzere kullanılan Boolean parametresi ("0" veya "1") (opsiyonel). Parametrenin aktif olması halinde, PayU ödeme formu test ödeme bilgileri ile doldurulur (herhangi bir kredi kartı test numarasına ihtiyacınız yoktur). DEBUG Uygulama sırasında PayU destek ekibinin yardımını gerektirmek üzere kullanılan Boolean parametresi ("0" veya "1") (opsiyonel). Parametrenin aktif olması halinde, sunucunuz ve PayU arasındaki iletişimin loglarını talep edebilirsiniz.
LANGUAGE Ödeme arayüzü için spesifik bir dil ayarlamanızı (ve coğrafi konuma göre tespit edilen dilin geçersiz kılınmasını) sağlar (opsiyonel). Olası değerler: TR - Türkçe EN İngilizce RO Romence HU Macarca RU Rusça DE Almanca FR - Fransızca IT İtalyanca ES - İspanyolca ORDER_TIMEOUT Siparişin verilebileceği süre aralığını ayarlar (opsiyonel, değer olarak saniye sayısını alır). TIMEOUT_URL ORDER_TIMEOUT süresinin dolması halinde, müşterinin yönlendirileceği URL'yi ayarlar (opsiyonel). Aşağıda belirtilen işlem bilgilerini kullanarak bir LiveUpdate talebi oluşturalım: Bilgi Parametre, değer(ler) ve uzunluk(lar) Genel Veriler MERCHANT="PAYUDEMO" (8) ORDER_REF="112457" (6) ORDER_DATE="2012-05-01 15:51:35" (19) Sepet İçeriği ORDER_PNAME[]="MacBook Air 13 inç", "iphone 4S" (19, 9) ORDER_PCODE[]="MBA13", "IP4S" (5, 4) ORDER_PINFO[]="Uzatılmış Garanti - 5 Yıl", "" (27, 0) ORDER_PRICE[]="1750", "400" (4, 3) ORDER_PRICE_TYPE[]="GROSS", "NET" (5, 3) ORDER_QTY[]="1", "2" (1, 1) ORDER_VAT[]="24", "24" (2, 2) ORDER_SHIPPING="50" (2) PRICES_CURRENCY="RON" (3) DISCOUNT="10" (2) DESTINATION_CITY="Bükreş" (10) DESTINATION_STATE="Bükreş - Sektör 1" (20) DESTINATION_COUNTRY="RO" (2) PAY_METHOD="CCVISAMC" (8) Ek Bilgiler TESTORDER="1" (HMAC MD5 imzasına dahil değildir) LANGUAGE="RO" (HMAC MD5 imzasına dahil değildir) Sipariş verildiği zaman bu bilgileri doğrulamak için, ORDER_HASH parametresinin değeri olarak bir HMAC MD5 imzası gerekir. Hesaplama, Kontrol Paneli altında Hesap Yönetimi / Hesap Ayarları bölümünde yer alan satıcı (veya demo) hesabının gizli anahtarı kullanılarak yapılır. İmza, başına eklenen ilgili uzunluklarla (UTF-8 bayt olarak) yukarıdaki her bir değerden oluşan bir dizi kullanılarak hesaplanır. Örnek sipariş olarak kullanılan bilgiler neticesinde elde edilen dizi aşağıdaki gibidir: 8PAYUDEMO6112457192012-05-01 15:51:3519MacBook Air 13 inç9iphone 4S5MBA134IP4S27Uzatılmış Garanti - 5 Yıl041750340011122242242503EUR2108Istanbul8Istanbul2TR8CCVISAMC5GROSS3NET112,3,7,10,12 İkinci ürün için ORDER_PINFO[] parametresinde herhangi bir değer bulunmadığına dikkat ediniz. Parametre tanımlanmış olduğundan, dizinin oluşturulması sırasında uzunluğunu (0) dikkate alacağız.
TESTORDER ve LANGUAGE parametreleri dizi oluşturmada ve HMAC MD5 hesaplamasında dikkate alınmamıştır. Veriler, her iki uçta da (sunucunuz ve PayU platformu) uzunlukların doğru bir şekilde hesaplanabilmesi için UTF-8 formatında aktarılmıştır. Satıcı hesabının gizli anahtarı P5@F8*3!m0+?^9s3&u8( ise, sonuç olarak meydana gelen HMAC MD5 (ve ORDER_HASH parametresi değeri): 83829ff075d5ba1f50c80df89b648ec4. Sonuç olarak ortaya çıkan LiveUpdate HTTP POST talebi: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 <form method="post" action="https://secure.payu.com.tr/order/lu.php"> <input type="hidden" name="merchant" value="payudemo"> <input type="hidden" name="order_ref" value="112457"> <input type="hidden" name="order_date" value="2012-05-01 15:51:35"> <input type="hidden" name="order_pname[]" value="macbook Air 13 inç"> <input type="hidden" name="order_pname[]" value="iphone 4S"> <input type="hidden" name="order_pcode[]" value="mba13"> <input type="hidden" name="order_pcode[]" value="ip4s"> <input type="hidden" name="order_pinfo[]" value="uzatılmış Garanti - 5 Yıl"> <input type="hidden" name="order_pinfo[]" value=""> <input type="hidden" name="order_price[]" value="1750"> <input type="hidden" name="order_price[]" value="400"> <input type="hidden" name="order_price_type[]" value="gross"> <input type="hidden" name="order_price_type[]" value="net"> <input type="hidden" name="order_qty[]" value="1"> <input type="hidden" name="order_qty[]" value="2"> <input type="hidden" name="order_vat[]" value="24"> <input type="hidden" name="order_vat[]" value="24"> <input type="hidden" name="order_shipping" value="50"> <input type="hidden" name="prices_currency" value="eur"> <input type="hidden" name="bill_fname" value="john"> <input type="hidden" name="bill_lname" value="doe"> <input type="hidden" name="bill_email" value="john@johndoe.com"> <input type="hidden" name="discount" value="10"> <input type="hidden" name="destination_city" value="istanbul"> <input type="hidden" name="destination_state" value="istanbul"> <input type="hidden" name="destination_country" value="tr"> <input type="hidden" name="pay_method" value="ccvisamc"> <input type="hidden" name="installment_options" value="2,3,7,10,12"> <input type="hidden" name="testorder" value="1"> <input type="hidden" name="language" value="ro"> <input type="hidden" name="order_hash" value="83829ff075d5ba1f50c80df89b648ec4"> <input type="submit" name="submit" value="gönder!"> </form> Satıcı mağazaları, yapılan LiveUpdate taleplerine fatura ve teslimat bilgilerini dahil etme imkanına sahiptir. Bu özellik, PayU ödeme sayfalarında gönderilen bilgilerin önceden doldurulmasını ve böylece müşterinin bu doldurma işlemiyle vakit kaybetmemesi avantajını sağlar. Fatura ve teslimat parametreleri HASH hesabı için opsiyoneldir, HMAC MD5 hesaplamasına dahil edilmez ve sadece talepte gönderilen değerler ödeme arayüzünde doldurulur. Bu alanların LiveUpdate e gönderilmesi zorunludur. Fatura Parametresi Açıklama Teslimat Parametresi Açıklama BILL_FNAME Müşteri adı DELIVERY_FNAME Müşteri adı BILL_LNAME Müşteri soyadı DELIVERY_LNAME Müşteri soyadı BILL_CISERIAL Nüfus Cüzdanı Seri Numarası (RO vatandaşları için) - - BILL_CINUMBER Nüfus Cüzdanı Numarası (RO vatandaşları için) - -
BILL_CIISSUER Nüfus Cüzdanını Veren Kurum (RO vatandaşları için) - - BILL_CNP Kişisel Kimlik Numarası (RO vatandaşları için) - - BILL_COMPANY Fatura için resmi şirket unvanı DELIVERY_COMPANY Teslimat için resmi şirket unvanı BILL_FISCALCODE Şirketin Vergi Numarası (CUI/VAT ID) - - BILL_REGNUMBER Şirketin Ticaret Sicildeki Sicil Numarası - - BILL_BANK Şirketin bankası - - BILL_BANKACCOUNT Şirketin banka hesabı - - BILL_EMAIL Müşteri e-mail adresi - - BILL_PHONE Telefon numarası DELIVERY_PHONE Telefon numarası BILL_FAX Faks numarası - - BILL_ADDRESS Müşteri/Şirket Adresi DELIVERY_ADDRESS Müşteri/Şirk et Adresi BILL_ADDRESS2 Müşteri/Şirket Adresi (ek alan) DELIVERY_ADDRESS2 Müşteri/Şirk et Adresi (ek alan) BILL_ZIPCODE Müşteri/Şirket Posta Kodu DELIVERY_ZIPCODE Müşteri/Şirk et Posta Kodu BILL_CITY Şehir DELIVERY_CITY Şehir BILL_STATE Eyalet/Ülke DELIVERY_STATE Eyalet/Ülke BILL_COUNTRYCODE Ülke Kodu (Romanya için RO) DELIVERY_COUNTRY CODE Ülke Kodu (Romanya için RO) NOT: DESTINATION_CITY, DESTINATION_STATE veya DESTINATION_COUNTRY parametrelerinin gönderilmesi halinde, bu bilgiler DELIVERY_CITY, DELIVERY_STATE, DELIVERY_COUNTRYCODE parametrelerine ait değerlerin üzerine yazılacaktır. Satıcılar, Kontrol Paneli altında Hesap Yönetimi / Ödeme Formu Ayarları bölümünde PayU sistemi aracılığıyla iletilecek olan kişisel veri miktarını yapılandırabilir. Müşteriyi doğrudan son ödeme adımına yönlendirmek istiyorsak, zorunlu olarak işaretlenen bilgilerin de LiveUpdate aracılığıyla gönderilmesi gerekmektedir. Alanların tamamının opsiyonel/gizli olarak ayarlanmış olması halinde, PayU dolandırıcılık önleme amacıyla asgari olarak şu alanları talep eder: BILL_FNAME, BILL_LNAME, BILL_EMAIL, BILL_PHONE ve BILL_COUNTRYCODE. BILL_PHONE alanını da boş bırakılabilir (bir satıcı olarak müşterilerin telefon numaralarını toplamıyorsanız/kullanmıyorsanız, değer olarak "-" (tire) kullanabilirsiniz). Siparişin son adımına yönlendirmek (örn. CCVISAMC için kart veri girişi) bu bilgiler LiveUpdate ile gönderilecekse, talep içerisinde "1" değerine sahip AUTOMODE bulunmalıdır. NOT: Bu parametre, gerekli tüm alanların gönderilmesi halinde düzgün bir şekilde çalışacaktır. Aksi takdirde, süreç fatura/teslimat verilerinin toplandığı sayfayla başlar. 1 <input type="hidden" name="automode" value="1"> Müşteriyi web sitesine geri yönlendirmek için (hesabına veya özelleştirilmiş bir teşekkür sayfasına), bir UTL ile birlikte BACK_REF parametresini kullanabilirsiniz. Varsayılan olarak BACK_REF yönlendirmesi, kullanılan ödeme yönteminin anında provizyon (örn. CCVISAMC ile yapılması halinde; normal WIRE transferi (havale) için olmaz) olması halinde yapılabilir. Aşağıda belirtildiği şekilde satıcı, bir sipariş veya müşteri kimlik tanıtıcı belirtebilmek için GET parametrelerini kullanabilir:
1 <input type="hidden" name="back_ref" value="http://domain.com/process.php?order=123456"> Yönlendirmenin PayU'dan geldiğinden emin olmak için, yönlendirmenin yapılacağı URL'ye bir kontrol değişkeni eklenir. Kontrol değişkeni (bir GET parametresi, ctrl) aynı zamanda URL'nin uzunluğunun (parametreler dahil) önüne eklenmesiyle PayU'nun yönlendirdiği URL'den (tüm parametrelerle birlikte) oluşan bir dizi üzerinde hesaplanan HMAC MD5'tir. http://www.yourdomain.com/process.php?order=123456&ctrl=741fcf35a297e256f4090c4dfc0ed652 ctrl HMAC MD5 hesaplaması için kaynak dizisi: 50http://www.yourdomain.com/process.php?order=123456 Hesabınız için etkinleştirilmiş olan birden fazla para birimi varsa, müşteriler ödeme yapacakları para birimini ödeme formunda seçebilirler. Siparişe ilişkin tahsilatları fiyatların ayarlanmış olduğu para biriminden (PRICES_CURRENCY) farklı bir para biriminde olmasını istiyorsanız, opsiyonel parametre gönderebilirsiniz: 1 <input type="hidden" name="currency" value="usd"> Verilerinizin gönderilmeye çalışılması sırasında hata alıyorsanız, her hata çeşidi için aşağıdaki listeden sorun açıklamalarına bakabilirsiniz: Hata ACCES DENIED (Erişim Engellendi) Invalid account (Geçersiz hesap) Access not permitted (Erişime izin verilmiyor) Invalid Data (Geçersiz veri) Invalid product code (Geçersiz ürün kodu) Invalid product name (Geçersiz ürün adı) Invalid product group (Geçersiz ürün grubu) Invalid price (Geçersiz fiyat) Invalid VAT (Geçersiz KDV) Invalid Price (Geçersiz Fiyat) Invalid Signature (Geçersiz İmza) Açıklama PayU arayüzüne erişmenize izin verilmemektedir. Lütfen PayU destek ekibi ile irtibata geçiniz. MERCHANT parametresi yanlış veya belirtilmemiş. LiveUpdate özelliğine erişiminiz kısıtlanmış. PayU Hesap Müdürünüz ile görüşmelisiniz. İletmiş olduğunuz veriler doğru bir biçimde oluşturulmamış. Lütfen dizinleri kontrol ediniz. ORDER_PCODE[] dizini hatalı oluşturulmuş. ORDER_PNAME[] dizini hatalı oluşturulmuş. ORDER_PGROUP[] dizini hatalı oluşturulmuş. ORDER_PRICE[] dizini hatalı oluşturulmuş. ORDER_VAT[] dizini hatalı oluşturulmuş. Hesaplanan toplam hatalı. DISCOUNT ve ORDER_SHIPPING parametrelerini kontrol ediniz. HMAC_MD5 imzası, gönderilen veri için hatalı hesaplanmıştır.
Yukarıda belirtilen tüm verileri içeren, PayU demo hesabında bir TEST işlemi başlatan ve hem AUTOMODE hem de BACK_REF özelliklerini kullanan bir talep aşağıda verilmektedir: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 <form method="post" action="https://secure.payu.com.tr/order/lu.php"> <input type="hidden" name="merchant" value="payudemo"> <input type="hidden" name="order_ref" value="112457"> <input type="hidden" name="order_date" value="2012-05-01 15:51:35"> <input type="hidden" name="order_pname[]" value="macbook Air 13 inç"> <input type="hidden" name="order_pname[]" value="iphone 4S"> <input type="hidden" name="order_pcode[]" value="mba13"> <input type="hidden" name="order_pcode[]" value="ip4s"> <input type="hidden" name="order_pinfo[]" value="uzatılmış Garanti- 5 Yıl"> <input type="hidden" name="order_pinfo[]" value=""> <input type="hidden" name="order_price[]" value="1750"> <input type="hidden" name="order_price[]" value="400"> <input type="hidden" name="order_price_type[]" value="gross"> <input type="hidden" name="order_price_type[]" value="net"> <input type="hidden" name="order_qty[]" value="1"> <input type="hidden" name="order_qty[]" value="2"> <input type="hidden" name="order_vat[]" value="24"> <input type="hidden" name="order_vat[]" value="24"> <input type="hidden" name="order_shipping" value="50"> <input type="hidden" name="prices_currency" value="eur"> <input type="hidden" name="discount" value="10"> <input type="hidden" name="destination_city" value="ankara"> <input type="hidden" name="destination_state" value="ankara"> <input type="hidden" name="destination_country" value="tr"> <input type="hidden" name="pay_method" value="ccvisamc"> <input type="hidden" name="installment_options" value="2,3,7,10,12"> <input type="hidden" name="bill_fname" value="test"> <input type="hidden" name="bill_fname" value="payu"> <input type="hidden" name="bill_email" value="test@payu.com"> <input type="hidden" name="bill_phone" value="0212021212"> <input type="hidden" name="bill_countrycode" value="tr"> <input type="hidden" name="delivery_fname" value="test"> <input type="hidden" name="delivery_lname" value="payu"> <input type="hidden" name="delivery_email" value="test@payu.com"> <input type="hidden" name="delivery_phone" value="0213031313"> <input type="hidden" name="delivery_countrycode" value="tr"> <input type="hidden" name="testorder" value="1"> <input type="hidden" name="automode" value="1"> <input type="hidden" name="back_ref" value="http://server.com/thankyou.php?order=112457"> <input type="hidden" name="language" value="tr"> <input type="hidden" name="order_hash" value="533b92f70542e3ec98ab290210e92329"> <input type="submit" name="submit" value="gönder!"> </form>
IPN, PayU sunucuları ve sunucularınız arasında bir bağlantı görevi görerek, online ödeme sisteminde provizyon verilmiş olan tüm siparişlerin otomatik olarak işleme alınmasını mümkün kılar. Bu bildirim yöntemi, kendi sipariş yönetim sisteminizde işlenmek üzere işlem verisinin alınmasını sağlar. Bir sipariş için provizyon ve onay verildiğinde, PayU sunucusu siparişle ilgili tüm bilgileri içeren bir veri yapısını sisteminizde daha önceden ayarlanmış olan bir URL ye gönderir. Veriler HTTP POST aracılığıyla gönderilir. Veriler ayıca bilgilerin doğrulanması için bir imza içerecektir. İmza, istenen veri seti üzerinde bir ortak PayU/Satıcı anahtarı ile bir HMAC_MD5 işlevi uygulayarak elde edilir (HMAC, RFC 2104 te tanımlanmaktadır). Gönderilen verilerin doğru olarak alınmasına ilişkin herhangi bir konfirmasyon olmaması halinde, PayU sunucusu geçerli bir yanıt alınana kadar birkaç dakikada bir HTTP POST göndermeyi denemeye devam eder. IPN iletişimi alıcının aktif bağlantısından bağımsızdır ve hiçbir şekilde alıcının oturumuna bağlanamaz. Gönderilen veriler aşağıdaki tabloda yer almaktadır:
SALEDATE Sipariş verme tarihi, formatı: Y-a-g S:d:s (2012-04-26 14:59:35) PAYMENTDATE Sipariş provizyon tarihi, formatı: Y-a-g S:d:s (2012-04-26 15:01:25) COMPLETE_DATE Sipariş tamamlanma tarihi, formatı: Y-a-g S:d:s (2012-04-26 15:02:28) REFNO REFNOEXT ORDERNO ORDERSTATUS Sipariş için global PayU referansı (maksimum uzunluk: 9 karakter) Sipariş için satıcı referans numarası (maksimum uzunluk: 100 karakter), Satıcı tarafından sağlanır Satıcı sipariş numarası (maksimum uzunluk: 6 karakter) Geçerli sipariş durumu. Olası değerler: PAYMENT_AUTHORIZED kart ödemesine provizyon verildi PAYMENT_RECEIVED havaleyle yapılan ödeme alındı TEST test siparişi CASH nakit ödemeli sipariş COMPLETE tamamlanan sipariş (provizyon verilmiş/teslim edilmiş) REVERSED iptal edilen sipariş REFUND ödemesi iade edilen sipariş (iade edilen ödeme) PAYMETHOD PAYMETHOD_CODE IPN_PAID_AMOUNT IPN_INSTALLMENTS_PROGRAM IPN_INSTALLMENTS_NUMBER IPN_INSTALLMENTS_PROFIT Kullanılan ödeme yöntemi (maksimum uzunluk: 40 karakter) Ödeme yöntemi kodu. Olası değerler: CCVISAMC Finansal maliyete birlikte toplam fiyat (tüm maliyetlerle birlikte ödeme tutarı) Ödeme kartının sadakat programı adı Müşteri tarafından seçilen taksit sayısı Ödemenin finansal maliyeti FIRSTNAME LASTNAME IDENTITY_NO IDENTITY_ISSUER IDENTITY_CNP COMPANY Adı (maksimum uzunluk: 40 karakter) Soyadı (maksimum uzunluk: 40 karakter) Müşteri nüfus cüzdanı seri numarası ve numarası (Seri Numarası/Numarası sadece Romanyalı müşteriler için mevcuttur) IDENTITY_NO Nüfus cüzdanını veren kurum Müşterinin kişisel vatandaşlık numarası, sadece Romanyalı müşteriler için mevcuttur. Bu alan sadece müşteriden bu bilgileri talep etme seçeneğini etkinleştirdiyseniz gösterilir. Şirket (maksimum uzunluk: 40 karakter) REGISTRATIONNUMBER Şirketin ticaret sicili sicil kayıt numarası (maksimum uzunluk: 40 karakter) FISCALCODE CBANKNAME CBANKACCOUNT ADDRESS1 ADDRESS2 CITY STATE ZIPCODE COUNTRY PHONE FAX CUSTOMEREMAIL Sicil Numarası / Veri Numarası (maksimum uzunluk: 40 karakter) Şirketin Bankası (maksimum uzunluk: 40 karakter) Şirketin Banka Hesabı (maksimum uzunluk: 50 karakter) Adres (maksimum uzunluk: 100 karakter) Ek Adres bilgisi (maksimum uzunluk: 100 karakter) Şehir (maksimum uzunluk: 30 karakter) Eyalet/Sektör/Ülke (maksimum uzunluk: 30 karakter) Posta Kodu (maksimum uzunluk: 20 karakter) Ülke (maksimum uzunluk: 50 karakter) Telefon Numarası (maksimum uzunluk: 40 karakter) Faks Numarası (maksimum uzunluk: 40 karakter) Müşteri e-mail adresi (maksimum uzunluk: 40 karakter)
FIRSTNAME_D LASTNAME_D COMPANY_D ADDRESS1_D ADDRESS2_D CITY_D STATE_D ZIPCODE_D COUNTRY_D PHONE_D IPADDRESS Adı (maksimum uzunluk: 40 karakter) Soyadı (maksimum uzunluk: 40 karakter) Şirket (maksimum uzunluk: 50 karakter) Adres (maksimum uzunluk: 100 karakter) Ek adres bilgileri (maksimum uzunluk: 100 karakter) Şehir (maksimum uzunluk: 30 karakter) Eyalet/Sektör/Ülke (maksimum uzunluk: 30 karakter) Posta Kodu (maksimum uzunluk: 20 karakter) Ülke (maksimum uzunluk: 50 karakter) Telefon numarası (maksimum uzunluk: 40 karakter) İstemci IP adresi (maksimum uzunluk: 250 karakter) CURRENCY IPN_PID[] IPN_PNAME[] IPN_PCODE[] IPN_INFO[] IPN_QTY[] IPN_PRICE[] IPN_VAT[] IPN_VER[] IPN_DISCOUNT[] IPN_PROMONAME[] Siparişin işleme alındığı para birimi. Olası değerler: TRY, USD, EUR PayU veritabanında sipariş edilen ürünlerin Kimlik Kodlarını içeren dizin (PayU referans) Ürün isimlerini içeren dizin Sistemde satıcı tarafından atanmış olan ürün kodlarını içeren dizin (satıcı referansı) Sipariş edilen her bir ürün için gönderilen ek bilgileri içeren dizin (PayU tarafından gönderilmişse) Ürün miktarlarını içeren dizin RON para biriminde, ondalık ayırıcı olarak nokta (.) ile ürün başına birim fiyatları (KDV siz) içeren dizin. TL para biriminde, ondalık ayırıcı olarak nokta (.) ile ürün başına KDV değerlerini içeren dizin. Ürün sürümlerini içeren dizin (maksimum uzunluk: 50 karakter) Bir promosyonda indirim yapılmış olan tutarları içeren dizin. KDV dahildir. Yukarıda belirtilen indirimlerin uygulandığı promosyonların isimlerini içeren dizin. IPN_DELIVEREDCODES[] PayU sözleşmesinin bu özelliği içermesi halinde, müşterilere gönderilen kodları içeren dizin. Dizindeki her öğe, sipariş edilen miktarın 1 den büyük olması halinde gönderilen her bir kod için ayırıcı olarak virgül (,) ile birlikte gösterilir. IPN_TOTAL[] IPN_TOTALGENERAL IPN_SHIPPING IPN_GLOBALDISCOUNT IPN_COMMISSION Ondalık ayırıcı olarak nokta (.) ile sipariş satırındaki kısmi toplam (KDV dahil) Ondalık ayırıcı olarak nokta (.) ile KDV ve gönderim masrafları dahil olmak üzere toplam işlem tutarı. Ondalık ayırıcı olarak nokta (.) ile TL para biriminde gönderim için hesaplanan tutar. Global sipariş indirimi. Bu alan opsiyoneldir ve sadece tutarın 0 dan (sıfır) büyük olması halinde gönderilir. Ondalık ayırıcı olarak nokta (.) ile PayU komisyonu (TL para biriminde) IPN_DATE IPN POST'un gönderim tarihi, formatı: YagSds (örn.: 20120426145935) HASH Talep imzası (yukarıdaki tüm alanlarda MD5 HMAC) PayU, aşağıdaki formatta (sayfanın herhangi bir yerinde) bir yanıt bekler: 1 <EPAYMENT>DATE HASH</EPAYMENT>
DATE HASH Yanıtın gönderildiği tarih, format: YagSds (örn.:20120426145935) Yanıt imzası (başlangıç alanları IPN_PID[0], IPN_PNAME[0], IPN_DATE de MD5 HMAC; DATE önceki alan) Yanıta ilişkin HMAC hesaplama alanları şöyledir: IPN_PID[0] Orijinal IPN mesajından yansıma ilk satın alınan ürünün kimliği IPN_PNAME[0] IPN_DATE DATE Orijinal IPN mesajından yansıma ilk satın alınan ürünün adı Orijinal IPN mesajından yansıma YagSds formatında (20120426145935) IPN tarihi YagSds formatında (20120426145935) yanıtın tarihi (sunucunuzun saati) Aşağıdaki bilgilere sahip olduğumuzu varsayıyoruz: Alan adı Uzunluk Alan değeri SALEDATE 19 2012-04-26 12:22:09 REFNO 7 1000037 REFNOEXT 0 ORDERNO 2 13 ORDERSTATUS 8 AUTHRECEIVE D PAYMETHOD 8 CCVISAMC FIRSTNAME 4 Test LASTNAME 4 PayU COMPANY 0 REGISTRATIONNUMBER 0 FISCALCODE 0 CBANKNAME 0 CBANKACCOUNT 0 ADDRESS1 14 Some Street 21 ADDRESS2 0 CITY 8 İstanbul STATE 8 İstanbul ZIPCODE 5 90210 COUNTRY 7 Türkiye PHONE 11 0268/121212 FAX 0 CUSTOMEREMAIL 13 test@payu.com FIRSTNAME_D 4 Test LASTNAME_D 4 PayU COMPANY_D 0 ADDRESS1_D 14 Some Street 21 ADDRESS2_D 0 CITY_D 6 Ankara STATE_D 6 Ankara ZIPCODE_D 5 90210 COUNTRY_D 6 Türkiye PHONE_D 11 0268/121212 IPADDRESS 6 node11 CURRENCY 3 TRY IPN_PID[0] 1 1
IPN_PNAME[0] 25 Apple MacBook Air 13 inç IPN_PCODE[0] 7 AMBA13I IPN_INFO[0] 0 IPN_QTY[0] 1 1 IPN_PRICE[0] 8 50000.00 IPN_VAT[0] 7 9500.00 IPN_VER[0] 0 IPN_DISCOUNT[0] 4 0.00 IPN_PROMONAME[0] 0 IPN_DELIVEREDCODES[0] 0 IPN_TOTAL[0] 8 59500.00 IPN_TOTALGENERAL 8 60095.00 IPN_SHIPPING 6 595.00 IPN_COMMISSION 4 0.00 IPN_DATE 14 2012042612343 4 IPN_PAID_AMOUNT 7 1223.29 IPN_INSTALLMENTS_PROGRAM 5 BONUS IPN_INSTALLMENTS_NUMBER 2 12 IPN_INSTALLMENTS_PROFIT 4 3.26 Yanıtın kaynak dizisi, aşağıdaki veriler kullanılarak oluşturulur: Alan adı Uzunluk Alan değeri IPN_PID[0] 1 1 IPN_PNAME[0] 25 Apple MacBook Air 13 inç IPN_DATE 14 20120426123434 DATE 14 20120426123434 Sonuç olarak ortaya çıkan dizi: 1125Apple MacBook Air 13 inç14201204261234341420120426123434 Doğrulama için HMAC_MD5 imzası: 5e7457bd605c5fdd80b038b8e2d9d1d9 HASH alan karakterleri küçük harf/büyük harf olabilir (onaltılık düzende dizi). Bildirimin gönderildiği sunucudan gelen yanıt şu şekilde olmalıdır: 1 <EPAYMENT>20120426123434 5e7457bd605c5fdd80b038b8e2d9d1d9</EPAYMENT> Yanıtın geçerli olmaması halinde, bildirim onaylanmaz. PayU otomatik olarak birkaç dakika içerisinde bildirimi yeniden gönderir. Güvenlik nedenlerinden dolayı, PayU bildirimlerini alan koda erişimin sadece 83.96.157.64/27 IP sınıfına izin verecek şekilde sınırlandırılmasını tavsiye etmekteyiz.
IPN bildirimleri üzerinde çalışmak veya test etmek için bir TEST siparişi verilmesini ( TESTORDER parametresi kullanılarak) tavsiye etmekteyiz. Bildirimi aldıktan sonra istediğiniz sayıda tekrar gönderebilirsiniz; PayU yönetici arayüzünde kullanılabilir filtreleri kullanarak Orders and reports bölümünde test siparişini bulun; sipariş ayrıntılarını içeren açılır menüyü açmak için siparişin referansına basın; bu açılır menüde Re-send notification linkine basın, Debug IPN? seçeneğini işaretleyin ve Continue butonuna basın. Bu şekilde, hem IPN talebinin içeriğini hem de kodunuzun yanıtını görebilirsiniz.
Anında Teslimat bildirimi, bu konfirmasyonları otomatik olarak PayU sunucusunda kaydeden PayU sistemine kendi sisteminizden otomatik teslimat konfirmasyonları gönderilmesini kolaylaştırır. PayU sisteminde verilen siparişleriniz konfirme edilir edilmez, konfirme edilecek olan işlem için kimlik verilerini içeren ve PayU tarafından sağlanan bir URL ye yönetim sisteminiz aracılığıyla bir POST gönderilmelidir. PayU sistemi içerisinde konfirme edilmesi gereken her bir sipariş için ayrı bir HTTP POST gerekmektedir. Tüm HTTP POST lar, POST da bulunan kimlik verilerine ve bir paylaşımlı anahtara (PayU / Satıcı) dayanan bir HMAC_MD5 imzası kullanılarak doğrulanacaktır. HTTP POST ta bulunan tanımlama verileri aşağıdaki tabloda anlatılmaktadır ve tam olarak aşağıdaki sırada gönderilmeleri gerekmektedir: Kod MERCHANT Açıklama PayU sistemindeki satıcı kodunu gösterir
ORDER_REF ORDER_AMOUNT ORDER_CURRENCY IDN_DATE PayU sistemindeki sipariş referans kodunu gösterir PayU sisteminde alınmış olduğu şekliyle, konfirme edilecek olan siparişin toplam tutarını gösterir Siparişin verildiği para birimini gösterir Teslimat konfirmasyonu talebinin iletildiği tarihi gösterir. <> formatına sahiptir. Burada: Y Yılı temsil eder. 4 haneli sayı. A Ayı temsil eder. 2 haneli sayı. G Günü temsil eder. 2 haneli sayı. S Saati temsil eder. Değerler 00 dan 24 e kadar. 2 haneli sayı. D Dakikayı temsil eder. 2 haneli sayı. S Saniyeyi temsil eder. 2 haneli sayı. ORDER_HASH REF_URL* Talep imzasını gösterir. Bu imza, yukarıdaki tüm alanlardan (1-5) oluşturulan bir HMAC_MD5 tipi imzadır. * Bu alan zorunlu değildir. Bu parametrenin gönderilmemesi veya boş olması halinde, yanıt INLINE gönderilecektir. GET yöntemiyle yanıtın gönderileceği URL adresini gösterir. URL adresi < > sözdizimi ile başlamalıdır. Teslimatın otomatik olarak konfirme edildiği URL: https://secure.payu.com.tr/order/idn.php Bu bölüm, HASH imzasının nasıl hesaplandığını göstermektedir. Giriş verisi örneği: Alan Adı Uzunluk Alan Değeri MERCHANT 4 Test ORDER_REF 7 1000500 ORDER_AMOUNT 4 1645 ORDER_CURRENCY 3 EUR IDN_DATE 19 2012-04-26 17:46:56 MAC hesaplamasına yönelik kaynak dizisi, alanın başında dizi uzunluğunu ekleyerek elde edilmektedir. Verilen giriş verisi ile kaynak dizisi şu şekilde oluşur: 4TEST71000500416453EUR192012-04-26 17:46:56 Bu örnekteki gizli anahtar: AABBCCDDEEFF Son MD5 değeri: 486ae8426384c66a6e175f5f8bafde6e PayU yanıtının INLINE (aynı sayfada) olacak şekilde ayarlanmış olması halinde, aşağıdaki formata sahiptir (sayfanın herhangi bir yerinde): 1 <EPAYMENT>ORDER_REF RESPONSE_CODE RESPONSE_MSG IDN_DATE ORDER_HASH</EPAYMENT>
PayU yanıtının belirli bir URL ye gönderilecek olması halinde (REF_URL parametresi geçerli bir URL içermektedir), yanıt aşağıda belirtildiği şekilde gönderilecektir: http://www.mysite.com/prel.php?order_ref=value&response_code=value&response_msg=value&idn_ DATE=value&ORDER_HASH=value Kod ORDER_REF RESPONSE_CODE RESPONSE_MSG IDN_DATE Açıklama PayU sipariş referansı olan orijinal IDN talebinden bir yansıma gösterir. Teslimat konfirmasyonu talebine ait yanıtın kodunu gösterir. Bu kodlar aşağıdaki tabloda açıklanmaktadır. Teslimat konfirmasyonu talebine ait mesajı göstermektedir. Bu kodlar aşağıdaki tabloda açıklanmaktadır. Teslimat konfirmasyonu talebinin iletildiği tarihi gösterir. <> formatına sahiptir. Burada: Y Yılı temsil eder. 4 haneli sayı. A Ayı temsil eder. 2 haneli sayı. G Günü temsil eder. 2 haneli sayı. S Saati temsil eder. Değerler 00 dan 24 e kadar. 2 haneli sayı. D Dakikayı temsil eder. 2 haneli sayı S Saniyeyi temsil eder. 2 haneli sayı. ORDER_HASH Talep imzasını gösterir. Bu imza, yukarıdaki tüm alanlardan (1-4) tam olarak aynı sırada oluşturulan bir HMAC_MD5 tipi imzadır. Yanıt kodlarının ve mesajlarının anlamları aşağıda gösterildiği gibidir: Yanıt Kodu Yanıt Mesajı 1 Konfirme edildi. 2 ORDER_REF eksik veya yanlış. 3 ORDER_AMOUNT eksik veya yanlış. 4 ORDER_CURRENCY eksik veya yanlış. 5 IDN_DATE doğru formatta değil. 6 Siparişin konfirme edilmesinde hata oluştu. 7 Sipariş daha önceden konfirme edilmiş. 8 Bilinmeyen hata. 9 Geçersiz ORDER_REF. 10 Geçersiz ORDER_AMOUNT. 11 Geçersiz ORDER_CURRENCY. Not: PayU dan geçersiz bir yanıt gelmesi halinde sipariş konfirme edilmez. HTTP POST talebine ait yanıt HASH imzası, aşağıdaki veriler kullanılarak hesaplanır: Alan Adı Uzunluk Alan Değeri ORDER_REF 7 1000500 RESPONSE_CODE 1 1 RESPONSE_MSG 9 Konfirme Edildi IDN_DATE 19 2012-04-26 17:46:58
HASH alanları, hem küçük harfli hem de büyük harfli karakterler içerebilirler (onaltılık düzende dizi). Dizi: 71000500119Confirmed192012-04-27 17:46:58 MD5 HASH Değeri: d317bb75d8f1d7fd203314914621c17c
Anında İptal/Geri Ödeme Bildirimi (IRN), PayU aracılığıyla ödemesi yapılan siparişler için doğrudan sipariş yönetimi uygulamasından/platformundan iptal/geri ödeme talepleri göndermeyi otomatikleştirmenizi mümkün kılar. İşlem, HMAC_MD5 ile doğrulanmış sipariş bilgilerinin HTTP POST aracılığıyla aşağıdaki URL ye gönderilmesini gerektirir: https://secure.payu.com.tr/order/irn.php Bu işlem bir siparişin iptalinin, ödenen tutarın kısmi veya tamamen geri ödenmesinin gerekli olduğu durumlarda uygulanmalıdır. PayU sunucusu, aşağıda belirtilen sıraya kesinlikle uyacak şekilde, aşağıdaki yapıda paketlenmiş olan veriler bekler: MERCHANT ORDER_REF ORDER_AMOUNT Satıcının kimliği. PayU yönetim arayüzünde Account administrator / Account Settings bölümlerinde mevcuttur. PayU sisteminde siparişe ait referans numarası. PayU tarafından alınmış olduğu şekilde iptal edilecek/geri ödenecek olan sipariş tutarı. ORDER_AMOUNT değeri ile gösterilen bu tutarın siparişin toplam tutarından az olması