SWREG Keygen
You can upload a list of valid keycodes or alternatively use a simple HTTP "GET" request with a querystring where we send data to your keycode generator on your own website and you can then return a value that we imbed into the receipt.
To provide your keygen URL go to your store delivery methods. Select the delivery method associated with the products that will use the keygen URL. Edit the delivery method, and select the keycode option which will expand allowing a field to provide your URL.
You will be able to return plain text up to 250 characters or a binary attachment. Read more >>
This is a list of the variables used by our program that can communicate with your keycode generator. They can be used in two ways.-
Keycode Generator. Our server can send these values to your keycode generator. You do what you have to do and print the output you wish us to imbed in the customer's receipt email between the values <softshop> blah blah...</softshop>
We will escape non-alphanumberic characters (e.g. '-', '(', or accents) into %XX where XX equals its hexadecimal ASCII value. Please do not use "" speech marks but you may use 'xxx' If you get problems try removing any HTML type formatting comands and odd characters from the output.
Most keygenerator code supported as long as returned between correct values.
-
Registered User database maintenance. Create an automatic system. Receive data as below and do what you like with it to generate your own orders - we just need a <softshop> </softshop> back again to stop us recording an error!
The maximum number of characters returned is 250.
The fields marked with ** could have no values.
You can read more general information here.
You can do tests with your keycode generator by logging in to your SWREG account and selecting the "Test your Keygen" link.
| Order/Invoice number | o_no= (integer 10) |
| Product code | pc= (char 20) |
| Variation (option) description ** | var= (char 80) |
| Delivery method description (we have added this because although you may not wish to issue keycodes you may wish to use this feature to trigger your order processing system). ** | del= (char 80) |
| Mr., Mrs., etc. (Billing) ** | title= (char 5) |
| initals= (char 20) - represents first name field (NOTE THE SPELLING ERROR)!! | |
| name= (char 20) | |
| Billing address | add1= (char 30) |
| ** | add2= (char 30) |
| add3= (char 30 = City) | |
| ** | add4= (char 30 = State/County) |
| ** | add5= (char 30 = Postcode) |
| add6= (char 30 = Country) | |
| Mr., Mrs., etc. (Shipping)** | d_title= (as above) |
| ** | d_initals= (as above) |
| ** | d_name= |
| Shipping address ** | d_add1= |
| ** | d_add2= |
| ** | d_add3= |
| ** | d_add4= |
| ** | d_add5= |
| ** | d_add6= |
| ** | co_name= (char 60) |
| ** | d_co_name= |
| email= (char 60) | |
| phone= (char 16 - may increase) | |
| IP Number of customer | ip= (char 16) |
| Optional. In Basic Level linking it is the result of the "question" field. In Intermediate and Advanced Levels it is the text in variable &t=. ** | user_text= (char 60) |
| Quantity | qty= (numeric) |
| Author login ID | mgr_name= (char 30) |
| Publisher name | pub=(char=80) |
| Affiliate ID (invented by yourself) | affil=(char=40) |
| Product price (including variable price) | pp= |
| Product VAT (including variable pricing) | pv= |
| CC Email | ccmail= |
| Commission | com= |
| Email Opt in flag | optin=Y|N |
| Typical use for the instruction field would be to say something specfic for the delivery instructions like," Mind the dog" or "leave the package inside the back gate". You can use it for your own purposes though similar to user_text above. | ins= (no limit but take care you do not break our buffer) |
| Sales notification email address. You can use this value as a security verification to ensure the keygen call is coming from a trusted source. | security=(char 60) |
| Offer Name (Only passed when offer was applied to line item). | offer_name=(char 80) |
| Coupon Code (Only passed when a coupon is applied to line item). | coupon_code=(char 19) |
Delayed Keycodes
You can have SWREG send out a "one code fits all" temporary code that you advise the customer in the e-mail body text and then we will send out the permanent one after x days if order not refunded. There are two extra fields on the email set up page. One for the key delay and one for the message, which uses the same imbedded variable syntax as the long text field (see above). Provided no refunds have been done, the customer will get a second mail after the key delay days have elapsed to inform them of the key. The vendor will get confirmation that the user has been sent the key and what key.