Handbuch: Konfiguration Service Event Einleitung

Handbuch: Konfiguration Service Event
(Stand: 11.06.2012)
Einleitung
Dieses Abrechnungsmodell ermöglicht Ihnen eine konsequente Trennung zwischen Kauf und
Auslieferung. Nachdem der Endkunde die Bezahlung vollzogen hat, können Sie sämtliche Events
auslösen. Freischaltungen oder Kontoaufladungen lassen sich somit schnell und direkt realisieren.
Notwendige Einstellungen:
Nachdem Sie Ihr Projekt angelegt und aktiviert haben, navigieren Sie bitte zu:
Meine Konfiguration -> Zahlungsarten -> Call2Pay Event -> Aktionen konfigurieren...
Aktivieren Sie die Zahlungsart
API-URL
Geben Sie hier das Script (URL) an, welches nach dem Call vom Call2Pay-Server mit den aktuellen
Zahlparametern (GET-Parameter) angetriggert werden soll. Bitte achten Sie auf die richt ige
Schreibweise Ihrer URL.
Wichtig: Bitte werten Sie die übergebenen GET-Parameter auf der API-URL aus und schreiben Sie dem
Kunden die gebuchte Leistung in Ihrem System gut. Von Ihrer API-URL erwartet unser Server danach
eine gültige Rückmeldung (response). Erst nach der Rückmeldung (status=ok) wird der Kunde auf einer
von Ihnen in der API-Datei vorgegebenen Ziel-URL weitergeleitet. Weitere Hinweise zum response
entnehmen Sie bitte dem Musterscript, welches Sie unter „Meine Hilfe“ finden.
Standard - Artikel (title)
Dieser Wert wird normalerweise dem Bezahlfenster als Parameter title mitgegeben. Sollten Sie über
einen Standardartikel verfügen oder nur einen Artikel anbieten, geben Sie ihn hier als eindeutigen
Bezeichner an. Beispiel: Premium Account ID
Hinweis: Möchten Sie unterschiedliche Artikel abrechnen, können Sie die jeweilige Bezeichnung
dynamisch mit dem Parameter &title=... bei dem Aufruf des Bezahlfenster übergeben. Durch den
Parameter title geben Sie dem Bezahlfenster bekannt, was der Endkunde nach dem erfolgreichen
Bezahlvorgang erhalten soll, bzw. welches Ereignis ausgelöst werden soll. Beispielsweise kann dies
eine Benutzeranmeldung oder Mitgliedschaftsverlängerung sein. Am sinnvollsten ist die Übergabe einer
ID die diesen Vorgang eindeutig identifiziert, z.B.: title=createaccount_12345 wobei 12345 die userid
sein könnte.
Syntax:
&title=[value]
Wert(e):
Zeichenkette / ID die das Event eindeutig identifiziert; z.B. eine UserID
Beispielaufruf:
http://billing.micropayment.de/call2pay/event/?project=demo&title=createaccount_12345
Standard - Preis (amount)
Bitte nennen Sie uns einen Standardpreis für Ihre Artikel. Dieser Preis wird nur benutzt, wenn bei der
Verlinkung der Bezahlseite kein anderer Preis übergeben wird. Bitte beachten Sie, dass der Preis in
EuroCent angegeben werden muss.
Hinweis: Möchten Sie unterschiedliche Preise abrechnen, können Sie den jeweiligen Preis dynamisch
mit dem Parameter &amount=... bei dem Aufruf des Bezahlfenster übergeben. Den festgelegten
Standard-Preis können Sie durch Verwendung des Parameters amount somit überschreiben.
Beispielsweise: &amount=200
Syntax:
&amount=[value]
Wert(e):
Abrechnungsbetrag in Eurocent
Beispielaufruf:
http://billing.micropayment.de/call2pay/event/?project=demo&amount=200
Standard - Preis (amount)
Hier einige Beispielaufrufe des Bezahlfensters (Demoprojekt) mit den unterschiedlichen Optionen:
Ein Artikel und ein Preis:
http://billing.micropayment.de/call2pay/file/?project=demo
Einstellungen für Standard-Artikel bzw. Standard-Preis werden übernommen
Mehrere Artikel und ein Preis:
http://billing.micropayment.de/call2pay/file/?project=demo&title=createaccount_12345
http://billing.micropayment.de/call2pay/file/?project=demo&title=createaccount_67890
Zwei unterschiedliche Accounts werden mit dem Standard-Preis abgerechnet
Mehrere Artikel und unterschiedliche Preise:
http://billing.micropayment.de/call2pay/file/?project=demo&title=createaccount_12345&amount=200
http://billing.micropayment.de/call2pay/file/?project=demo&title=createaccount_67890&amount=300
Zwei unterschiedliche Accounts werden mit verschiedenen Preisen abgerechnet
Weitere optionale Einstellungen:
Optionen: Standard - Artikel
Legen Sie hier bitte fest, ob Sie nur den angegebenen Wert für den Standard -Artikel nutzen möchten.
Rechnen Sie mehrere Artikel ab, nutzen Sie bitte die Option „verwenden, wenn kein Artikel übergeben
wurde“.
Optionen: Standard - Preis
Legen Sie hier bitte fest, ob Sie nur den angegebenen Wert für den Standard -Preis nutzen möchten.
Rechnen Sie mehrere Preise ab, nutzen Sie bitte die Option „verwenden“, wenn kein Preis übergeben
wurde“.
Optionen: erweiterte Sicherheit (seal)
"Erweiterte Sicherheit (Siegel)" bedeutet, dass von Ihnen über sämtliche URL -Parameter ein eindeutiger
HASH gebildet wird, der vom Bezahlfenster gegengeprüft wird. Dies verhindert eine Manipulation der
Parameter durch den Kunden.
Hinweis: Bei Aktivierung der erweiterten Sicherheit muss der Bezahlseite mit dem Parameter seal ein
Siegel übergeben werden. Dieses wird aus dem Hashwert aller Parameter und Ihrem AccessKey
gebildet. Benutzen Sie den Siegelgenerator unter „Meine Tools“ oder erfahren Sie Genaueres unter
"Hilfe zur Einbindung".
Optionen: API-URL
Wenn in der Konfiguration unter "Optionen API-URL" der Punkt "Das senden zusätzlicher Daten
aktivieren" angewählt wurde, werden zusätzliche Ereignisse an die API -URL geschickt. Spätestens mit
Aktivierung dieser Option muß der Parameter "function" ausgewertet werden.
Wichtig: Beim Aufruf der API-URL wird standardmäßig der Parameter "function" angehängt.
Der Standardwert ist "billing" und wird immer nach einer erfolgreichen Zahlung aufgerufen.
Zurzeit stehen folgende Funktionen zur Verfügung:
Billing
- Aufruf nach einer erfolgreichen (Erst-) Zahlung
Storno
- Ein Zahlvorgang wird storniert
Backpay
- Ein stornierter Zahlvorgang wurde erfolgreich inkassiert (Storno ist aufgehoben).
Diese Funktionen können zukünftig erweitert werden. Sie sollten deshalb immer exakt auf die Funktion
prüfen (keine Defaultverarbeitung)
Optionen: Fehler-URL
Diese URL wird dem Kunden auf der Fehlerseite angezeigt. Sie können dort z.B. ihre FAQ oder einen
Supportchat hinterlegen.
Länder-/Tarifkonfiguration
In diesen Ländern können Ihre Kunden mit Call2Pay bezahlen. Ihre Kunden können hi ermit regional
eingeschränkt werden.
Hinweis: Das Multicall-Verfahren ermöglicht die Abrechnung von höheren Endkunden-Beträgen. Hierfür
wird der Gesamtbetrag in mehrere Einzeltransaktionen gesplittet. Sie sollten das Multicall -Verfahren
nicht deaktivieren
Zusätzliche GET-Parameter (QueryString)
Der QueryString der an die ZielURL angehängt werden soll, wird hier als Name=Wert Paar eingetragen.
Im QueryString werden Platzhalter zur Laufzeit ersetzt. Platzhalter werden durch 2 Unterstriche vor und
nach dem Namen gebildet. Bsp.: __amount__
Vordefinierte Platzhalter
__auth__
Die Session des Zahlsystems ist notwendig für zusätzliche Statusabfragen.
__title__
Der Parameter der dem Bezahlfenster übergeben wurde. Dieser Parameter
bezeichnet in der Regel das abzurechnende Produkt / Artikel.
__amount__
Dieser Parameter enthält den übergebene Preis in Eurocent (Beispiel: für
2,99€ -> 299).
__country__
Dieser Parameter enthält das Land aus dem der Call erfolgte (2 Stellen
ISO).
__currency__
Der Parameter currency enthält die Landeswährung des Endkunden (3 Stellen
ISO).
freidefinierbare Platzhalter werden durch voranstellen eines Dollarzeichens vor dem Namen gebildet,
wobei der Name nur aus den Buchstaben a-z sowie den Zahlen 0-9 bestehen darf.
Beispiel:
Das Bezahlfenster wird mit ....&kundennr=wert12345 aufgerufen.
Dann wird der Platzhalter __$kundennr__ mit wert12345 ersetzt.
Notiz zu Ihrer Konfiguration
Hier können Sie sich eine Notiz zu der Konfiguration hinterlegen
Wir hoffen, dass wir Ihnen mit diesem Dokument weiterhelfen konnten.
Sollten Sie dennoch Fragen oder Anregungen haben, wenden Sie sich bitte an unsere Kundenberater.
Viel Erfolg wünscht Ihnen Ihr micropayment™-Team
Logos & Icons
Für die Integration der micropayment™ Zahlungssysteme bieten wir
unseren Partnern eine umfangreiche Auswahl an Logos & Icons. Diese
können Sie bequem in Ihrem micropayment™ ControlCenter unter dem
Menüpunkt „Meine Tools“ einsehen und verwenden.
Support
Neben unseren Produkten und Lösungen stehen wir Ihnen mit Rat und Tat beiseite. Wir helfen Ihnen bei
der Konfiguration und der Integration unserer Zahlungssysteme.
Alle Kontaktmöglichkeiten stehen für Sie werktags von 9:00 Uhr bis 17:00 Uhr zur Verfügung.
Nutzen Sie folgende Services:
Kundenhotline
0180 5 770 370
0,14€/min aus dem dt. Festnetz, ggf.
abweichende Preise aus dem Mobilfunk.
Vertriebshotline
0800 5 770 371
Partnerhotline
0800 5 770 370
Supportchat starten
262-694-660
Support-micropayment
[email protected]
Produktnamen und Logos werden ausschließlich zur Identifikation der Produkte verwendet und sind
eingetragene Marken der entsprechenden Hersteller.