MOBILEPAX XML PRODUCT API KULLANIM ŞEKLİ Versiyon: 1.0.4
URL Adresi http://merchant.mobilepax.com/services/product.aspx Gönderilen XML Yapısı MobilePaxProduct fonksiyonu buton bilgisi oluşturulacak ürünün bilgilerinin Mobilepax sistemlerine gönderilmesini sağlayan fonksiyondur. Bu metoda gerekli bilgiler gönderilerek ürün bilgisi tanımlanır ve ürün tanımlama işlemi başarılıysa geri dönüş değerinde yer alan codestring değeri ürüne ait buton kodunun oluşturulması için kullanılan ürüne ait tekil ID bilgisidir. Parametre değerlerinden productid bilgisi sisteminiz de tanımlı ürün bilgisine ait Id bilgisidir. Bu Id bilgisi sayesinde aynı ürünün bilgilerinde oluşan herhangi bir değişikliği, yine aynı productid bilgisi ile metodu çağırdığınızda bu sefer yeni ürün eklemek yerine ürün bilgisini güncelleyecektir. <?xml version="1.0" encoding="utf 8"?> <MobilePaxProduct> <username>string</username> <password>string</password> <productid>string</productid> <producttype>int</producttype> <productname>string</productname> <productcomment>string</productcomment> <price>double</price> <picture>string</picture> <successurl>string</successurl> <cancelurl>string</cancelurl> <smskeyword>string</smskeyword> <successsms>string</successsms> <confrmsms>string</confrmsms> </MobilePaxProduct> Örnek: <?xml version="1.0" encoding="utf 8"?> <MobilePaxProduct> <username>mbltm</username> <password>12345</password> <productid>7u6y5t</productid> <producttype>1</producttype> <productname>beyaz Mum</productName> <productcomment>kare beyaz mum</productcomment>
<price>10</price> <picture>www.mobiltim.com.tr/images/beyazmum.jpg</picture> <successurl>http://www.mobiltim.com.tr/success.asp</successurl> <cancelurl> http://www.mobiltim.com.tr/cancel.asp</cancelurl> <smskeyword>mbltm</smskeyword> <successsms>işleminiz başarıyla tamamlanmıştır. İşlem onay kodunuz #code# dur. </successsms> <confrmsms>x ürününü satın alma talebini onaylamak için ONAY yazıp 8044 e gönderiniz.</confrmsms> </MobilePaxProduct> Geri Dönüş XML Formatı <ReturnStatus> <Code>string</Code> <CodeString>string</CodeString> </ReturnStatus> Parametre Değerleri String username String password String productid API'leri kullanmak için gerekli Üye İş Yeri Kullanıcı Adı (merchant kodu) bilgisi API'leri kullanmak için gerekli Üye İş Yeri Parola Bilgisi Ürün için tarafınızda tanımlı Ürün ID bilgisidir ve her ürün için tek olmalıdır. Sistemde tanımlı ProductId bilgisi gönderilirse sistemdeki ProductId güncellenir. String producttype String productname String productcomment Double price String picture String successurl String cancelurl Ürün kategori bilgisi, bu bilgi Mobilepax tarafından verilecektir. Tanımlanacak ürün adı Ürün hakkında açıklama Ürün fiyat bilgisi; Geçerli formatlar 5 veya 5,25 gibi Ürün resim bilgisidir. Bilgi gönderilirken URL bilgisi olarak gönderilmelidir. ÖRN: http://images.mobilepax.com/button.png Başarılı ödeme geri dönüş URL adresi. Http ile başlamalıdır. İptal veya hatalı ödeme durumunda dönüş yapılacak URL Adresi. Http ile başlamalıdır.
String smskeyword String successsms String confrmsms SMS ile başlatmada kullanılacak anahtar kelime, her ürün için tek olmalıdır. Başarılı ödeme işlem mesajıdır. Müşteriye geri dönecek kodlar için #code# şekliden mesaj içerisinde belirtilmelidir. #code# alanı yoksa mesaj sonuna ürün onay kodu eklenir. Web üzerinden başlatılan herhangi bir satın almada kullanıcıya gönderilecek onay bilgilendirme mesajıdır. Mesaj metni içerisinde onaylama yöntemi belirtilmelidir. Buton Kullanım Şekli Ürün ekleme işlemi başarılıysa codestring alanında geri dönüş yapılan şifrelenmiş ürün bilgi kodu döner ve bu kod buton kullanımında gereklidir. İşlem hatalıysa hata kodu tablosuna bakınız. API ile eklenen ürünlerde geri dönüş olarak alınan Şifrelenmiş Ürün bilgisini html kodu üzerinde gerekli yerlere yerleştirerek özelleştirme yapılabilir. Kullanılan HTML kod parçası ve değiştirilecek yerler aşağıda belirtilmiştir. <script src='http://buy.mobilepax.com/js/mobilepax2.js' type='text/javascript' language='javascript'></script> <form action='http://buy.mobilepax.com/buy.aspx' onsubmit='return mobilepaxwin(this.target);' method='post'> <input type='hidden' name='productvalue' value='fb302ab0537e399f0ffe1e141b0301da' /> <input type='image' src='http://images.mobilepax.com/4df5d099 2198 4010 aea9 7f1183816dcc.png' style='border:none;' name='submit' alt='mobilepax ile ödeme yap' /> <img alt='' src='http://buy.mobilepax.com/x.aspx?x=fb302ab0537e399f0ffe1e141b0301da' width='0' /> </form> Ürün Kodu Değişimi; API ile ürünü ekleme işleminde elde edilen ürün kodu bilgisini ProductValue alanındaki value alanı ile değiştirmeniz yeterli olacaktır. <input type='hidden' name='productvalue' value='ürün Kodu' /> <img alt='' src='http://buy.mobilepax.com/x.aspx?x=ürünkodu' width='0' />
Satın Al Buton Değişimi; Aşağıdaki HTML kodu alanında yer alan SRC alanını web üzerinde yer alan bir Image dosyası ile değiştirebilirsiniz. Ayıca Alt Attribute bilgisi değiştirilerek text olarak çıkacak metin bilgisi ayarlanabilir. <input type='image' src='http://images.mobilepax.com/satinal.png' style='border:none;' name='submit' alt='mobilepax ile ödeme yap' /> Ödeme Bilgilerinin Geri Dönüşü Buton/SMS ile satın alma işleminde yapılan başarılı satın almaları firmaya bildirmek için basit bir sayfa yapılması gerekmektedir. Başarılı ödeme işlemi yapıldığında tarafımızca üretilen transaction (transactionid) bilgisi ve satıcı firmanın ürünü eklerken kullanmış olduğu Ürün Kodu (productid) bilgisi firmanın hazırlamış olduğu bu sayfaya post edilir ve firmadan satın almaya ait özel bir kod üretilir. Bu kod 8 haneli olmalıdır. Hatalı durumlarda boş bırakılmalıdır. Kod üretiminden sonra kullanıcı ürün eklemesi esnasında belirtilen başarılı geri dönüş URL adresine yönlendirilirken bu kod bilgisi ile birlikte dönülür. Hazırlamış olduğunuz bu sayfayı satın alma işlem sonuçlarını alabilmek için Mobilepax destek birimlerine iletmeniz gerekmektedir. Başarılı geri dönüş URL adresi her için farklı olabileceği gibi, satın alma sonuçlarının bildirileceği URL adresi her firma için tek olacaktır. Satıcı firma servis örneği string productid = Request.Form["productId"]; string transactionid = Request.Form["transactionId"]; string gsmno = Request.Form["gsmno"]; productid= Ürün tanımlaması yapılırken sisteme tanımlamış olduğunuz ürüne ait ID bilgisidir. transactionid= Başarılı ödeme işlemine ait satın alma ID sidir. gsmno= Satın alma yapılan GSM numarasıdır. Başarılı geri dönüşlerde, başarılı geri dönüş URL adresinin sonuna transactionid bilgisi eklenerek yönlendirme yapılır. Başarılı Geri dönüş URL : http://www.mobilepax.com/success.aspx Kullanıcının yönlendirildiği URL adresi : http://www.mobilepax.com/success.aspx?x=transactionid
SMS ile Başlatma Ödeme yapılacak GSM numarasından servis numarasına üye iş yerine smskeyword u ve ürün keyword bilgisi yazılarak mesaj gönderilir. Üye iş yeri smskeyword bilgisi üyelik aktivasyonu yapılırken Mobilepax destek birimleri tarafından verilir ancak ürünlere ait sms keywordleri ürün tanımlamaları yapılırken üye iş yeri tarafından belirtilir. Örnek: Firma SMSkeyword= Mobiltim ürün keywordu= test1 mobiltim test1 yazılarak 8044 e mesaj gönderilir. Mesaj gönderildikten sonra Mobilepax tarafından SMS gönderen son kullanıcıya onay mesajı döner. Bu onay mesajı üye iş yerinin ürünü eklerken belirtmiş olduğu mesaj metnidir. Müşteri gelen mesajı onaylayarak 8044 e geri dönüş yapar ve charging işlemi yapılır. Charging işlemi başarılı ise üye iş yerinden 8 karakterli onay mesajı alınır ve son kullanıcıya SMS olarak gönderilir.