External Download (EN)

General

The following describes the function of an external download. "External" means that the download is not provided by WEBSALE AG, but by an external system, which is linked to after purchase.

Identification of external download products

Products that are downloaded from an external system after purchase must be marked accordingly in the shop using the "ExternalDownload" flag. The value must be set to "y". A designer can handle each external download product accordingly in the templates and in the shopping cart and display the corresponding download link.
The external download link is also passed in the order data.

Linking to the external download system

As soon as an external download product is purchased, a download link is generated for each download item in the shopping cart.

This is displayed on the following pages:

  • Order confirmation page

  • Confirmation e-mail

  • Order history

 

A download link contains the following data:

Parameter

ID

Description

Required field

Parameter

ID

Description

Required field

Timestamp

1

UNIX timestamp at the time of generation. Number of seconds since 01.01.1970

yes

ShopID

2

The ShopID

yes

SubshopID

3

The SubshopID

yes

OrderID

4

The shop order number

yes

eMail

5

The eMail address of the customer

yes

CustomerNumber

6

The customer number, if available

no

UserIndex

7

The UserIndex of the shop, if available

no

ProductNumber

8

The product number

yes

Format:

https://<domain-external-system>/?dldata=<1>Timestamp</1><2>Shopid</2>...<8>ProductNumber</8>

Example:

https://<Domain-Externes-System>/?dldata=<1>1462879316</1><2>myshop</2>...<8>1234567890</8>

The data is not encrypted in plain text, but

  1. AES-256-bit-encrypted

  1. hex-encoded

In the 1st step, the data string "<1>1462879316</1><2>myshop</2>...<8>1234567890</8>" is AES 256-bit encrypted.

In the 2nd step the binary data is hex encoded.

The final link then has the following format:

https://<domain-external-system>/?dldata=aa125609cdeffa34321aab....

The encryption password is fixed on both sides and is provided by WEBSALE.

Secure payment methods

As soon as at least one external download product is in the shopping cart, only "secure" payment methods can be offered. Which payment method is considered secure (credit card, PayPal, Sofortüberweisung etc.) can be freely configured in the shop.