atms m-payment Dokumentation Info Hotline: 0820 240 403 Autor: Christian Hutzinger Version 2.6 Stand: 07.05.2008 Seite 1
Inhaltsverzeichnis: 1 Grundlagen... 3 2 Operator-Identifizierung... 3 2.1 ÖSTERREICH... 4 2.1.1 T-Mobile... 4 2.1.2 ONE... 4 2.1.3 telering... 4 2.1.4 H3G:... 4 2.1.5 Mobilkom:... 4 2.2 SCHWEIZ... 5 2.2.1 Swisscom:... 5 2.2.2 Orange:... 5 2.2.3 Sunrise:... 5 2.3 DEUTSCHLAND... 6 2.3.1 Vodafone:... 6 2.3.2 T-Mobile:... 6 2.3.3 o2:... 6 2.3.4 E-Plus:... 6 3 Anbindung... 7 3.1 HTTP-REDIRECT... 7 3.1.1 URL... 8 3.1.2 Redirect (Session Übergabe)... 8 3.1.3 HTTP-Redirect - Schema... 9 3.1.4 URL-Parameter... 10 3.1.5 Session Rückgabe... 11 3.1.6 Fehlercodes... 12 4 Dokument-Historie... 13 Seite 2
1 Grundlagen Mit dem atms WAP-Billing besteht die Möglichkeit einen Artikel, der per WAP angeboten wird zu verrechnen. Dafür stellt die mobileworx trading GmbH als Technik-Tochter die nötige Funktionalität zur Verfügung. Diese Möglichkeit des Billings steht momentan nur für folgende Netzbetreiber zur Verfügung: Österreich o T-Mobile [2.1.1] o ONE [2.1.2] o telering [2.1.3] o H3G [2.1.4] o Mobilkom [2.1.5] Schweiz o Swisscom [2.2.1] o Orange [2.2.2] o Sunrise [2.2.3] Deutschland o Vodafone [2.3.1] o T-Mobile [2.3.2] o o2 [2.3.3] o E-Plus [2.3.4] 2 Operator-Identifizierung Da in der WAP-Session die MSISDN nicht mit übertragen wird, müssen die Operatoren anhand anderer Parameter erkannt werden. Seite 3
2.1 Österreich 2.1.1 T-Mobile Für T-Mobile Österreich gelten folgende Werte: WAP-GW IP-Adresse: 213.162.66.126, 213.162.66.71 2.1.2 ONE Für ONE Österreich gelten folgende Werte: WAP-GW IP-Adresse: 194.24.128.118; 194.24.128.119; 194.24.128.120 2.1.3 telering Für telering Österreich gelten folgende Werte: WAP-GW IP-Adresse: 212.95.31.51, 212.95.31.52, 212.95.31.53 (Achtung: diese Angaben sind noch mit Vorsicht zu verwenden!) 2.1.4 H3G: Für Hutchison Österreich gelten folgende Werte: WAP-GW IP-Adresse: 213.94.74.251 (Achtung: diese Angaben sind noch mit Vorsicht zu verwenden!) Bei H3G gibt es keine automatische MSISDN Erkennung! Die MSISDN muss im Parameter mobileuser mit gesendet werden! 2.1.5 Mobilkom: Für Mobilkom Österreich gelten folgende Werte: WAP-GW IP-Adresse: 194.48.124.112 Seite 4
2.2 Schweiz 2.2.1 Swisscom: Für Swisscom Schweiz gelten folgende Werte: WAP-GW IP-Adresse: 138.188.101.30 (Achtung: diese IP-Adresse könnte sich in Zukunft ändern. Falls eine IP-adresse im Subnetz 138.188.0.0/16 kommt bitte sofort Info an uns.) 2.2.2 Orange: Für Orange Schweiz gelten folgende Werte: WAP-GW IP-Adresse: 213.55.200.62, 213.55.200.57, 213.55.130.205 (Achtung: offiziell sind nur die ersten beiden IP- Adressen angegeben. Beim Testen haben wir die dritte IP-Adresse bekommen. Man kann auch die gesamte IP-Range von Orange einstellen 213.55.128.0/17) Folgendes ist bei Festlegung der Tarife zu beachten: Bis 5,00 CHF sind nur Tarife in 0,10 CHF Schritten möglich Ab 5,00 CHF sind nur Tarife in 0,50 CHF Schritten möglich 2.2.3 Sunrise: Für Sunrise Schweiz gelten folgende Werte: WAP-GW IP-Adresse: 212.35.34.70 Seite 5
2.3 Deutschland 2.3.1 Vodafone: WAP-GW IP-Adresse: 139.7.29.1 2.3.2 T-Mobile: 2.3.3 o2: 2.3.4 E-Plus: WAP-GW IP-Adressen: 193.254.160.0/24 WAP-GW IP-Adressen: 62.180.105.33 62.180.105.66 82.113.100.4 82.113.126.33 192.109.216.78 192.109.216.147 192.109.216.148 192.109.216.149 192.109.216.196 195.182.114.45 WAP-GW IP-Adressen: 212.23.97.195 212.23.97.162 212.23.98.248 Seite 6
3 Anbindung Die Anbindung kann zum jetzigen Zeitpunkt auf folgende Weise realisiert werden: HTTP-Redirect [3.1] 3.1 HTTP-Redirect Die Funktionsweise der HTTP-Redirect - Anbindung läuft so ab, dass die bestehende WAP-Session auf den mobileworx WAP-Server übergeben wird. Dabei werden die nötigen Daten direkt an die Redirect-URL angehängt. Nach erfolgreicher Abwicklung wird die Session auf die Success-Url wieder zurückgegeben. Dabei wird Ihnen die msgid zur Identifizierung der Session wieder zurückgegeben. Wird die der Billing-Vorgang abgebrochen wird die Session auf die Reject-Url zurückgegeben. Im Errror-Fall wird die Session auf die Error-Url zurückgegeben. Wichtig dabei ist, dass bei Rückgabe der Session diese durch den Parameter msgid identifiziert wird. Seite 7
3.1.1 URL Es stehen grundsätzlich 2 Methoden zur Verfügung: Billing ein bestimmter Betrag wird abgebucht Identify die MSISDN des Handyusers wird ermittelt Die WAP-Session wird dafür auf folgende URL redirected: Billing: http://wapgw.mobileworx.at/sp/wap-http.php TCP-Port 80 Identify : http://wapgw.mobileworx.at/sp/wap-identify.php TCP-Port 80 Es ist sinnvoll den im DNS eingetragenen Host-Name zu verwenden. Falls es damit aber aus irgendeinem Grund Probleme geben sollte, entsprechen diese momentan folgenden IP-Adressen: wapgw.mobileworx.at 62.218.114.210 Wir behalten uns vor die IP-Adressen (auch ohne Benachrichtigung) zu ändern. 3.1.2 Redirect (Session Übergabe) Die Session-Übergabe erfolgt per Redirect. Die Daten werden direkt an die Redirect- URL angehängt. Beispiel: HTTP/1.1 302 Date: Mon, 20 Jun 2005 09:25:13 GMT Server: Apache/2.0.54 X-Powered-By: PHP/4.3.10 Location: http://wapgw.mobileworx.at/sp/waphttp.php?uid=4099&upw=7cbc8707203a5201f4fd17e69fd17c0d&pid=409901& amount=199&tax=2000&quantity=1&text=game&msgid=123456abc Connection: close Transfer-Encoding: chunked Content-Type: text/html; charset=iso-8859-1 Seite 8
3.1.3 HTTP-Redirect - Schema Billing Identify Session- Übergabe Session- Übergabe uid+upw+pid prüfen falsch Error 901-922 uid+upw+pid prüfen falsch Error 901-922 richtig richtig mobileuser übergeben Nein mobileuser übergeben Nein Ja mobileuser wird ermittelt Ja mobileuser wird ermittelt operator übergeben Nein Session- Rückgabe mit MSISDN Ja operator wird ermittelt Billing Session- Rückgabe mit MSISDN Seite 9
3.1.4 URL-Parameter Name: Billing Identify Beispiel: uid M M User-ID (wird Ihnen von uns mitgeteilt) 4099 upw M M MD5-Hash aus Passwort und Parameter msgid. zb.: Hash aus 58er62je123456abc Passwort=58er62je msgid=123456abc pid M M Projekt-ID (wird Ihnen von uns mitgeteilt) 409901 Identifiziert das Projekt und den damit verbundenen Ablauf. mobileuser O O Kennung des Handyusers: ONE: Client-IP-Adresse oder MSISDN Rest: MSISDN. upw=7cbc8707203a5201f4fd17e69fd17c0d 10.100.123.234 4369912345678 urlreject O O Reject URL Vollständige Reject-Rückgabe URL urlerror O O Error URL Vollständige Error-Rückgabe URL Folgende Parameter können verarbeitet werden: Parameter- Mandatory Optional Beschreibung: msgid M M Identifizierung des Requests 123456abc operator O O Voraussichtlicher Operator: Österreich: CH_Swisscom A_TMobile T-Mobile A_ONE ONE A_telering telering A_H3G Hutchison 3G A_Mobilkom Mobilkom Austria Schweiz: CH_Swisscom Swisscom CH_Orange Orange CH_Sunrise Sunrise Deutschland: D_Vodafone Vodafone D_TMobile T-Mobile D_O2 o2 D_EPlus E-Plus amount M --- Zu verrechnender Betrag (Brutto) in 199 Eurocent oder Rappen tax O --- Steuersatz in %*100 Wird dieser Parameter nicht angegeben wird der Standard-Streuersatz verwendet: 2000 Österreich=2000 20% Schweiz=760 7,6% Deutschland=1900 19% quantity M --- Mengenangabe Anzahl der zu verrechnenden Artikel 1 urlsuccess O O Success - URL http://12.34.56.78/retourok.wml?id=123 Vollständige Seccess-Rückgabe URL http://12.34.56.78/retourrejct.wml?id=123 http://12.34.56.78/retourerror.wml?id=123 text M --- Rechnungstext Game textdetail M --- Detailbeschreibung des Artikels Java-Game Nr. 123456 Seite 10
3.1.5 Session Rückgabe Die Session wird auf vorher definierte oder vorher übergebene URL s zurück Redirectet. Dabei gibt es 3 verschiedene URL s: Success-URL Billing erfolgreich ausgelöst Reject-URL User hat das Billing abgelehnt Error-URL es ist ein Fehler aufgetreten (siehe Tabelle [3.2.5]) Es wird jeweils die msgid mit übergeben. Bei der Error-URL wird zusätzlich der Error- Code und Error-Beschreibung mitgeliefert. Die Session wird auf folgende Weise zurückgegeben: Beispiel Success-URL : HTTP/1.1 302 Date: Mon, 20 Jun 2005 09:43:06 GMT Server: Apache/2.0.54 X-Powered-By: PHP/4.3.10 Location: http://12.34.56.78/retour-ok.wml?msgid=123456abc Content-Length: 0 Connection: close Content-Type: text/html; charset=iso-8859-1 Beispiel Reject-URL : HTTP/1.1 302 Date: Mon, 20 Jun 2005 09:43:06 GMT Server: Apache/2.0.54 X-Powered-By: PHP/4.3.10 Location: http://12.34.56.78/retour-reject.wml?msgid=123456abc Content-Length: 0 Connection: close Content-Type: text/html; charset=iso-8859-1 Beispiel Error-URL : HTTP/1.1 302 Date: Mon, 20 Jun 2005 09:43:06 GMT Server: Apache/2.0.54 X-Powered-By: PHP/4.3.10 Location: http://12.34.56.78/retour-error.wml?msgid=123456abc&errcode=200 &errmsg=transaction%20%error Content-Length: 0 Connection: close Content-Type: text/html; charset=iso-8859-1 Seite 11
3.1.6 Fehlercodes Error- Billing Beschreibung: Code 100 OK X X Billing-Provider Error-Codes 200 Transaction error X X 300 Payment problem X 305 Invalid userid X X 308 Prepaid customer not allowed X 310 Customer locked account X 500 System error X X atms WAP-Billing Error-Codes: 901 uid missing X X 902 uid wrong X X 911 upw missing X X 912 upw wrong X X 921 pid missing X X 922 pid wrong X X 931 msgid missing X X 951 operator wrong X X 961 amount missing X 962 amount wrong X 967 tax wrong X 971 quantity missing X 972 quantity wrong X 981 text missing X 986 msgid already in use X 987 user blocked X 988 user limit reached X 998 system error X X 999 system error X X Identify Seite 12
4 Dokument-Historie Version Datum Beschreibung: 0.1 18.03.2005 - erste Vorab-Version 1.0 4.04.2005 - falsche Bezeichnung für Punkt [3.1.2] - zusätzliche Error-Codes 308, 310 und 952 [3.1.5] - Operator-Identifizierung ONE geändert [2.1] - Parameter operator jetzt Mandatory [3.1.2] 1.1 4.04.2005 - zusätzliche Error-Codes 998 und 999 [3.1.5] - Änderung bei den VPN-Daten [4.1] 2.0 24.06.2005 - zusätzlicher Operator Swisscom [2.2] - zusätzliche Methoide: HTTP-Redirect [3.2] 2.1 22.07.2005 - zusätzlicher Operator telering [2.2] - Parameter tax auf %*100 geändert (altes Format funktioniert auch noch) [3.1.2]+[3.2.3] 2.2 07.10.2005 - zusätzlicher Operatoren T-Mobile (A) [2.1] + Orange (CH) [2.5] - Parameter urlsuccess, urlreject und urlerror [3.2.3] 2.3 15.03.2006 - zusätzliche Operator Hutchison 3G [2.4] - bei A_ONE + A_telering HTTP-Redirect 2.4 12.07.2006 - zusätzliche Operator Sunrise [2.6] - zusätzliche Funktion: HTTP-Redirekt Identify 2.5 05.02.2008 - Erweiterung um Vodafone Deutschland [2.8] - zusätzliche Error-Codes 386 und 387 2.6 07.05.2008 - Erweiterung um T-Mobile Deutschland [2.3.2] - Erweiterung um o2 Deutschland [2.3.3] - Erweiterung um E-Plus Deutschland [2.3.4] - Erweiterung um Mobilkom Austria [2.1.5] Seite 13