"Şirket" Sunucusu ve Başarı Mobile Arasındaki HTTP Veri Aktarımı için Etkileşim Teknik Protokolü

Transkript

1 "Şirket" Sunucusu ve Başarı Mobile Arasındaki HTTP Veri Aktarımı için Etkileşim Teknik Protokolü BAŞARI Mobile tarafından desteklenmektedir.

2 1. Genel Bakış Bu döküman ile Şirket Adı nın ve Basari Mobile HTTP arayüzünün birbirlerinden Ödeme İsteklerini nasıl alacakları ve bunlara MO&short code ve ödeme sonuçlarıyla nasıl cevap vereceklerinin anlatılması amaçlanmıştır. InAppPurchase DemoVersion End User ThirdParty(Company Name ) BAŞARI OPERATOR Send description Create IDHeader Embedded in content User play game Try to buy game Send sms 2977 Process the sms Parse the sms Charging process Return the charging result İnform user Get result Charging notifier services Call Company nickname service Picture 1 : Başarı PSMS Akış Şeması

3 2. Son Kullanıcı Arayüzü 3. Ödeme İsteği Şifrelenmiş SMS metni: Parameter ismi Açıklama Yorum Ödeme İsteğinin Ana Parametreleri CONSTANT Static text INAPP PARTNERNAME PartnerName (String) Company Name ex: XCOMPANY ITEMUNIQUEID ENCRYPTEDTEXT EachItem Id predefined with price list Partner Specific RequestId, you can encrypt this area if you need. Itemdefined Id ex : CR7Football a2231d a53c-d8950cfb95f5 NOW Current time The format should be yyyymmddhhmmss, UTC (global time). conntype Production or test area Prod or test smstext: CONSTANT_ PARTNERNAME_ ITEMUNIQUEID _ENCRYPTEDTEXT_ Now _ conntype ÖRNEK: INAPP_XCOMPANY_CR7Football2012_30a2231d a53cd8950cfb95f5_ _PROD 3. Başarı Mobile Ödeme Sonucu Başarı Mobile ödemenin sonucunu gönderecektir. Cevap sorgusunun örneği: Aşağıdaki sunucu bilgilerini doldurunuz. Test Server : Real Server : Bu istek aşağıdaki parametreleri içermelidir. Parameter adı Açıklama Yorum Main parameters of the Subscriber s request RAWDATA INAPP_XCOMPANY_CR7Football2012_30a223 1d a53c-

4 RCODE 0 for success billing, negative values for errors * d8950cfb95f5_ _prod 0, -1, -2 CHARGINGTIMEUTC datetime Time of delivery in UTC format(yyyymmddhhmmss) REQUESTID Request Id values of the Basari Mobile systems 614 Yanıt formatı a) Başarılı SMS yanıtı: <Response> <ResponseStatus>OK</ResponseStatus> </Response> b) Hatalı SMS yanıtı: <Response> <ErrorText> companynickname reqid is not exists</errortext> </Response> Appendix1 Yanıt Kodu Yanıt Açıklaması Faturalandırıldı(Bille d) veya Faturalandırılmadı(N ot Billed) AÇIKLAMA 0 SUCCESS Billed Success Case NOT_ENOUGH_CREDI -1 T When user doesn't have enough credit. -2 ONLINE_FAIL Operator Based Fail while charging Response while trying to charge users which are -3 PRIVATE_SERVICE closed private services

5 -5 SMS_TIMEOUT -6 USER_IN_BLACKLIST -7 NOT_APPROVED -8 NOT_SUPPORTED For offline charging process, when user doesn't reply to confirmation SMS Response while trying to charge users which arein blacklist For offline charging process, when user reply but improper way. One of Turkcell special webservice gives us the phone model by MSISDN then we check if the device supports the content or not. -9 UNKNOWN_ERROR Negative but not equals to above negative cases -10 SYSTEM_ERROR Any unhandled error case NO_MULTIPLE_CHAR Constraint for multiple charge in the following couple -97 GE of seconds of last transaction -99 LOAN_EXCEEDED If Loan debit is exceeded the predefined limit -100 EXCEPTION Any undefined Exception case -101 MO_NOT_SENT NOT Billed After the 2 nd sequence on picture 1, 24 hours have passed and MO is not arrived at Mobile carrier or Basari (3 rd sequence is failed) -102 PRICE_NOT_IN_LIST NOT Billed If the price of the content not in the pre-defined price list. 4.Pricing List Defination Prepaid Credit TL&DOLAR TL 0 Free 0.0 TL 2 0,8 TL/0,99 USD 0.8 TL 5 2 TL/1,99 USD 2.0 TL 8 3,2 TL/2,99 USD 3.2 TL 10 4 TL/3,99 USD 4.0 TL 14 5,6 TL/4,99 USD 5.6 TL 16 6,4 TL/5,99 USD 6.4 TL 18 7,2 TL/6,99 USD 7.2 TL 20 8 TL/7,99 USD 8.0 TL 24 9,6 TL/8,99 USD 9.6 TL TL/9,99 USD 12.0 TL 32 12,8 TL/10,99 USD 12.8 TL

6 35 14 TL/11,99 USD 14.0 TL 37 14,8 TL/12,99 USD 14.8 TL TL/13,99 USD 16.0 TL TL/16,99 USD 20.0 TL 52 20,8 TL/17,99 USD 20.8 TL Her öğe aşağıdaki değerlere sahip olmalıdır. PartnerName, ApplicationName, ItemId, ItemName, ItemPrice PartnerName ApplicationName ItemId ItemName ItemPrice WSH ABCD BASWS30 30 Miracle Coin 0.8 TL WSH ABCD BASWS Miracle Coin 2 TL