affilicon Hilfecenter https://www.affilicon.net/

ITNS (Instant Transaction Notification Service)-Anbindung

Owned by Dennis Heng (Unlicensed)
Last updated: Dec 18, 2018 by Sebastian Radatz (Unlicensed)

Das System der AffiliCon erlaubt Ihnen 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 Ihnen 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öchten Sie 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

 

Tragen Sie hier Ihre URL ein, hinter der das Skript liegt, welches wir ansprechen sollen.

Wir schicken Ihnen hiermit eine Information an Ihr eigenes System, das eine von Ihnen ausgewählte Aktion auslösen kann: z.B. Mitgliederzugänge erstellen, bei Rückgabe und Chargeback sperren, Kunden in Newsletter eintragen.

Secret key

 

Tragen Sie 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.

Wählen Sie für den "Secret key" Buchstaben und Zahlen.

Präfix

 

Hier können Sie einen Präfix eingeben.

Sie können dieses Feld auch frei lassen.

Wählen Sie für den Präfix Buchstaben und Zahlen.

Für Clickbank erstellte Software können Sie meist mitbenutzen, wenn Sie bei Präfix ein "c" eintragen.

 

Einrichtung auf Seiten Ihres Servers

Um die Daten dann auf Ihrem Server entgegennehmen zu können, benötigen Sie dort ein POST-fähiges Skript welches z.B. in PHP, Perl oder Ruby erstellt werden kann.

Die Rückmeldung an Ihr System nach erfolgreicher Bezahlung oder Erstattung erfolgt durch uns mittels eines POST-Aufrufes an die von Ihnen hinterlegte URL, welche typischerweise wie folgt aussieht:

http://www.yourserver.com/abcd/yourscript.php 

Das Skript, welches auf Seiten Ihres 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 können Sie 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

Vom System der affilicon unterstützte Variablen:

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 Sie mit SSL arbeiten, muss Ihr Zertifikat gültig sein.

Bei weiteren Fragen wenden Sie sich gerne an unseren Support unter https://support.affilicon.net/contact/ oder über clients@affilicon.net.

Wir freuen uns über Ihre Nachricht.