Using E-junkie to Sell Generated Codes
Selling codes provided by your own online code generator
These can be either a random code or dynamically-generated based on order data. If you have a Web-based code generator (like VBOlock), you can check the option "Generated codes" while adding or editing your product in E-junkie Seller Admin. You will need to enter the URL of your code generator in the "Generated Codes URL" field. All the order data will be sent to the URL you have specified for each product in the order individually.
The ONLY thing your URL should output is the code itself (HTTP headers are fine as our E-junkie will parse them out). Our system will then e-mail this code to your buyer. You can also customize your thank you page to display these codes to the buyer.
E-junkie will send all the order data using POST to your URL only for successful completed payments. Currently, if E-junkie server is unable to reach your server, it will not retry; in that case, we still finish processing the order without issuing a code to the buyer, and we email you a notification that your keygen URL failed to respond.
If you want the buyer's code displayed on their Thank-you Page, be sure to put something in the product's Message (HTML) field using [%codes%] wherever you want the buyer's code to be inserted (see our Thank-you Page customization help page for more information).
Common Order Data
- payer_email
- txn_id - transaction id of the payment. in some cases we add prefix to it (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
- shipping
- tax
- invoice - unique invoice id that we generate
- for_auction
- auction_buyer_id
- address_street
- address_city
- address_state
- address_zip
- address_country_code - 2 letter ISO country code
- address_phone
- payer_phone - billing phone
Item Specific
Here,
X represents the in-cart position of the item in this order:
- 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
- item_cart_position - this provides you with the value of X (in the names above) of the specific item for which order data is being sent your keygen URL (since data for all items in the order will be included in the transmission)
- sku - this is the SKU of the item for which order data is being sent your URL - only applicable if you also configured "Variants affecting price..." for the item.
Additional Variables
These variables are passed in addition to the order data we get from the payment processor:
- handshake - md5(your_e-junkie_login_email+md5(your-e-junkie-password))
<?php
// You can use this variable to ensure that the data coming is from
// E-junkie server. you can of course use any language of your choice.
// Put these lines in top of your script to make sure that the data
// you are getting is from e-junkie server.
// If your e-junkie login email and password is known to someone
// else, then this verification will be moot.
if ($_POST['handshake']!==md5("your@login.email".md5("your_e-junkie_password")))
{
exit;
}else {
// The code generation scheme will depend on the algorithm you
// are using in your software to actually check the data.
// It can be as simple as an MD5 hash of buyer's email, name and a secret word,
// or something completely random which you store in your database so your
// software would check the entered code against your DB.
// It's up to you completely; this is just one example of what you might do:
echo md5($_POST['payer_email']."some secret string");
}
?>
- from_name - your display name in e-junkie profile
- from_email - your display email in e-junkie profile
- 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 downloads you allow in your product configuration
- key - (if applicable) stored or generated registration key sent to the buyer
If your code generator does not generate text codes, but rather "binary key" files which need to be sent as an attachment, you should see the integration section in help. Our system will send the same variables to you without expecting an output. Your script can then generate and email the binary key file to buyer directly.
If you want the buyer to input a code which your script requires to generate the registration code, see the variants section in help.
E-junkie has a SoftwarePassport/Armadillo key generator installed and available for you to use. This generates a unique alphanumeric key string at random for every transaction. If you need to transmit each buyer's generated key to a script URL on your own sytem for some reason (e.g., to log the key as valid, and/or associate the buyer's name or email with the key they received, etc.), you can do that with our Integration feature.
- Enable Send Generated Codes for the product, and specify this as the Code Generator URL (all on one long line):
http://www.e-junkie.com/ecom/o_plug.php?arm_level=Level&arm_keytext=EncryptionTemplate E.g., your Code Generator URL may look something like this:
http://www.e-junkie.com/ecom/o_plug.php?arm_level=23&arm_keytext=Secret+phrase+only+you+know
Level - The signature level of the certificate:
- negative = V1 Unsigned keys
- 0 to 3 = V2 signed keys
- 10 to 18 = V3 signed keys
- 20 to 28 = ShortV3 signed keys (uses ElGamal)
- 29 = ShortV3 signed key (uses elliptic curve)
EncryptionTemplate - The encryption key or "secret phrase" used to generate the security certificate:
- If you want the buyer's code displayed on their Thank-you Page, be sure to put something in the product's Message (HTML) field using
[%codes%] wherever you want the buyer's code to be inserted (see our Thank-you Page customization help page for more information).
