ITNS (Instant Transaction Notification Service)

The AffiliCon system allows you as a vendor to receive and process information about successful sales and other transactions such as returns fully automatically in real time via Instant Transaction Notification Service (ITNS).

The service offers you a connection solution for any system that can process POST calls.

We already offer ready-to-use and easy-to-configure connections to well-known email marketing systems such as CleverReach, GetResponse, Klick-Tipp and AWeber, to membership management systems such as Digimember or ContentPower and to customer management tools such as Infusionsoft or ONTRAPORT, which can usually be activated with just a few steps in the "Connections" tab in the My area:

ITNS Anbindung einrichten bei AffiliCon


However, if you want to control scripts you have written yourself or systems that have not yet been integrated, such as iContact, our classic ITNS connection is the method of choice.

ITNS Anbindung einrichten bei AffiliCon

Rating

Header
Header

ITNS-URL

Enter your URL here, behind which the script is located that we are to address.

We hereby send you information to your own system, which can trigger an action selected by you: e.g. create member accesses, block on return and chargeback, add customers to newsletters.

Secret key

Enter a secret key here. The entry is voluntary.

The "Secret key" (secret key) signs the telegram so that it is clear that it comes from us.

Prefix

You can enter a prefix here.
You can also leave this field blank.

Choose letters and numbers for the prefix.
You can usually use software created for Clickbank if you enter a "c" for the prefix.


Setup on the side of your server

In order to receive the data on your server, you need a POST-enabled script which can be created in PHP, Perl or Ruby, for example.

The feedback to your system after successful payment or refund is done by us via a POST call to the URL you provided, which typically looks like this:

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

The script that receives and evaluates the data on your server could then look like this:

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

In addition to the variables directly supported by our system, you can also transfer your own information about the customer or purchase, such as a customer number or a 'tag', by using the GET parameter "custom" with the order link, which we then report back 1:1 via ITNS.

A call to our purchase link would then look as follows:

http://secure.affilibank.de/affilicon/start/product/1707/?custom=12345AbC

or

http://secure.affilibank.de/affilicon/index?product=1707&custom=12345AbC

Supported variables

VARIABLE

EXPLANATION

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).
→ 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

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:
* 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

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

When calling an SSL target domain (https), we check whether a valid certificate is available. If you work with SSL, your certificate must be valid.