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:
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.
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. | Choose letters and numbers 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). |
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
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.
