|
|
How to Integrate EDDCS with Your Software using PHP for Download Delivery Confirmation
EDDCS.com provides third-party delivery confirmation for digital download
products. For details on the service, visit www.eddcs.com.
This document shows how you can easily add this revolutionary service to your
web software for added protection against fraudulent "item not received"
chargeback claims for your download products.
FIRST THINGS FIRST:
You must obtain a current copy of the EDDCS API from eddcs.com. Simply visit
the site, create a free developers account, and download a free copy of the
API. The API is encoded with ionCube, so you need to make sure that your
web hosting company supports it natively, or if you will need to use an
ionCube runtime loader to use the software. Most web hosts already have
ionCube available, as it is required by some key system support software
applications. If they don't, it's not a big deal either, as you can obtain
free runtime loaders from ionCube to run the software anyway... The EDDCS
API comes with test software for you to use to determine if your host is
configured to use ionCube, and/or what version of the runtime loader you
need to use.
We have been using the EDDCS for quite a while, and are very pleased with the
service, it's low cost, and it's capabilities. It's nice to finally be able
to see that a customer has downloaded his/her download purchase from us, and
be able to share this information with others (including payment processors).
As with any modification to software, make sure you make a backup copy of
the file you are about to change before making changes to it.
HOW TO INTEGRATE EDDCS WITH YOUR PHP SOFTWARE:
Once you have a copy of the EDDCS API, and have configured it for use,
look for the following lines (or something similar) in your PHP software.
Some common filename conventions to start your search:
dl.php, download.php, file_dl.php
Code to find:
header("Content-Type: Application/octet-stream");
header("Content-disposition: attachment; filename=" . $file);
There may be more header lines that are used to control the web browsers
cache, etc., but the two lines above are the critical ones used to deliver
your file. These two simple lines cause a visiting web browser to open a
download dialog box to send the file contents in the $file variable.
Once you find the header() function calls that control sending a download
to your customer, simply cut and paste the following lines "BEFORE" the
header() calls:
// INCLUDE THE IONCUBE ENCODED EDDCS API
include('eddc_api.php');
// EDDCS GET CONFIRMATION NUMBER - PASS ORDER ID OR NAME IN CUSTOM FIELD FOR
// REFERENCE ON EDDCS
$eddc_dc = eddc_get_confirmation_number($custom);
if ( ($eddc_dc) && ($eddc_dc != -1) )
{
// EDDCS SEND DOWNLOAD FILE TO YOUR CUSTOMER - MONITOR PROGRESS
// AND CONFIRM DELIVERY
eddc_sendfile(DIR_FS_DOWNLOAD . $file, $eddc_dc, 0);
// EDDCS STOP/EXIT - DO NOT EXECUTE CODE BELOW THIS SECTION
exit;
}
The $custom variable in the code above is used as a reference code that you
can use in your eddcs.com account to link an order number, customer name,
or other data from your customer.
That's all there is to it! Integration complete. You could create a tighter integration into the software you
use by storing the delivery confirmation number in your system, or any other change that you
think would benefit you the most.
|
|
