ITNS (Instant Transaction Notification Service)-Anbindung

Inhaltsverzeichnis

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.

Klassische ITNS-Anbindung - Konfiguration

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.
Du kannst dieses Feld auch frei lassen.

Wähle für den Präfix Buchstaben und Zahlen.
Für Clickbank erstellte Software kannst Du meist mitbenutzen, wenn Du bei Präfix ein "c" einträgst.

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:

Beispiel-Code

<?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);?>

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 phone 1-255 Characters

prodid ;

Affilicon vendor product id 1-5 Characters (is send in the message and is documented).
→ Use prodtype to distinguish between standard and recurring products.

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.

* RFND The refunding of a standard or recurring billing product. Recurring billing products that are refunded also result in a “CANCEL-REBILL” action.

* CGBK A chargeback for a standard or recurring product.

* R-SALE Recurring Payment (Ratenzahlung / installment)

* BILL Recurring Payment (Abonnement)

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

accountamount ;

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:* PYPL – PayPal

* VISA – VISA

* MSTR – MasterCard

* ELV – Lastschrift Deutschland

* IBAN – EU-Lastschrift

* WIRE – Überweisung

* PYPL - PayPal

* SFRT - Sofortüberweisung

* TEST - Testkauf

String 'UNKN' * UNKN - means unknow payment method

currency ;

Customer’s payment currency 3 Characters

transvendor ;

Vendor on transaction 5-10 Characters

transreceipt ;

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)

cartid ;

Cart id for the transaction if cart widget is used

noticeversion ; 

Version of the Classical ITNS

Hinweis

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.