atms m-payment Dokumentation Info Hotline: Autor: Christian Hutzinger Version 2.6 Stand: Seite 1

Transkript

1 atms m-payment Dokumentation Info Hotline: Autor: Christian Hutzinger Version 2.6 Stand: Seite 1

2 Inhaltsverzeichnis: 1 Grundlagen Operator-Identifizierung ÖSTERREICH T-Mobile ONE telering H3G: Mobilkom: SCHWEIZ Swisscom: Orange: Sunrise: DEUTSCHLAND Vodafone: T-Mobile: o2: E-Plus: Anbindung HTTP-REDIRECT URL Redirect (Session Übergabe) HTTP-Redirect - Schema URL-Parameter Session Rückgabe Fehlercodes Dokument-Historie Seite 2

3 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

4 2.1 Österreich T-Mobile Für T-Mobile Österreich gelten folgende Werte: WAP-GW IP-Adresse: , ONE Für ONE Österreich gelten folgende Werte: WAP-GW IP-Adresse: ; ; telering Für telering Österreich gelten folgende Werte: WAP-GW IP-Adresse: , , (Achtung: diese Angaben sind noch mit Vorsicht zu verwenden!) H3G: Für Hutchison Österreich gelten folgende Werte: WAP-GW IP-Adresse: (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! Mobilkom: Für Mobilkom Österreich gelten folgende Werte: WAP-GW IP-Adresse: Seite 4

5 2.2 Schweiz Swisscom: Für Swisscom Schweiz gelten folgende Werte: WAP-GW IP-Adresse: (Achtung: diese IP-Adresse könnte sich in Zukunft ändern. Falls eine IP-adresse im Subnetz /16 kommt bitte sofort Info an uns.) Orange: Für Orange Schweiz gelten folgende Werte: WAP-GW IP-Adresse: , , (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 /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 Sunrise: Für Sunrise Schweiz gelten folgende Werte: WAP-GW IP-Adresse: Seite 5

6 2.3 Deutschland Vodafone: WAP-GW IP-Adresse: T-Mobile: o2: E-Plus: WAP-GW IP-Adressen: /24 WAP-GW IP-Adressen: WAP-GW IP-Adressen: Seite 6

7 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

8 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: TCP-Port 80 Identify : 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 Wir behalten uns vor die IP-Adressen (auch ohne Benachrichtigung) zu ändern Redirect (Session Übergabe) Die Session-Übergabe erfolgt per Redirect. Die Daten werden direkt an die Redirect- URL angehängt. Beispiel: HTTP/ Date: Mon, 20 Jun :25:13 GMT Server: Apache/ X-Powered-By: PHP/ Location: amount=199&tax=2000&quantity=1&text=game&msgid=123456abc Connection: close Transfer-Encoding: chunked Content-Type: text/html; charset=iso Seite 8

9 3.1.3 HTTP-Redirect - Schema Billing Identify Session- Übergabe Session- Übergabe uid+upw+pid prüfen falsch Error uid+upw+pid prüfen falsch Error 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

10 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) Identifiziert das Projekt und den damit verbundenen Ablauf. mobileuser O O Kennung des Handyusers: ONE: Client-IP-Adresse oder MSISDN Rest: MSISDN. upw=7cbc a5201f4fd17e69fd17c0d 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 abc 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= % Schweiz=760 7,6% Deutschland= % quantity M --- Mengenangabe Anzahl der zu verrechnenden Artikel 1 urlsuccess O O Success - URL Vollständige Seccess-Rückgabe URL text M --- Rechnungstext Game textdetail M --- Detailbeschreibung des Artikels Java-Game Nr Seite 10

11 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/ Date: Mon, 20 Jun :43:06 GMT Server: Apache/ X-Powered-By: PHP/ Location: Content-Length: 0 Connection: close Content-Type: text/html; charset=iso Beispiel Reject-URL : HTTP/ Date: Mon, 20 Jun :43:06 GMT Server: Apache/ X-Powered-By: PHP/ Location: Content-Length: 0 Connection: close Content-Type: text/html; charset=iso Beispiel Error-URL : HTTP/ Date: Mon, 20 Jun :43:06 GMT Server: Apache/ X-Powered-By: PHP/ Location: &errmsg=transaction%20%error Content-Length: 0 Connection: close Content-Type: text/html; charset=iso Seite 11

12 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

13 4 Dokument-Historie Version Datum Beschreibung: erste Vorab-Version 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] zusätzliche Error-Codes 998 und 999 [3.1.5] - Änderung bei den VPN-Daten [4.1] zusätzlicher Operator Swisscom [2.2] - zusätzliche Methoide: HTTP-Redirect [3.2] zusätzlicher Operator telering [2.2] - Parameter tax auf %*100 geändert (altes Format funktioniert auch noch) [3.1.2]+[3.2.3] zusätzlicher Operatoren T-Mobile (A) [2.1] + Orange (CH) [2.5] - Parameter urlsuccess, urlreject und urlerror [3.2.3] zusätzliche Operator Hutchison 3G [2.4] - bei A_ONE + A_telering HTTP-Redirect zusätzliche Operator Sunrise [2.6] - zusätzliche Funktion: HTTP-Redirekt Identify Erweiterung um Vodafone Deutschland [2.8] - zusätzliche Error-Codes 386 und 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