Share via E-Mail
Share on Google Buzz
Share on Twitter
Share on Facebook
E-junkie Blog
E-junkie FaceBook Page
E-junkie @ Twitter

Integrating E-junkie With 3rd-Party & Custom Services

How can I have E-junkie post the order data to a URL?
With what third-party services is E-junkie pre-integrated?

E-junkie can transmit all the order data to your URL only for successful completed payments. We submit this data via HTTP POST, so any generic form-handler type of script (such as typically used for receiving an HTML form submission) should be able to receive and parse the order data however you wish. If your server fails to respond when E-junkie attempts to submit order data to it, our system will not retry but will normally email a notification of the failure to your E-junkie Login Email address.

Our data transmission follows the format of PayPal IPN but includes extra fields containing order data we have that PayPal does not send. Any script that can receive PayPal IPN should be able to receive our order data, as long as it can handle or ignore our extra fields and does not attempt to validate the IPN with PayPal (which would fail since we are not PayPal, and we validate the actual PayPal IPN in the first place before sending order data anyway). Since we can do this regardless of the buyer's checkout method, this means you can have E-junkie send a PayPal-style IPN even for checkouts that did not go through PayPal.

To have order data sent to the same URL for all purchases, you can specify your URL in Seller Admin > Account Preferences as the Common Notification URL.

You can also/instead have order data sent when a specific product is purchased, or specify a different URL to receive purchase data for each product (the following steps are not necessary if you're only using a Common Notification URL):

  1. While adding or editing your product, check Send transaction data to a URL in the first screen of product settings;
  2. Click the More Options button if you are adding a new product, or click the Next button if you are editing an existing product;
  3. In the Payment Variable Information URL field, paste the URL where your custom/3rd-party script will receive the order data;
  4. Click the Next button till you can Submit settings to reach the button codes screen;
  5. Use the E-junkie Cart or Buy Now button codes from this screen to start selling your product (if you had already copy-pasted the button code for this product and made no other changes to the product, the existing buttons in your site will continue to work fine).

Common Order IPN Data

  • payer_email
  • txn_id - Transaction ID generated by payment processor (for non-PayPal txns we add a prefix: gc- for google checkout, au- for authorize.net, 2co- for 2checkout, cb- for clickbank and tp- for trialpay payments)
  • first_name
  • last_name
  • mc_gross - total amount of payment
  • custom - if you added &custom=someValue to the url in the shopping buttons you got from e-junkie
  • mc_shipping
  • tax
  • invoice - unique invoice id that we generate
  • for_auction
  • auction_buyer_id
  • address_name - ship-to full name if different from billing (buyer) name
  • address_street
  • address_city
  • address_state
  • address_zip
  • address_country
  • address_country_code - shipping address 2-letter ISO country code
  • address_phone
  • address_business_name - shipping address company name (if provided)
  • payer_business_name - billing address company name (if provided)
  • payer_phone - billing phone
  • residence_country - billing country (if supported by payment processor)
  • charset - this should normally be 'utf-8', as we now convert order data into UTF-8 from whatever charset was sent by the payment processor (in very rare cases this may identify the original charset if conversion to UTF-8 cannot be done)

Item Specific IPN Data

Here, X represents the position of each item in the buyer's cart:
  • item_nameX
  • item_numberX - item number you have set in product configuration
  • quantityX - quantity sold
  • mc_gross_X - sale price for this product * quantity sold
  • option_name1_X - (if applicable) if you are using any options with your products, then this will contain first option's name
  • option_selection1_X - (if applicable) if you are using any options with your products, then this will contain first option's value that buyer selected
  • option_name2_X
  • option_selection2_X
  • option_name3_X
  • option_selection3_X

E.g., the first item in the buyer's cart would be identified with item_name1, item_number1, quantity1, etc. while the second cart item would be item_name2, etc.

Additional Non-IPN Variables

The following variables are unique to our system and will be passed to your Integration URL(s) in addition to the order data we get from the payment processor. These are not part of the standard PayPal IPN data set, so any IPN-compatible scripts or third-party services you're using with our Integration feature must be able to handle or ignore these fields.

Item Specific Non-IPN Data

These are only sent to Payment Variable Information URLs (not to a Common Notification URL):
  • item_cart_position - this identifies which particular item in the order triggered a given submission to a product-specific Payment Variable Information URL (which receives the full data for all items in the order), so you can match this to the value of X in the Item Specific IPN Data variable names (listed above) to identify which details in the submission pertain to that particular item -- e.g., if you receive item_cart_position=2, you'll know that submission was triggered by the second item in the buyer's cart, corresponding to item_name2, item_number2, etc.
  • sku - Only applicable if you also configured "Variants having individual price..." for the item which is sending order data to your URL, this is the SKU you'd configured for the particular Variant of that item which the buyer ordered.
  • expiry_hours - (if applicable) maximum number of Hours you allow your download links to be valid for in your product configuration
  • max_downloads - (if applicable) maximum number of download Attempts you allow in your product configuration
  • affiliate_fee - (if applicable) commission earned on the item by your E-junkie affiliate
  • key - (if applicable) stored or generated registration key sent to the buyer (not sent to keygen URLs)

Common Order Non-IPN Data

These are sent to both a Common Notification URL and Payment Variable Information URLs:
  • from_name - your Display Name in E-junkie profile
  • from_email - your Display Email in E-junkie profile
  • country_mismatch=true - only sent if country selected in cart does not match the one given during a PayPal Website Payments Standard checkout (other checkout methods cannot mismatch)
  • zipcode_mismatch=true - only sent if postal/zipcode given in cart does not match the one given during a PayPal Website Payments Standard checkout (other checkout methods cannot mismatch)
  • client_shipping_method_id - - # of the Shipping Rule applied in buyer's cart
  • shipping_method_type - Shipping Rate Calculator for the Shipping Rule applied in buyer's cart
  • shipping_method_desc - Shipping Method Description for the Shipping Rule applied in buyer's cart
  • discount_codes - Discounts applied to the order
  • buyer_ip - public IP address assigned to buyer's computer or router at the time of checkout
  • ej_txn_id - our internal ID for this transaction, an unsigned integer value (often useful when the standard txn_id is too long for some field in your software; this is also the only order ID we reveal to your affiliates when they earn commission on a sale)
  • txn_type - checkout method used:
    • cart (PayPal Website Payments Standard - cart order)
    • web_accept (PayPal Website Payments Standard - Buy Now button)
    • expresscheckout (PayPal Website Payments Pro Express Checkout using a PayPal account)
    • ppdirect (PayPal Website Payments Pro Direct Payment using a card)
    • gc_cart (Google Checkout)
    • authnet (Authorize.net)
    • cb (ClickBank)
    • 2co_cart (2CheckOut)
    • tp (TrialPay)
    • ejgift (E-junkie Free Checkout)
  • handshake - md5(your_e-junkie_login_email+md5(your-e-junkie-password))
    You can use this variable to ensure that the data is coming from E-junkie's server. We take an md5 hash of your E-junkie password, then tack your E-junkie login email in front of that hash, then re-hash the whole thing in md5 again. If your E-junkie login email and password became known to someone else, they could forge this hash. If you ever change your E-junkie login email and/or password, you'd need to update the hash reference in your keygen script. You can use any scripting language of your choice to compare the handshake hash we pass against a matching hash at your end. Here's an example using PHP:
    <?php
    // Put this in the top of your script, so if the handshake
    // does not match, it will exit, but otherwise it runs the
    // rest of your script:
      if ($_POST['handshake']!==md5("your@login.email".md5("your_e-junkie_password")))
      {
        exit;
      }else {
    // Here is where you do whatever you wish with the order
    // data variables. To illustrate the point, this example
    // will just email the data to a given address:
        mail ("your@email.address.com","post from e-junkie", print_r($_POST,true));
      }
    ?>

What 3rd-party services already support E-junkie Integration?

These services are known to already accept our standard Integration submissions, without requiring you to perform any additional custom programming. If you represent a service that can accept PayPal-IPN-style order data from our system and wish to be listed here, please contact us.

ConsoliBYTE QuickBooks Integration for E-junkie

If you use QuickBooks to help manage your business, you may be interested in using ConsoliBYTE QuickBooks integration for E-junkie to automatically enter E-junkie order data into your QuickBooks and also:

Continuata advanced download management

If you have a need for more sophisticated download-management features beyond what's already provided by E-junkie's own built-in download delivery system, we can now integrate with Continuata by simply pasting the URL they provide into your product's Payment Variable Information URL setting. Please contact Continuata for further information, pricing, and more detailed integration instructions.

Email marketing & mailing list services

These services maintain a list of email subscribers and allow you to send mass mailings to those subscribers. (This may sometimes be called an "auto-responder", though that term technically refers to sending an automated reply when an email is received, such as an "on vacation" message or a "we have received your email and will reply soon" confirmation.)

E-junkie Updates & Newsletters
For a nominal fee, we offer a built-in service to send occasional, basic Newsletters and issue free download links en masse for product Updates; see this help page for details. If you expect to email newsletters frequently or on an automated schedule, or if you need more sophisticated email marketing and list management features than we provide, the following options should meet that need and would probably be more affordable than extensive usage of our Updates & Newsletters service.
Aweber
Please see our section on Aweber integration below for details and instructions.
MailChimp
This help page on MailChimp's site explains how to integrate MailChimp with E-junkie.

On-demand CD/DVD duplication

You can use these companies' integration wtih E-junkie to have them automatically duplicate your product data to a CD or DVD and mail that to buyers on-demand whenever an order comes in, with NO minimum-order requirement. This may be more efficient and customer-friendly than expecting buyers to manage a large file download. E.g., a buyer with a typical 1.5Mbps broadband line would take well over an hour to download a full CD's worth of data, and several times longer than that for a full DVD, so why not offer at least the option of receiving a disc by mail instead?

Acutrack
First, register for an account with Acutrack CD/DVD fulfillment to get things set up at their end. Then, whenever you add or edit a CD/DVD product in your E-junkie Seller Admin:
  1. Check Shipping/Buyer's Address to collect the buyer's address at checkout;
  2. Check Send transaction data to a URL;
  3. Iin the Item Number field, enter the item's ProductID from Acutrack;
  4. Press the Submit button if you are adding a new product, or press the Next button if you are editing an existing product;
  5. In the Payment Variable Information URL field, please enter the following:
    https://acuservices.acutrack.com/productions1/ejunkie.aspx
  6. Press Next button till you can click Submit to save settings and reach the button codes screen;
  7. Use the E-junkie Cart or Buy Now button codes from this screen to start selling your product. If you were editing an existing product, use the new button code from this screen as it changes when you change the Item Number.
TrepStar
First, register for an account with TrepStar CD/DVD fulfillment to get things set up at their end. Then, whenever you add or edit a CD/DVD product in your E-junkie Seller Admin:
  1. Check Shipping/Buyer's Address to collect the buyer's address at checkout;
  2. Check Send transaction data to a URL;
  3. Associate your product's Item Number with a TrepStar Project ID. There are two ways about this:
    When adding a new product in E-junkie
    Set your E-junkie Item Number to match the TrepStar Project ID:
    1. Log into TrepStar.com;
    2. The Project ID is listed with your project title where your products are listed;
    3. Write down or copy the Project ID.
    4. Type or paste that TrepStar Project ID into the E-junkie Item Number field.
    When editing an existing product in E-junkie
    You can follow the method above, but since E-junkie button code references the Item Number, you would need to obtain new E-junkie button code to replace any existing E-junkie purchase button(s) for the product in your site.
    Preferred Method: Edit your TrepStar project settings to reference the existing E-junkie Item Number, so you won't have to replace the purchase button on your site:
    1. Write down or copy your E-junkie Item Number;
    2. Log into TrepStar.com;
    3. Edit your TrepStar Project associated with this product;
    4. Scroll to the bottom of the edit page to the Optional Advanced Variables section;
    5. Type or paste your E-junkie Item Number into the eCommerce ID String field;
    6. Save the TrepStar Project.
  4. Click Submit if adding a new product, or Next if editing an existing product;
  5. In the Payment Variable Information URL field enter the following:
    https://www.trepstar.com/eJunkieGateway.asp?TSmode=test&TSPub=
    • TSmode= can be either test or prod which tells TrepStar whether to actually fulfill the order or not:
      • TSmode=test means nothing will be made, and the TrepStar publisher will not be billed, yet order data still flows into the TrepStar system;
      • When testing is complete, change this to TSmode=prod to have TrepStar actually make and ship the product.
    • TSPub= should be followed by your TrepStar Publisher ID, normally a 5 digit number like 25640 (you can find your Publisher ID by logging into trepstar.com).
  6. Press Next button till you can click Submit to save settings and reach the button codes screen;
  7. Use the E-junkie Cart or Buy Now button codes from this screen to start selling your product.
    NOTE: If you were editing an existing product and changed the Item Number to match the TrepStar Project ID, use the new button code from this screen on your site, as the code changes when you change the Item Number.
SwiftCD
E-junkie is pre-integrated with SwiftCD; see below for details.

What other services is E-junkie pre-integrated with?

For your convenience, E-junkie provides an interface which you can use to interface with your SwiftCD account, Aweber and do other things like sending Sale Notification emails to other email addresses. It is an open-ended interface and you can specify a passthru URL where we can POST all the variables (as documented above) after our script is done.

PDF Stamping
We can stamp the buyer's name, email and their unique Transaction ID on the top-left of each page of the PDF they receive before they download it. See this help page for instructions and more information.
SwiftCD
If your product comes with a CD or DVD, and you are using SwiftCD to deliver it, follow the steps below while adding or editing your product to have E-junkie send SwiftCD your account and product data along with the buyer's shipping address for each successful transaction:
  1. Check Shipping/Buyer's Address to collect the buyer's address at checkout;
  2. Check Send transaction data to a URL;
  3. Enter your SwiftCD Item Number in the Item number field;
  4. Press the Submit button if you are adding a new product, or press the Next button if you are editing the product;
  5. In the Payment Variable Information URL field, please enter the following, all on one long line:
    http://www.e-junkie.com/ecom/o_plug.php?
    &swift_user=YOUR_SWIFTCD_USERNAME
    &packageid=YOUR_SWIFTCD_PACKAGE_ID
    &labelid=YOUR_SWIFTCD_LABEL_ID
    • If you already have http://www.e-junkie.com/ecom/o_plug.php? you do not need to repeat it, just add the above &name=value parameters to it.
  6. Press NEXT button till you can SUBMIT to reach the button code screen;
  7. Use the BUY NOW or E-JUNKIE CART buttons code from this screen to start selling your product. If you were editing the product, use the new button code from this screen as it changes when you change the Item Number.
NOTES:
  • If your product uses our registration code system, the codes will be passed to SwiftCD automatically along with the other necessary product and transaction information.
  • If you don't expect to meet SwiftCD's minimum-order contract requirements, consider using the Acutrack integration explained above.
Aweber
You can have new buyers automatically submitted to Aweber email list server for subscription to a mailing list you maintain there:
  1. In your Aweber account:
    1. Click on List Settings tab;
    2. Click on Parsers;
    3. Checkmark the box for E-junkie Parser.
  2. Choose one of the following:
    • If you want all buyers subscribed to the same Aweber list, go to the Seller Admin > Edit Account Preferences > Common Notification URL field;
    • If you only want buyers of some products subscribed, or want buyers subscribed to different lists according to the item(s) ordered:
      1. Check Send transaction data to a URL while adding or editing each product;
      2. Press the Submit button if you are adding the product, or press the Next button if you are editing the product;
      3. Find the Payment Variable Information URL field.
  3. In the relevant URL field, please enter (all on one long line):
    http://www.e-junkie.com/ecom/o_plug.php?
    &aweber=LISTNAME@aweber.com
    • LISTNAME should be the name of the Aweber mailing list you want new buyers subscribed to;
    • If you already have http://www.e-junkie.com/ecom/o_plug.php? you do not need to repeat it, just add the &aweber= parameter to it.
  4. Press NEXT button (if necessary) until you can SUBMIT to save changes.

NOTE: Newly subscribed buyers will receive an opt-in email from Aweber, with a link they must click to confirm their wish to subscribe. For checkout methods that support an opt-in/-out selection the buyer must opt-in for their email to be submitted to Aweber (PayPal Website Payments Standard does not have an opt-in/-out, so those buyers will always be opted-in automatically).

Multiple Emails
All notification emails from E-junkie are sent to the same email address you use to log into your E-junkie Seller Admin (you can change this in Seller Admin > Edit Profile).  If you wish to have an extra copy of order details sent to an additional email address (such as to a drop shipper or fulfillment house, or to a clerk at your own business):
  1. Choose one of the following:
    • If you want the extra notification to be sent for every order, go to the Seller Admin > Edit Account Preferences > Common Notification URL field;
    • If you only want the extra notification sent for certain products, or want extra notifications sent to different emails according to the item(s) ordered:
      1. Check Send transaction data to a URL while adding or editing each product;
      2. Press the Submit button if you are adding the product, or press the Next button if you are editing the product;
      3. Find the Payment Variable Information URL field.
  2. In the relevant URL field, please enter (all on one long line):
    http://www.e-junkie.com/ecom/o_plug.php?
    &m_emails=first@email.address,second@email.address,third@email.address,
    fourth@email.address,fifth@email.address
    • Our script will send the E-junkie notification email to all your specified emails, up to 5;
    • If you already have http://www.e-junkie.com/ecom/o_plug.php? you do not need to repeat it, just add the &m_emails= parameter to it.
  3. Press NEXT button (if necessary) until you can SUBMIT to save changes.
Passthru
If you want to use the above built-in integrations and also POST order data to your URL:
  1. Check Send transaction data to a URL while adding or editing your product;
  2. Press the Submit button if you are adding the product, or press the Next button if you are editing the product;
  3. In the Payment Variable Information URL field, please enter (all on one long line):
    http://www.e-junkie.com/ecom/o_plug.php?
    &postto=http://www.example.com/script.ext
    • The URL you submit to cannot have any &name=value query parameters of its own;
    • If you need order data POSTed to multiple URLs, you can use multiple &postto[]= parameters to specify each one, e.g.:
      &postto[1]=http://www.example.com/script.ext
      &postto[2]=http://www.otherexample.com/otherscript.ext
    • If you already have http://www.e-junkie.com/ecom/o_plug.php? you do not need to repeat it, just add the &postto= parameter(s) to it.
  4. Press NEXT button (if necessary) until you can SUBMIT to save changes.
Combining Integrations
You can make our o_plug.php integration do multiple things; combine any/all of the parameters described above onto one line in your Payment Variable Informaiton URL field, like so:
http://www.e-junkie.com/ecom/o_plug.php?
&swift_user=YOUR_SWIFTCD_USERNAME
&packageid=YOUR_SWIFTCD_PACKAGE_ID
&labelid=YOUR_SWIFTCD_LABEL_ID
&aweber=LISTNAME@aweber.com
&m_emails=first@email.address,second@email.address,third@email.address,
fourth@email.address,fifth@email.address
&postto=http://www.example.com/script.ext
This page added by E-junkieChef on July 16th, 2008 @ 5:38 pm GMT -7
Updated by E-junkieGuru on February 8th, 2012 @ 1:42 pm GMT -7

Pages in E-junkie Help:

view all features

  • Just $5 per month
  • No transaction limit
  • No transaction fee

sign-up to start selling for free

Questions?

  • Feel free to contact us if you don't find an answer in our Help pages or our Forums.
     
  • If you just want to enquire about what all E-junkie does, you can check our feature list.
30 Day Money Back Guarantee
PayPal Certified Integration
Google Checkout Certified Integration
Slam the Online Scam