MOBILEPAX SOAP PRODUCT API KULLANIM ŞEKLİ Versiyon: 1.0.4
URL http://merchant.mobilepax.com/services/product.asmx Metot MobilePaxProduct fonksiyonu buton bilgisi oluşturulacak ürünün bilgilerinin Mobilepax sistemlerine gönderilmesini sağlayan fonksiyondur. Bu method a 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 message 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 methodu çağırdığınızda bu sefer yeni ürün eklemek yerine ürün bilgisini güncelleyecektir. [WebMethod] public ReturnValue MobilePaxProduct(string username,string password, string productid,int producttype,string productname,string productcomment,double price,string picture,string successurl,string cancelurl,string smskeyword,string successsms,string confrmsms) SOAP Örneği <?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> <MobilePaxProduct xmlns="http://tempuri.org/"> <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> </soap:body> </soap:envelope> Parametre Değerleri String username String password String productid String producttype String productname String productcomment Double price String picture String successsurl String cancelurl String smskeyword String successsms String confrmsms Mobilepax için tanımlı Üye İş Yeri Kod bilgisi Üye İş Yeri Kodu ile tanımlanmış, API'leri kullanmak için gerekli parola bilgisi Ürün için tarafınızda tanımlı Ürün ID bilgisi Ü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 İptal veya hatalı ödeme durumunda dönüş yapılacak URL Adresi 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. Web üzerinden başlatılan herhangi bir satın almada, kullanıcıya gönderilecek onay bilgilendirme mesajıdır. Geri Dönüş Değeri <?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> <MobilePaxProductResponse xmlns="http://tempuri.org/"> <MobilePaxProductResult> <code>string</code> <message>string</message> </MobilePaxProductResult> </MobilePaxProductResponse> </soap:body> </soap:envelope> Buton Kullanım Şekli Ürün ekleme işlemi başarılıysa message 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' /> 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 Ö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