Download Fulfillments
Home     Help

Vendor System Documentation

For a general introduction to our service and comon questions, visit: http://www.DownloadFulfillments.com/vendor_intro.shtml

General Concepts

Welcome to the Download Fulfillment System. This service allows you to provide secure electronic downloads of documents and programs to your customers without the need to host and manage the downloads yourself. You can place fulfillment orders online, or connect your order system to ours through our automated and secure HTTPPOST interface. Your customers can return to our web site service to download their orders at any time. Customers must provide their e-mail address to download their orders, and our system automatically monitors all downloads for potential hacking and malicious download activity.

Never worry about your customers getting their downloads again, or whether your products are being maliciously copied to other users!

Here are some important terms we use throughout the documentation and system:

  • Vendor: A vendor is the merchant, you, who uses our service to provide your customers with electronic downloads. A vendor gets a login id and password to manage your account online.

  • Customer: This is your customer (not ours), that you want to receive an electronic download through our service.

  • Download: An electronic download, such as a PDF, ZIP or EXE file, that you wish provided to your customers through our service. We host the downloads on our own servers in a safe and secure manner (customers cannot directly access the download files).

  • Vendor download: A download a vendor is signed up to allow his customers to receive. Not all downloads are available to all vendors. A vendor may provide us with a download that only he can have access too. Some of our downloads (such as our PDF e-books) are available for all vendors to sell.

  • Download fulfillment: When a vendor uses our online system to give a customer a download, this is called a download fulfillment. A vendor can manually enter a download fulfillment for a customer online in our system, or automate the process through our secure HTTPPOST interface (i.e. if you want to connect your order system to ours).

  • Fulfillment cost: The cost to the vendor to fulfill a customer order. This varies, depending on whether it is one of our downloads (i.e. one of our PDF e-books), or one of yours. The minimum fulfillment cost for a download provided by a vendor is $2.50.

  • Vendor payment: We do not take your customer orders... you do. As such, you are collecting the customer's payments, not us. Each download has a fulfillment cost associated with it, which you pay us. We generate monthly reports and bill you for your download fulfillments directly to the credit card you provided when you signed up with us.

  • Customer download: This is an occurence of a customer downloading his actual ordered item. When a vendor enters a download fulfillment order, the customer is sent an e-mail notice telling him how to get his download (or optionally, the vendor can have our system not e-mail the customer, and instead the vendor can e-mail the customer themselves). The download is not e-mailed to the user directly for security: they are provided a simple web address to download their orders.

    A customer must enter his e-mail address to download his purchases. Our system tracks each fulfillment download, the IP address from which it originates, and even displays the total number of his downloads to the customer. The customer may return as often as they wish to download their orders, but we monitor all activity carefully. After 4 downloads of a single order from a customer, our system alerts us of suspicious activity. If we think fraudulent downloads are occuring (such as a customer sharing his download information with other people), we immediately disable the download for that customer. In this rare case, the customer must contact us to re-enable their download.

  • Payee: Some of our downloads require commissions or license fees to be paid to third parties for the fulfillment order. Each download can have any number of payees associated with it, who are paid a custom commission for orders containing that download. Payee relationships can have a valid date range (for expiring license arrangements). Payees are not normally accessible to vendors in our system. Note that payees are associated with downloads. If you wish to have payees for your downloads, please contact us directly to discuss this.

  • Payee commission: The amount owing to a payee for a download.

    Your Account

    Your account must be created by DeepNet Technologies. Contact us by e-mail if you do not have an account yet and want one: support@DownloadFulfillments.com.

    The following information is needed to create a Vendor account:

    • Contact name: name of a contact person in your company responsible for the vendor account.
    • Contact phone #:: only for us to contact the vendor (not provided to customers).
    • Contact email: only for us to contact the vendor (not provided to customers).
    • Support email: this is provided to customers when they place fulfillment orders, as a contact to where they purchased the product.
    • Company name: the name of your company, and shown to customers.
    • Address: your company address, used for official correspondence only by us (not provided to customers).
    • Web URL: your company web site URL, displayed to customers.
    • Credit card account: Your monthly downloads are billed directly to your credit card approximately monthly, near the start of the month (you will be e-mailed an invoice). We require: credit card type, number, card holder name, and expiration (month/year). These payments will show up on your credit card bill as ' Research Services Unlimited'.
    • User id: a login user id will be assigned to your account by us.
    • Password: a login password will be assigned to your account by us. You can change your password at a later time.

    We will create your account, and send your login information for you. You can then add downloads to your account and begin fulfilling orders.

    Our Web Site

    The Download Fulfillment System is hosted at:

    http://www.DownloadFulfillments.com/

    Customer Web site

    When you fulfill orders, customers will be directed to this page:

    http://www.DownloadFulfillments.com/download.php3

    You can direct all customers to the page above if they contact you regarding re-downloading their purchases.

    Vendor Web Site

    All vendor services (including this documentation) are available at our web site:

    http://www.DownloadFulfillments.com/admin.php3

    Bookmark the page above so you can return to it later. Do not provide the vendor web site address above to customers.

    Vendor Login

    All activity on your Vendor account requires you to login with your vendor user id and password. These are stored locally in your browser as cookies once entered, so you do not have to enter them again when you return using the same computer (the password cookie is encrypted for security). If your browser does not have cookies enabled, then you will have to login every time you return to the vendor site.

    Vendor Downloads

    Not yet implemented. TODO.

    Download Fulfillment: Web Request

    Use this web page to manually place a fulfillment order:

    http://www.DownloadFulfillments.com/vendor_fulfill.php3

    Enter the customer e-mail address, the customer name, the download you want them to receive, and whether you want them to be notified by e-mail with download instructions.

    If you do not request e-mail notification to the customer, then you should contact them yourself to let them know how to download their order. The fulfillment confirmation screen provides sample e-mail text you can use in this case (this is what is sent by e-mail to the customer by us, if you requested it).

    To place a test order, use your vendor contact e-mail address for the customer e-mail address. This will flag the order as a test order, and you will not be billed for it.

    For all real download fulfillments, you will receive a notification e-mail summary (at your vendor contact e-mail address). This provides security so you know your account is not used fraudulently.

    Download Fulfillment: HTTPPost

    You can use our HTTPost fulfillment system to fully automate your download orders. Use this web address within your order system:

    http://www.DownloadFulfillments.com/vendor_fulfillment_add.php3

    The URL above is not intended to be used manually in a browser. The following parameters are required when using this URL:

  • httppost (required): Set to 1 for httppost processing. This prevents normal browser output from occurring.

  • uid (required): Set to your vendor user id.

  • pwd (required): Set to your vendor user password (do not encrypt this parameter).

  • customer_email (required): The e-mail address of the customer order to fulfill. If you set the 'customer_email' to your vendor 'contact_email', then this is considered a test order and you will not be billed for it.

  • customer_name (optional): First + Last. i.e., "Dan Pronovost". You can use spaces in the URL, or encode them as '%20' if you prefer. Quote characters (single or double) are also allowed. While you do not have to provide the customer's name with the download fulfillment order, it will help us later if a customers having trouble with downloading (for example, if they can't remember the e-mail address they used when they ordered).

  • vendor_download_id (required): The numeric id of the download for the customer. These are displayed on the 'vendor_fulfill.php3' page, in the drop down list of Download items ('id').

  • send_email (optional): Set to 1 if you want the customer to be e-mailed automatically, or 0 if you do not want us to e-mail the customer.

    Calling the HTTPPost vendor fulfillment URL returns non-HTML plain text indicating the success or failure of the call.

    If you set the 'httppost' parameter to 0, then a normal HTML page is returned, the same as if you had used the 'vendor_fulfill.php3' page. Generally, there is no reason you should not set 'httppost' to 1.

    When the 'httppost' parameter to 1, then the following plain text is returned (each line separated by the newline '\n' character):

  • Line 1: the text 'success' or 'error'.

  • Line 2+: If line 1 is 'error', subsequent lines are internal error explanation text. There can be more than one line of error text. If line 1 is 'success', then subsequent lines are the text that was (or should) be e-mailed to the user.

    Here is an example HTTPPost calling URL:

    http://www.DownloadFulfillments.com/vendor_fulfillment_add.php3?httppost=1&customer_email=dan@deepnettech.com&customer_name=Dan Pronovost&uid=smartgaming&pwd=my_password&vendor_download_id=1&send_email=1

    Clear Vendor Cookies

    Use this link on the main vendor web site to clear the browser cookies containing your vendor login user id and password. This is useful if you want to login in under a different account.

    Vendor Report

    Use this form to see all your download fulfillments and vendor payments.

    The Fulfillment Summary section shows you the total number of fulfillments for each of your downloads (for the life of your account). The total fulfillment cost is displayed.

    The Vendor Payment History section shows you all the vendor payments processed to date to your credit card on file with us.

    The Monthly Fulfillment Report section can be used to get a detailed listing of each fulfillment for each month. Only months where there were downloads are displayed. Click on the 'Generate...' button and the report will be re-displayed with a detailed monthly listing at the bottom.

    Download Details

    This form displays important information about a download. Note that you cannot edit a download from this form (contact us if you have a new download you wish added, either just for you or for other vendors as well, with commissions accruing to you).

    A variety of information about the download is displayed. Note that The 'Title information' link is great place to get marketing and promotional material for the download.

    Payee Report

    This report shows you all of your payee commissions to date. This is income you've generated from downloads that are setup to accrue a commission to you. The report also shows payments made to you by us (these payments are mailed to you).

    Click on the 'Display detailed payees report' button to get a listing of each fulfillment that generated a commission to you.

    Payee Downloads

    This form shows you all of the downloads that will accrue a payee commission to you. You can click on the magnifying glass icon to view details about the corresponding downloads.

    Payees are a great way to have commissions paid directly by us to your partners who are owed royalties on each download fulfillment. Please cntact us if you wish have payees added for your downloads.

    View/Find/Edit Vendor Fulfillments

    Use this form to find specific fulfillments, and view or edit them. The main reasons you would do this would be refund an order, re-send a customer his fulfillment e-mail, or to re-enable or disable downloads on an order.

    Start by entering in either the customer's order number (this is e-mailed to them when you entered the fulfillment, and is unique), his e-mail address or name. You can enter a part of the customer's e-mail or name and it will find all matches (anywhere in the text of each). Clear all the fields prior to clicking the 'Find matching fulfillments' to view all your orders, sorted by descending date.

    Click on the 'pen' icon to the left of any row to edit the fulfillment and make changes.

    Edit Vendor Fulfillment

    Use this form to view or edit a specific fulfillment.

    The customer name and e-mail address can be edited as required. The 'Download status' field determines whether the customer is allowed to download his order or not. This could be disabled if the customer completed a question number of downloads, and it was disabled by us for security reasons. If the customer did this by accident and the download was disabled, you can re-enable the downloads here.

    If the download allows refunds, then a checkbox is displayed allowing you to refund this order. The refund fee, if any, is noted on this form as well. Checking this option simply replaces the fulfillment cost charge on your account with the refund (i.e. no action results from checking this box, such as e-mailing the customer). Once a fulfillment is refunded, the customer will not be able to download his order.

    Click on the "Resend fulfillment e-mail" button to re-send the customer his original order e-mail message. This includes all the details about his fulfillment, including the special link to use to get his download. This is useful in the customer did not receive his order e-mail initially (for example, due to spam filtering), and you want to resend it.


  • Copyright 2007, DeepNet Technologies. www.DeepNetTech.com. For help, e-mail us: support @ deepnettech . com