Übersicht   Lösungen   Neuigkeiten   Tarife   Affiliate Programm


Integration types

Der Zugangscode

 “Der Zugangscode” ist der voreingestellte einfache Weg, um SMS-Payments in Ihre Website zu integrieren. Wählen Sie einfach den Preis Ihres Dienstes oder Produktes und das System erzeugt automatisch den HTML-Code für Ihre Website. Dann müssen Sie nur noch den HTML-Code zur Ihrer Website hinzufügen und schon verdienen Sie Geld.

Wie funktioniert es?

  • Der Nutzer klickt auf den “Pay” Button auf Ihrer Website
  • Er erhält einen Shortcode und ein Keyword im Payment-Fenster. Zum Beispiel sehen deutsche Nutzer: “Senden Sie “sk59” an die 44442 um den Zugangscode zu erhalten”.
  • Der Nutzer sendet eine kostenpflichtige SMS mit dem Keyword, die dem Nuzter vom Netzbetreiber in Rechnung gestellt wird.
  • AOneBill erhält eine Zahlungsbestätigung und sendet den personalisierten Zugangscode in einer Antwort SMS.  
  • Der Nutzer gibt den Zugangscode auf Ihrer Website ein und kann den Dienst nutzen bzw. ein Produkt erwerben. Zum Beispiel erhält der Nutzer einen Downloadlink.
  • Wenn Sie "weekly payouts" wählen, erhalten Sie bereits nach einer Woche von AOneBill Ihre Payouts

Zwei weitere Features:  

  • “Der Zugangscode” erkennt das Land aus dem der Nutzer kommt und stellt dem Nutzer die Daten bzgl. lokaler Netzbetreiber und weitere Daten zur Verfügung.
  • Außerdem wird der personalisierte "Zugangscode" ohne einen Skript auf Ihrer Website generiert.

Um den Bezahldienst mit dem Access-Code einzurichten, müssen Sie folgende Felder ausfüllen:

  • “Success URL” — Geben Sie hier die URL zu der die Nutzer weitergeleitet werden, wenn sie den richtigen Zugangscode eingegeben haben.
  • “Error URL” — Geben Sie hier die URL ein zu der die Nutzer weitergeleitet werden, wenn sie einen falschen Zugangscode eingegeben haben
  • “Limit of use” — Geben Sie hier an, wie viele Male oder wie lange Ihre Nuzter einen Zugangscode nutzen dürfen.

 

Sobald Sie die Felder ausgefüllt und auf "Speichern" geklickt haben, erhalten Sie zwei HTML-Codes. Bitte fügen Sie die HTML-Codes in Ihre Website ein. Der erste HTML-Code ist der Code für das Bezahlfenster. Es sollte dort eingefügt werden, wo der Nutzer zur Zahlung aufgefordert wird.   Den zweiten HTML-Code sollten Sie vor dem </head>-Tag der HTML-Seite einfügen, welche durch den Zugangscode geschlossen wird.
Diese Art der Integration wird zum Schutz des Zugangs ohne Bezahlung verwendet. Es eignet sich daher in erster Linie für den Anbieter von digitalen Content.

"Protocol of access code authentication"

Um den Zugangs-Code, den der Nutzer eingegeben hat, zu verifizieren, müssen Sie einen HTTP GET request mit der AOneBill Plattform durchfüren:


http[s]://AOnebill.com/code-check?product=<product_id>&code=[&checkonly=1][&format=<xml|json|text>]

Parameter:

  • “product” ist die ID Ihres Bezahldienstes
  • “code” ist der Code, der vom Nutzer eingegeben wurde
  • “checkonly” ist ein optionaler Parameter.   Verwenden Sie ihn, wenn Sie nur prüfen möchten, ob der Code valide ist. Setzen Sie nicht die Anzahl herunter.  Wenn Sie diesen Paramter nicht spezifizieren, sinkt die Anzahl der erlaubten Verwendungen auf Eins für jeden Request mit diesem Code.
  • “format"— ist ein optionaler Parameter, der das Response-Format ermittelt.  

 

Response

Text format

Die Plain-Text-Response besteht aus zwei Zeilen:

  • Erste Zeile: «ok» bei richtiger Eingabe und «error:N» bei einem Fehler. N ist die Index-Nummer des Fehlers.
  • Die zweite Zeile beinhaltet die Prüfung des Fehlers, wenn die Response "error" war.

Zum Beispiel

error:25

Code abgelaufen
xml-Response

Die Xml-Response ist wie folgt:

 <?xml version="1.0" encoding='UTF-8'?>
 <Response>
     <status>
             Fehler
     </status>
     <error>
             <code>
             25
             </code>
             <message>
                 code expired
             </message>
     </error>
 </response>

Der Parameter “status” beinhaltet den Response Status “ok” oder “Error”, das Feld   “error->code” beinhaltet die Index-Nummer des Fehlers, und das Feld   “error->message” beinhaltet die Text-Nachricht zu dem Fehler.

Json Response

Die Response dieses Formats hat dieselben Elemente wie die XML-Response:

  • Status
  • error => code, message

Zum Beispiel

 {"status":"error","error": { "code" : 25,"message":"some message"} }

Statische Response

 “Statische Response” — eine weitere voreingestellte Lösung für SMS-Payments.  Dieser "integration type" lässt es zu, eine universelle Response an alle Nutzer zusenden. "Statische Response" wurde für Voting und Spendenaktionen entwickelt und kann von Ihnen auch anders eingesetzt werden.
Wie bei dem “Zugangscode” Setup benötigen Sie kein zusätzliches Coding. Füllen Sie einfach alle erforderlichen Felder für die Einrichtung des Bezahldienstes aus. Sie erhalten dann den HTML-Code, den Sie lediglich in Ihre Website einfügen müssen.
Alle Ihre Nutzer werden die Antwort erhalten, die Sie in den "payment service settings" spezifiziert haben. Beispiel: “Danke für Dein Voting” oder “Danke für Ihre Spende!”.
Diese Antwort können Sie frei in Ihren "payment service setting" auf AOneBill.com definieren.
Bitte vergessen Sie nicht das Text-Limit in Ihrer Response:

  • 70 Zeichen (Latin mit UTF-8 Symbolen)
  • 160 Zeichen (Pure Latin (7 bit))

API SMS Gateway

“SMS Gateway” ist die API für Webmaster um selbstständig Bezahldienste einzurichten.
Die AOnebill API ist eine Professionelle Lösung die individuelle Einstellungen je Bezahldienst erlaubt. Sie sind direkt an die Bezahl-Platfform angebunden. Sie müssen einen Script-Handler erstellen und die URL in Ihren Einstellungen spezifizieren. at  http://aonebill.com/services.
 
Um einen Bezahldienst über die API zu erstellen, benötigen Sie folgende Dokumente:

  • End-user tariffs and Mobile Operators ID http://aonebill.com/tariffs/?format=csv
  • Instructions for the payment windows in different countries.
  • AOneBill Endnuzter kontaktieren den AOneBill Support in verschiedenen Ländern.

Alle weiteren Auskünfte erhalten Sie vom Support Team support@aonebill.com

 

Die erforderlichen Felder:

  • “Handler” — Spezifizieren Sie die URL Ihres Script-Handlers an den AOneBill-Requests gesendet werden sollen
  • “Verification code” — Spezifizieren Sie den geheimen Code für AOneBill-Requests an Ihren Script-Handler.

 

Der Script-Handler ist das Script, welches den Request von der AOneBill-Billing Plattform  erhält und die Antwort in dem richtigen Format zurückliefert.
Die Script-Handler URL ist die Adresse Ihres Script-Handlers, der in dem folgenden Format gehosted sein sollte http://www.example/sssms.php. All Requests der AOneBill-Billing-Plattform  werden an diese Adresse weitergeleitet.

Request format

Nachdem AOneBill eine SMS Ihres Endkunden erhalten hat, führt es einen GET-Request an Ihren Script-Handler aus.
Wenn der Netzbetreiber ein MO-Billing verwendet, wird "abgebucht" sobald der Endkunde die SMS sendet.
Wenn der Netzbetreiber ein MT-Billing einsetzt, wird "abgebucht", sobald der Endkunde Ihre Responser erhält. Wenn der Endkunde den Dienst zahlen kann, wird "abgebucht". Das Ergebnis wird dem Händler in einem anderen Request zugesendet.

AOneBill Request Protocol

Requests für den SMS MO Prozess:

parameter description
Constant Parameters
msg Text der SMS, die vom Endkunden gesendet wurde, beinhaltet das Keyword.
date Datum und Uhrzeit zu der die SMS eingegangen ist. Erforderliches Format: YYYY-MM-DD hh:mm:ss.
operator Name des Netzbetreibers
operator_id ID des Netzbetreibers
user_id End-user ID
smsid Unique ID der SMS
cost Partner Verdienst in euro
abonent_cost Endkunden-Preis (exkl.) MwST.
abonent_currency Endkunden-Währung
in_hold In zu halten, den Wert 0 (sms sofort bezahlt) und eine (sms holded). Wiedergutmachung für das gefrorene SMS wird an die Ballance gutgeschrieben werden erst nach dem Manager wird diese sms, um Betrug zu überprüfen.
num Shortcode
country Der ISO-Code des Landes (http://www.iso.org/iso/country_codes/iso_3166_code_lists/english_country_names_and_code_elements.htm)
skey Dieser Paramter beinhaltet den Code zur Verifizierung, den Sie in Ihren Bezahltdienst Einstellungen eingerichtet haben. Benutzen Sie diesen AoneBill-Requests, um von anderen Requests zu unterscheiden.
Das skey Parameter wird wie folgt gebildet: Dem smsid Parameter folgt  in der nächsten Zeile der Verification Code, dann folgt der md5 Algorithmus. PHP Code:

$skey = md5( $smsid . $verification_code );
Sie müssen den erhaltenen Skey Parameter prüfen und mit dem Handler-Value vergleichen.
Optionale Parameter  
test Test-Request, value 0 (kommerzielle Verwertung) und 1 (test). Der gewöhnliche SMS-Request während der kommerziellen Verwendung beinhaltet diesen Parameter nicht.
retry Dieser Parameter erscheint wenn die erste Verbindung zu Ihrem Server fehlgeschlagen ist und SMS gestaut wurden. Der erste "Retry" wird in der ersten Minute nach der fehlgeschlagenen Verbindung vollzogen. Der Nutzer erhält die SMS zu dem Fehler. Alle weiteren Requests nutzen die folgende Regel: Zu der aktuellen Zeit werden 5 Minunten addiert, multipliziert mit der Anzahl der "Retryies". Es darf nur 16 "Retries" geben. Wenn einer der "Retries" erfolgreich war, bekommt der Nutzer die Response des angebotenen Dienstes. Wenn die Verbindung vom ersten Versuch ohne "Retries" erfolgreich hergestellt wurde, erscheint kein "retry" Parameter im Request.
logic Dieser Parameter gibt die Tarife an. Wenn der Netzbetreiber MT-Billing verwendet, erscheint der Parameter mit dem Wert 1 in im Request. MO tariffication  means that the user is charged after the receiving of response you’re your server.
This parameter appears with value equal to 1 or doesn’t appear at all if the MobileOperator uses MO tariffication, when the user is charged in the moment of message sending.

Response format:

status: reply
[empty line]
Response-Text

Text Limit:

  • 70 Characters bei "Latin" (UTF-8)
  • 160 Characters bei "Pure Latin" (7 bit)

 

Additional Request

Ist relevant, wenn die MT Logik eingesetzt wird, dass Sie, nachdem der Endkunde die Response erhält, einen zusätzlichen Request mit der gleichen sms_id: erhalten.

Parameter Beschreibung
action=mt_status Dieser Parameter indiziert den Request des "delivering status" der SMS MT.
smsid "Unique ID" der SMS
pay_status ->Dieser Parameter beinhaltet, ob der Betrag erfolgreich vom Endverbraucher abgebucht wurde (“ok”) oder nicht (“not_ok”).