Click&Buy Transaktionssystem

Größe: px

Ab Seite anzeigen:

Download "Click&Buy Transaktionssystem"

Katharina Wolf
vor 7 Jahren
Abrufe

1 Click&Buy Transaktionssystem FIRSTGATE AG Im MediaPark 5 D Köln Telefon: + 49 (0) 221 / Telefax: + 49 (0) 221 / service@firstgate.de Version 1.1,

2 Inhaltsverzeichnis Inhaltsverzeichnis 1 Transaktionssystem Angebotsverwaltung - Transaktionssystem Grundprinzip Transaktionsbasierte Kaufabwicklung Beispiel für ein PHP-Transaktionsskript

3 1 Transaktionssystem 1.1 Angebotsverwaltung - Transaktionssystem Grundprinzip Mit dem Transaktionssystem von Click&Buy besteht die Möglichkeit, transaktionsbasierte Kaufvorgänge abzuwickeln. Setzen Sie das Transaktionssystem immer in folgenden Fällen ein: Sie sind Anbieter und verwalten Ihre Benutzer (oder einzelne Informationen über die Benutzer) selbst. Sie verwenden eine Warenkorbfunktion. Käufe werden auch von anderen Medien neben dem PC vorgenommen (z.b. beim Kauf von Klingeltönen oder Logos für ein Handy). Die Zugriffskontrolle über den angebotenen Inhalt soll generell nicht über Click&Buy erfolgen. Und so funktioniert das Transaktionssystem: 1. Transaktionslink einrichten. Zunächst richten Sie einen Transaktionslink ein. Für die Einrichtung von Transaktionslinks sorgt Ihr Key Account Support Manager. Dieser teilt Ihnen nach Einrichtung die genaue URL des neuen Transaktionslinks mit (z.b Verarbeitendes Skript erstellen. Anschließend erstellen Sie ein Skript (z.b. PHP, JSP oder ASP), welches die Daten der Transaktion später verarbeiten wird. Danach wird der Transaktionslink um den Name des Skriptes ergänzt (z.b. Ein Beispiel für ein PHP-Skript finden Sie in Kapitel , Seite 5 3. Parameter an Transaktionslink anhängen. Zwei Parameter sind von Click&Buy zwingend vorgegeben: price cb_content_name Dem Transaktionslink können dann zusätzlich noch verschiedene individuelle Parameter angehängt werden. Mit dem Parameter "price" übergeben Sie den Preis Ihres Angebotes in Cent. Das bedeutet, dass Sie bei einem Preis von einem Euro den Wert 100 übergeben müssen. Kostet Ihr Angebot 50 Cent, übergeben Sie für den Parameter "price" den Wert 050. Die kleinste Preiseinheit ist 1 Cent und würde im Transaktionslink mit dem Parameter price=001 übergeben werden. Der Parameter "cb_content_name" übergibt die Bezeichnung Ihres Angebots, die auf der Kaufseite und auf den Abrechnungsdokumenten erscheint. Geben Sie den Wert des Parameters URL-codiert an, um im Transaktionslink übertragen werden zu können. Was bedeutet das? Nach der Codierungsmethode "urlencode" wird das Leerzeichen im Beispieltext "Mein Angebot" durch ein "+" ersetzt, so dass der zu übergebende Wert für diesen Parameter im Transaktionslink so aussehen würde: &cb_content_name=ihr+angebotstext - 2 -

4 Wie bereits erwähnt, können Sie je nach Bedarf eigene Parameter definieren, die bei einer Kauftransaktion zur weiteren Verarbeitung an Sie zurück gegeben werden. Denkbar sind zum Beispiel Parameter wie "Username" zur Zuordnung in Ihre Benutzerverwaltung oder eine eigene Angebotsnummer zur Weiterverarbeitung innerhalb Ihres Warenwirtschaftssystems. Eine beispielhafte URL würde also so aussehen: 4. Link einbauen Nun bauen Sie den Transaktionslink mit den zu übergebenden Parametern in Ihre Internetpräsenz ein Transaktionsbasierte Kaufabwicklung Nachdem nun alle Vorbereitungen getroffen sind, funktioniert die transaktionsbasierte Kaufabwicklung folgendermaßen: Abb. 1-1 Transaktionsbasierte Kaufabwicklung - 3 -

5 Ein Kunde klickt auf Ihren Transaktionslink und gelangt nach erfolgreicher Autentifizierung auf die Bezahlseite, wo er den Kauf bestätigt. Nach erfolgter Kauftransaktion wird Ihr Skript aufgerufen und abgearbeitet. Dabei können die als Parameter im Kauflink übergebenen Werte innerhalb Ihrer Systeme verarbeitet werden. Die Steuerung über die Auslieferung des Angebots obliegt Ihnen, d.h. Sie teilen dem Click&Buy System mit, ob eine Transaktion erfolgreich verlaufen ist oder nicht. Dazu ist im Skript eine Anweisung enthalten, welche zwischen Link-Aufrufen je nach aufgetretenem Transaktionsereignis differenziert. Das bedeutet, dass bei einer erfolgreichen Transaktion, ein Link aufgerufen wird, der den Parameter result=successs übergibt und auf eine von Ihnen festgelegte HTML-Seite weiterleitet. Dies kann z.b. eine "Dankeschön-Seite sein". Im Fehlerfall wird ein Link mit dem Parameter result=error aufgerufen, der beispielsweise auf eine Fehlerseite verweist. Die Weiterleitung auf die jeweilige Seite wird dabei vom Click&Buy System durchgeführt. So kann das Click&Buy System anhand der Parameter "result=error" oder "result=success" erkennen, ob die Buchung im Transaktionsskript beim Anbieter zum Erfolg oder Misserfolg geführt hat und belastet den Betrag beim Benutzerkonto des Users nur dann, wenn der result =success ist. Bitte beachten Sie zu diesem Thema auch das gesonderte Handbuch Event Messaging Service. Das Handling von Events ist in den meisten Fällen in das Transaktionssystem integriert

6 Beispiel für ein PHP-Transaktionsskript Beachten Sie folgende wichtige Hinweise: Geben Sie die URL des http-redirects immer absolut an, sie darf nicht relativ angegeben werden! Außerdem muss im Skript Null-Output verwendet werden, dass heißt Ihr Skript darf keinen Output im Sinne eines "echo" erzeugen. Sie erhalten vom Click&Buy-System für jede Kauftransaktion eine eigene TransaktionsID (BDR ID). Klickt Ihr Kunde irrtümlich mehrfach den "Akzeptieren-Button", so dass meherer TransaktionsIDs erzeugt werden, stellt Click&Buy sicher, dass trotzdem nur eine der TransaktionsIDs abgebucht wird. Damit Sie im Falle eines Mehrfachklicks des Users das Angebot nicht mehrfach ausliefern, empfehlen wir die Übergabe einer eigenen, eindeutigen ID pro Kauftransaktion und das Speichern dieser ID als eindeutigen Wert in die Datenbank. Lesen Sie die Kundenreferenznummer von Click&Buy ($_SERVER["HTTP_X_USERID"]) aus und speichern Sie sie in Ihrer Datenbank. <? /************************************* ***** Transaction Script Example ***** *************************************/ //Init Products $products = Array("product1" => 29.90,"product2" => 39.90); //Init Header Parameter $fg_linknr = $_SERVER["HTTP_X_CONTENTID"]; //Premium Link Number $fg_price = $_SERVER["HTTP_X_PRICE"]; //Price in Cent-> for 1 EURO enter 100! $fg_transaction_id = $_SERVER["HTTP_X_TRANSACTION"]; //Transaction ID is a unique ID from Click&Buy (same like BDR ID) $fg_uid = $_SERVER["HTTP_X_USERID"]; //Click&Buy Customer Reference Number $fg_ip = $_SERVER["REMOTE_ADDR"]; //IP - Address from Request // Init Get Parameter $my_transaktion_id = $_GET["my_transaktion_id"]; // Your Transaktion-ID to trace double reservation, by double Click $my_productid = $_GET["productid"]; //Your own GET Parameter $my_uid = $_GET["uid"]; //Your own GET Parameter //Check UserID and Reservation check, if transaction_id=0 then is it a test purchase or the user is member in the servicearea if(empty($fg_uid) $fg_transaction_id == 0){ $result = false;} //Check FIRSTGATE IP-Range if(substr($fg_ip,0,11)!= " "){$result = false;} //Check FIRSTGATE Price if(empty($fg_price)){$result = false;} // Check Price Transaktionssysteme if($products[$my_productid]!=($fg_price/1000)){$result = false;} //If you are using a MySQL Database you can write the values into it by using the following example code. //Please consider that you may have to do little customizatzions //You don't need this IF-Blick if yo are not working with a database if($result){ $sql = "INSERT INTO transactions (uid,fg_uid,date_time,product_id,link_nr,fg_transaction_id,my_transact - 5 -

7 ion_id) "; $sql.= "VALUES "; $sql.= "('$my_uid','$fg_uid','".date("y-m-d H:i:s")."','$my_productid','$fg_linknr','$fg_transaction_id','$my_tran saktion_id')"; //my_transaktion_id must be unique if(!$query { //Check double reservation, by double Click $sql_d_reservation = "SELECT transaction_id FROM transactions Where my_transaction_id="; $sql_d_reservation.= $my_transaction_id; $count_transaction = mysql_query(mysql_fetch_row($sql_d_reservation)); } } //Is the reservation booked then is result=true //Is the reservation not booked is the result=false if($count_transaction!= 1){$result = false;} //redirect success or error if($result) { header("location: thanks.php?result=success"); }else header("location: }?> - 6 -

Ähnliche Dokumente

How to create a Gift Certificate Wie man ein Gift Certificate (Gutschein) erstellt

How to create a Gift Certificate Wie man ein Gift Certificate (Gutschein) erstellt 1) Login www.lopoca.com Username, Password 2) Click My Finances Gift Certificates Summary: Overview of your Gift Certificates Übersicht Ihrer Gift Certificates Create new: Create new Gift Certificate Neues