mobılepax xml product apı kullanım şekli

Transkript

MOBILEPAX
XML PRODUCT API
KULLANIM ŞEKLİ
Versiyon: 1.0.4
Adres
: Bağlarbaşı Mh. Ergenekon Sk.
Çakmak Plaza N:6 Maltepe İstanbul
Telefon : 0216 305 1 888
Faks
: 0216 305 2 522
Web Site : www.detaytelekom.com
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> Adres
Telefon : 0216 305 1 888
Faks
: 0216 305 2 522
<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 API'leri kullanmak için gerekli Üye İş Yeri Kullanıcı Adı (merchant kodu) bilgisi String password API'leri kullanmak için gerekli Üye İş Yeri Parola Bilgisi String productId Ü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 Ürün kategori bilgisi, bu bilgi Mobilepax tarafından verilecektir. String productName Tanımlanacak ürün adı String productComment Ürün hakkında açıklama Double price Ürün fiyat bilgisi; Geçerli formatlar 5 veya 5,25 gibi String picture Ürün resim bilgisidir. Bilgi gönderilirken URL bilgisi olarak gönderilmelidir. ÖRN: http://images.mobilepax.com/button.png String successURL Başarılı ödeme geri dönüş URL adresi. Http ile başlamalıdır. String cancelURL İptal veya hatalı ödeme durumunda dönüş yapılacak URL Adresi. Http ile başlamalıdır. Adres
Telefon : 0216 305 1 888
Faks
: 0216 305 2 522
String smskeyword SMS ile başlatmada kullanılacak anahtar kelime, her ürün için tek olmalıdır. String successsms 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. String confrmsms 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' /> Adres
Telefon : 0216 305 1 888
Faks
: 0216 305 2 522
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 Adres
Telefon : 0216 305 1 888
Faks
: 0216 305 2 522
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. Adres
Telefon : 0216 305 1 888
Faks
: 0216 305 2 522

mobılepax xml product apı kullanım şekli

Transkript

Benzer belgeler

MOBILEPAX ENTERPRISE API (WEB SERVİS)

web`den başlatma

COM API v.1.1

Neutral Ethanol 96% ENA(SugarBeet)

Visilabs Segment Kurulum Kılavuzu