Das System der AffiliCon erlaubt Dir als Vendor per Instant Transaction Notification Service (ITNS) in Echtzeit Informationen über erfolgreiche Verkäufe und andere Transaktionen wie z.B. Rückgaben vollautomatisch zu empfangen und zu verarbeiten.
Der Service bietet Dir eine Anbindungslösung für jedes beliebige System an, welches POST-Aufrufe verarbeiten kann.
Wir bieten bereits fertige und leicht zu konfigurierende Anbindungen an bekannte E-Mail-Marketing Systeme wie z. B. CleverReach, GetResponse, Klick-Tipp und AWeber, an Membership-Verwaltungssysteme wie z.B. Digimember oder ContentPower und an Kundenmanagement-Tools wie z.B. Infusionsoft oder ONTRAPORT an, welche in der Regel mit wenigen Schritten im My-Bereich im Reiter "Anbindungen" aktiviert werden können:
Möchtest Du jedoch selbstgeschriebene Skripte oder bisher nicht integrierte Systeme wie z.B. iContact ansteuern, so ist unsere klassische ITNS-Anbindung das Mittel der Wahl.
Rating | Header | Header |
|---|---|---|
ITNS-URL | Trage hier Deine URL ein, hinter der das Skript liegt, welches wir ansprechen sollen. | Wir schicken Dir hiermit eine Information an Dein eigenes System, das eine von Dir ausgewählte Aktion auslösen kann: z.B. Mitgliederzugänge erstellen, bei Rückgabe und Chargeback sperren, Kunden in Newsletter eintragen. |
Secret key | Trage hier einen Geheimschlüssel ein. Die Eingabe ist freiwillig. | Der "Secret key" (Geheimschlüssel) signiert das Telegramm, damit deutlich ist, dass es von uns kommt. |
Präfix | Hier kannst Du einen Präfix eingeben. | Wähle für den Präfix Buchstaben und Zahlen. |
Einrichtung auf Seiten Deines Servers
Um die Daten dann auf Deinem Server entgegennehmen zu können, benötigst Du dort ein POST-fähiges Skript welches z.B. in PHP, Perl oder Ruby erstellt werden kann.
Die Rückmeldung an Dein System nach erfolgreicher Bezahlung oder Erstattung erfolgt durch uns mittels eines POST-Aufrufes an die von Dir hinterlegte URL, welche typischerweise wie folgt aussieht:
http://www.yourserver.com/abcd/yourscript.php
Das Skript, welches auf Seiten Deines Servers die Daten entgegen nimmt und auswertet, könnte dann beispielsweise wie folgt aussehen:
i
<?php
$empfaenger = $_POST['custemail'];
$betreff = 'Danke!';
$nachricht = 'Hallo '.
$_POST['custfullname'].
', danke, dass Sie mein Produkt gekauft haben!';
$header = 'From: test@test.de';
mail($empfaenger, $betreff, $nachricht, $header);?>
/**
* Build signature hash string for posted params
*
* @param $post
* @param $token
* @return string|null
*/
private function build_validation_hash($post, $token) {
if (is_array($post)) {
ksort($post);
$verifystring = "";
foreach ($post as $key => $value) {
if ($value !== null && $key != [secret key] {
$verifystring .= $value . '|';
}
}
$verifystring .= $token;
return strtoupper(substr(sha1($verifystring), 0, 8));
}
return null;
}
Neben den von unserem System direkt unterstützten Variablen kannst Du zudem auch über die Verwendung des GET-Parameters "custom" eigene Informationen über den Kunden oder Kauf wie z.B. eine Kundennummer oder ein 'tag' beim Bestelllink mit übergeben, den wir 1:1 per ITNS dann wieder zurückmelden.
Ein Aufruf unseres Kauflinks sähe dann beispielhaft wie folgt aus:
http://secure.affilibank.de/affilicon/start/product/1707/?custom=12345AbC
oder
http://secure.affilibank.de/affilicon/index?product=1707&custom=12345AbC
Unterstützte Variablen
VARIABLE | ERKLÄRUNG |
|---|---|
custfullname ; | Customer’s full name 1-510 Characters |
custfirstname ; | Customer’s first name 0-255 Characters |
custlastname ; | Customer’s last name 0-255 Characters |
custzip ; | * Customer zip |
custcc ; | * Customer country code 0-2 Characters |
custshipto ; | * Customer’s shipto name: 0-255 Characters |
custaddr1 ; | * Customer’s shipping address: field 1 0-255 Characters |
custaddr2 ; | * Customer’s shipping address: field 2 0-255 Characters |
custcity ; | * Customer’s shipping address: City 0-255 Characters |
custshippingzip ; | * Customer’s shipping address: Zip |
custshippingcountry ; | * Customer’s shipping address: Country 0-255 Characters |
custemail ; | Customer email 1-255 Characters |
custphone ; | Customer phonel 1-255 Characters |
prodid ; | Affilicon vendor product id 1-5 Characters (is send in the message and is documented). |
prodtitle ; | Title of product at time of purchase 0-255 Characters |
prodtype ; | Type of product on transaction (STANDARD or RECURRING) 8-11 Characters |
transaction; | Action taken 4-15 Characters:* SALE The purchase of a standard product or the initial purchase of recurring billing product. |
billno ; | Count of the recurring payment. Default 1 for standard payments. |
aboid ; | Only for Abonnements: Abonnement-ID |
aboend ; | Only for Abo cancelations “CANCEL-REBILL”: end date of Abonnement (e.g. 2013-04-03) |
transaffiliate ; | Affiliate on transaction 0-10 Characters |
accountammount ; | Amount paid to party receiving notification (in cent (1000 = €10.00)) 3-10 Characters |
orderamount ; | Order total amount (in cent (1000 = €10.00)) 3-10 Characters |
transpaymentmethod ; | Method of payment by customer 0-4 Characters: |
currency | Customer’s payment currency 3 Characters |
transvendor ; | Vendor on transaction 5-10 Characters |
tranreceipt ; | AffiliBank receipt number 8-13 Characters |
rfndreceipt ; | Only for RFND and CGBK: AffiliBank refund receipt number 8-13 Characters |
subid; | First Subid Tracking Param (data1 paramater) |
data1 ; | First Subid Tracking Param (parameter used in the url for tracking affiliates) |
data2 ; | Second Subid Tracking Param (parameter used in the url for tracking affiliates) |
custom | Individual customer parameter. Could be set in your payform (e.g. ?custom=1234) |
verify ; | Used to verify the validity of the previous fields 8 Characters |
transtime ; | The Unix Epoch time the transaction occurred 10 Characters |
orderlanguage ; | The language code (0-2 characters) used in the orderform/checkoutform |
proditem ; | Old article id used for compatibility reasons |
taxamount ; | Tax amount (in cent (1000 = € (10.00)) 3-10 Characters |
shippingamount ; | Shipping costs amount (in cent (1000 = €10.00)) 3-10 Characters |
transrole ; | String 'VENDOR' (Length=6 |
cart ID ; | Cart id for the transaction if cart widget is used |
noticeversion ; | Version of the Classical ITNS |
i
Wir prüfen beim Aufruf einer SSL-Zieldomain (https), ob ein gültiges Zertifikat vorliegt. Falls Du mit SSL arbeitest, muss dein Zertifikat gültig sein.
