Using E-junkie to Sell Generated Codes
Selling codes provided by your own online code generator
You can use this feature to issue a key/PIN/registration/license type of code to the buyer if you have a Web-based code generator that outputs either a random code or one dynamically-generated based on the buyer's order data. While adding or editing a product in your E-junkie Seller Admin:
- Tick the Send Generated Codes checkbox;
- Click More Options (when adding a new product) or Next (when editing an existing product);
- When you see the Code Generator URL field, enter the URL where your keygen script can receive the order data;
- Click Next until you can Submit the new settings.
Order data transmitted to your keygen script
The Code Generator URL you have specified for each product that uses the Send Generated Codes feature will receive an HTTP POST submission containing all of the order data, using the same data set we send for our custom/3rd-party Integration feature -- the only difference is that we expect to receive output back from your script's URL for a keygen submission, whereas Integration submissions just send the data without expecting any output in return (and of course we do not send a value for
key to your keygen URL since it hasn't output a key back to us yet by that point).
Code output to be provided to buyers
Whatever plaintext output your keygen script returns will be forwarded as-is to the buyer in the thank-you email we generate for the product. Typically this output should be only the code itself (HTTP headers are fine, as our system will parse them out). You could output a whole block of preformatted plaintext (e.g., echoing the buyer's full registration details in your system if required), but any "boilerplate" text common to all codes generated should probably be provided in the product's Email Message field rather than generated by your script -- not least to keep your transaction log tidy, as a copy of the raw code output for each order is saved there for your reference.
If you also want the buyer's code displayed on their E-junkie-generated Thank-you Page, be sure to put something in the product's Message (HTML) field using the
[%codes%] template variable wherever you want the buyer's code to be inserted (see our Thank-you Page customization help page for further details).
E-junkie will POST all the order data to your keygen 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 (instructions to contact the seller will be provided instead), and we email you a notification that your keygen URL failed to respond.
If you're issuing this as a key to unlock software, your code generation scheme will depend on the algorithm you are using in your software to verify the data. This could be a hash derived from elements like the buyer's name, email, transaction ID, etc., perhaps combined with a secret string known only to you, or something completely random which you store in your database so your software would check the entered code against your online DB.
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 the binary key file and email that to the buyer directly.
If you want the buyer to input a code which your script requires to generate the registration code, see our Variations feature.