home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / BBS / CHGM0195.ZIP / CHGMAST.DOC < prev    next >
Text File  |  1995-01-06  |  16KB  |  318 lines
  1.                      CHGMAST v1.2 - Charge Master
  2.                          (compiled 12/06/94)     
  3.                                   by
  4.                             Gerard Johnson
  5.           Copyright (c) 1994 KeySoft, Inc. - All Rights Reserved.
  6.                                
  7.                                HOME BOARD:
  8.               Top Cat BBS! - (813) 930-0611 [16.8k ZyXEL]
  9.  
  10.                             SUPPORT BOARD(s):
  11.                  PC-Help! - (813) 949-4993 [USR 28.8 DS]
  12.        
  13.  
  14.   CHGMAST v1.2 - Wildcat! 4.01 Subscription Module
  15.   -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  16.  
  17.   Disclaimer (Legal mumbo jumbo)
  18.   ==========
  19.   KeySoft hereby disclaims all warranties relating to this product, whether
  20.   express or implied, including without limitation any implied warranties of
  21.   merchantability or fitness for a particular purpose. KeySoft cannot and will
  22.   not be liable for any special, incidental, consequential, indirect or similar
  23.   damages due to loss of data or any other reason.  In no event shall the
  24.   liability for any damages ever exceed the price paid for the license to use
  25.   software, regardless of the form and/or extent of the claim.  The user of
  26.   this program bears all risk as to the quality and performance of the 
  27.   software.
  28.  
  29.   Copyright
  30.   =========
  31.   CHGMAST is NOT in the public domain, but rather is marketed under the 
  32.   shareware concept.  It is copyrighted by Gerard Johnson and KeySoft, Inc.
  33.   Wildcat! and WCCODE are trademarks of Mustang Software, Inc.
  34.  
  35.  
  36.   What is CHARGE MASTER?
  37.   ======================
  38.   Charge Master is a comprehensive WCCODE executable (WCX) exclusively for
  39.   Wildcat 4.01 sysops.  It is a full-featured application that processes
  40.   credit card charges (MasterCard, Visa, Discover, American Express and JCB)
  41.   TABS billing (both $10 and $25 levels), and the new Checks Online!  It
  42.   also creates a charge file that is 100% compatable with the Dragon Business
  43.   Services file format (SYSOP.CHG).  Here are just SOME of the features
  44.   that are available:
  45.      
  46.   - 30 day "unconditional" money back guarantee
  47.   - Works with WC! 4.01 Single/MultiLine/MP versions
  48.   - Supports optional BADNUM.LST & BADLEVEL.LST files
  49.   - Automatically generates receipt & welcome messages
  50.   - Users expiration date can be automatically extended
  51.   - Logs Caller id information automatically if detected
  52.   - Wildcat! security levels can be *selectively* upgraded
  53.   - Supports sysop definable "extended descriptions" files
  54.   - Advanced credit card validation routines are now built-in
  55.   - Types of subscriptions are configurable via the .CFG file
  56.   - All text/display files, support Wildcat's '@' color codes
  57.   - Program can selectively "CHAIN" to other WCX apps on exit!
  58.   - All Major credit cards, TABS and *Checks Online* supported!
  59.   - Sales Tax can be *selectively* applied to certain purchases
  60.  
  61.  
  62.   CHGMAST v1.2 - Wildcat! 4.01 Subscription Module
  63.   -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  64.   
  65.   - Pulls as much information from the Wildcat user profile file
  66.   - Detailed logging of all charges in an easy to read ASCII file
  67.   - No shelling to DOS, or leaving the protection of Wildcat here
  68.   - Creates an ASCII "receipt" that the user can download or print
  69.   - User's 'Acct balance' field can be updated with a dollar amount
  70.   - 100% compatable with Dragon Business Services 'SYSOP.CHG' format
  71.   - Automatically upgrades member security level, expiration date and
  72.     Account balance
  73.   - Unregistered version supports up to 10 subscription/charge levels
  74.   - FREE voice support. Support also available via home/support boards
  75.      
  76.  
  77.   Registration
  78.   ============
  79.   CHGMAST costs only $15 to register. The fastest way to register the program
  80.   is to call the HOME board and and charge the registration fee online. 
  81.   You may also fill out the REGISTER.TXT form enclosed in the archive and mail
  82.   it in with a check (payable to KeySoft, Inc.) or money order.
  83.   
  84.   A COMPETITIVE UPGRADE is now available to sysops who have registered other
  85.   credit card doors.  If you have spent at least $15 on a comparable charge
  86.   door, you can register Charge Master for only $10!  
  87.  
  88.   If you want the reg# mailed to you, please note that on the registration
  89.   form.  The following are the benefits of registering the program:
  90.  
  91.       -  Eliminates ALL program delays
  92.       -  Eliminates ALL (if any) "nag" messages/screens
  93.       -  Allows running a DOS batch file upon exit
  94.       -  Access to new versions before they are publically released
  95.       -  UNLESS REGISTERED, THIS PROGRAM WILL NOT FUNCTION *AFTER* 1/31/95
  96.  
  97.       
  98.   GETTING STARTED
  99.   ===============
  100.  
  101.   1. Creating a Directory
  102.      --------------------
  103.      Create a seperate directory for the program, and unzip the archive into 
  104.      that directory.  The next step is deciding what menu letter is going to 
  105.      activate this program from the menu.  As an example, I have set this up
  106.      as menu option [O]nline Registeration from the Main Menu.
  107.  
  108.   2. Running MAKEMENU
  109.      ----------------
  110.      Makemenu is an Wildcat! v4.x utility that allows the sysop to redefine/
  111.      define menu options and what actions they control.  The following is a 
  112.      typical menu option setup for CHGMAST in MAKEMENU:
  113.  
  114.              Selection Key  :   O
  115.              Description    :   Online Membership reg
  116.              Command Type   :   Run wcCODE program
  117.              Parameters     :   C:\WILDCAT\CHGMAST\CHGMAST.WCX
  118.  
  119.  
  120.  
  121.   CHGMAST v1.2 - Wildcat! 4.01 Subscription Module
  122.   -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  123.  
  124.   3.  Editing the Configuration file
  125.       ------------------------------
  126.       Charge Master reads a simple ASCII file from which it detemines how
  127.       it's going to run.  This file must reside in the same directory that
  128.       contains the executable (CHGMAST.WCX) and you must pay close attention
  129.       to the file format.  
  130.  
  131.       Starting with version 1.2, Charge Master is bundled with a "sysop
  132.       friendly" setup program - CHGSETUP.WCX.  This is the preferred method
  133.       of editing your configuration setting.  Refer to the CHGSETUP.DOC file
  134.       for a brief walkthrough on the setup program.  However, you can still 
  135.       edit the ascii configuration file manually if you wish.
  136.       
  137.       At a minimum, the file must have the following 13 lines AND must end 
  138.       with a line that begins with a semicolon (which is line #15), after
  139.       which you can add any comments you wish.
  140.  
  141.   Top Cat BBS!  <- Line 1:  Name of Board or Name registered under
  142.   12345         <- Line 2:  Charge Master Registration Number
  143.   TOP           <- Line 3:  Your BBS Code assigned *by* Dragon BBS
  144.   2341          <- Line 4:  Checks Online code assigned *by* Dragon BBS
  145.   0             <- Line 5:  Conference # in Wildcat to leave messages
  146.   PAY150        <- Line 6:  Security level to upgrade 'TABS10' codes to  <--.
  147.   90            <- Line 7:  Days to ADD to users expiration date for .......|
  148.   PAY200        <- Line 8:  Security level to upgrade 'TABS25' codes to  <--.
  149.   120           <- Line 9:  Days to ADD to users expiration date for .......|
  150.   ABCD          <- Line10:  Charge Method codes
  151.   5             <- Line11:  Minutes to ADD to users online time 
  152.   Y             <- Line12:  Use Advanced alogrithim checking for credit cards
  153.   0             <- Line13:  Sales tax (eg: 6.5% would be entered here as 650)
  154.   PAY150,1500,180,0,N,N,60 mins/day, 1 Mb KB/day download limit, (6 month Sub)
  155.   ;----         <- Last line after above settings:  1st character must be ';'
  156.  
  157.   
  158.   4. Defining what Charge Methods to accept
  159.      --------------------------------------
  160.      Line #10 in the configuration file is an extremely important line. It
  161.      is here that you define what credit cards you wish to accept, and if
  162.      your system accepts TABS.  Basically each credit card is assigned a
  163.      letter (see below) and you just string the letters together, WITH NO
  164.      spaces or other characters between them, on Line #10.
  165.  
  166.        CODES:
  167.          A - American Express       E - JCB
  168.          B - MasterCard             F - TABS
  169.          C - Visa                   G - Diners
  170.          D - Discover
  171.  
  172.      Thus if you were only allowing MasterCard and Visa, Line #10 would
  173.      contain BC.
  174.  
  175.  
  176.  
  177.   CHGMAST v1.2 - Wildcat! 4.01 Subscription Module
  178.   -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  179.  
  180.   5. Defining Subscription Levels
  181.      ----------------------------
  182.      Starting from line #14 in the configuration file, you may define up to 
  183.      10 charge levels, and each line must have the following fields seperated 
  184.      by commas:
  185.   
  186.      LEVEL NAME,COST,DAYS TO ADD,$ TO ADD,AUTO UPGRADE,TAXABLE,DESCRIPTION
  187.          <1>    <2>      <3>       <4>       <5>         <6>       <7>
  188.  
  189.      <1> This is the security level as defined in MAKEWILD (eg: PAY100)
  190.      <2> the cost of the subscription WITHOUT the decimal point but INCLUDING
  191.          the decimals (eg: $15 would be 1500.  $25.50 would be 2550)
  192.      <3> Number of DAYS to add to the level expiration date (0 not to add)
  193.      <4> $ amount to add to the users 'Acct balance' field (no decimal point)
  194.      <5> Should the user be automatically be upgraded to this security level (Y/N)
  195.      <6> Should sales tax be applies to this purchase (Y/N)
  196.      <7> A brief level description.  The first 65 characters are shown
  197.  
  198.  
  199.   6. Creating Extended Descriptions
  200.      ------------------------------
  201.      Since there is only space to display a brief description for each 
  202.      subscription level on the summary screen (65 characters), you have the
  203.      option to create "extended description" files for each subscription
  204.      level you set up.  You MUST name these files OPTIONx.TXT.  Where x
  205.      being a number from 1 thru 10.  Thus OPTION1.TXT would be a ASCII file
  206.      that would be displayed when the user views the extended description
  207.      for the first subscription level, and so.  If these files do not exist,
  208.      then Charge Master is intelligent enough not to ask the user if they
  209.      would like to view the extended description.  You may incorporate any
  210.      Wildcat '@' color codes in this file.
  211.  
  212.   7. Processing Checks Online?
  213.      -------------------------
  214.      By default, Charge Master will process TABS codes and the following credit
  215.      cards:-  American Express, Discover, Diners, JCB, Visa, and MasterCard.
  216.      To be able to activate the built-in ability to accept checks thru Charge 
  217.      Master, you must contact Dragon Business Services (513-987-9739) to get 
  218.      your "Check Code".  Once you have recieved this code, put it on line #4 
  219.      of yourconfiguration file.  NOTE:  Until you get this Check code, the 
  220.      program will only be able to accept Credit card and TABS charges.
  221.  
  222.   8. Personalizing Messages
  223.      ----------------------
  224.      Whenever a member uses the program, a notification message is generated
  225.      by Charge Master to the sysop, a reciept message is generated addressed
  226.      to the user and a personal message from the sysop is sent to the member.
  227.      This message can be customized by the sysop by editing the ASCII file
  228.      WELCOME.MSG.
  229.      
  230.  
  231.  
  232.   CHGMAST v1.2 - Wildcat! 4.01 Subscription Module
  233.   -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  234.  
  235.   9. Running Other WCX programs
  236.      --------------------------
  237.      New to v1.2 is the ability to selectively run other WCX programs after
  238.      Charge Master exits.  This is easily done but creating a 1 line ASCII
  239.      file with the full program path and name of the WCX to be run.  The
  240.      ASCII file name depends on which purchase menu option (in Charge Master)
  241.      the user selects.  For example, if you have 5 subscription levels setup
  242.      and you want Charge Master to run the program GENKEY1.WCX on exit if the 
  243.      user picked the second level, then you would create a file called CHAIN.2
  244.      which would contain the line C:\WILDCAT\WCX\GENKEY1.WCX.
  245.      Note that the CHAIN.x files must be in the same directory that Charge
  246.      Master runs from AND it only looks for that file if the user actually
  247.      goes through with the purchase.  This is an extremely usefull feature
  248.      for software authors who would like to accept registrations online and
  249.      then run their own registration # / key generation programs right after
  250.      a sucessfull purchase to get the user up and running immediately!
  251.  
  252.  
  253.  10. Editing the BADNUM.LST file
  254.      ---------------------------
  255.      Charge Master will look for a file called BADNUM.LST in the directory
  256.      that it is run from.  If it does not find the file, then it just keeps
  257.      on going.  If it does find the file, then it ckecks the credit card #
  258.      the user just entered with every number in this file.  If a match is
  259.      found, the user is notified that further program execution is not
  260.      possible and the sysop is notified via the ACTIVITY.x log file.  The
  261.      numbers in this file can be any length but must be only one to a line
  262.      and not contain the hyphens and/or blank spaces in between the digits.
  263.      This is another level of security against fradulent credit card numbers
  264.      being entered in the system.
  265.  
  266.  
  267.  11. Editing the BADLEVEL.LST file
  268.      -----------------------------
  269.      This works similar to the BADNUM.LST file, except you will have security
  270.      level names one to a line in this file.  If the users security level 
  271.      matches any of the levels defined in this file, they are graciously
  272.      taken out of the module.  Once again, this is an optional file.
  273.  
  274.  
  275.  12. Using TABS billing
  276.      ------------------
  277.      If you are not using the TABS billing service, then you are done with
  278.      the installation!  However, if you do accept the TABS codes on your
  279.      system then read on.  Depending on if you are accepting $10 or $25
  280.      level codes (or both), you must place the TABS10.TXT or/and TABS25.TXT
  281.      codes files(s) in your Charge Master directory.  The next time Charge
  282.      Master is run, it will detect the presence of these files and add the
  283.      codes to it CHGMAST.TAB file, while checking for used and duplicate codes.
  284.      It you are adding a lot of codes, it is a good idea to go into Charge
  285.      Master yourself so the user does not have to wait while it does this
  286.      maintenance.  This needs to be done only once!  It will rename the
  287.      TABS code files with a .OLD extension which should be moved out of
  288.      the Charge Master directory.
  289.   
  290.   That's it!  Charge Master is now ready to start processing charges on
  291.   your system, and make it easier than ever for members to subscribe!
  292.   
  293.  
  294.   What's in the works
  295.   ===================
  296.   - 100% compatability with American Banking Systems specs (.DBF files)
  297.   - RIP graphics (Still!)
  298.   
  299.   As always, the above features will be available FREE to registered users!
  300.  
  301.   
  302.   Technical Support
  303.   =================
  304.   Comments and suggestions are welcome, as well as any comments or suggestions
  305.   that you may have in terms of additional utilities you would like to see
  306.   written.  I can be reached via the home board or the support support board(s)
  307.   listed at the beginning of this document, or via the Internet:  
  308.        gerard.johnson@topcatbbs.com
  309.  
  310.   
  311.   Acknowledgments:
  312.   ================
  313.   Thanks to my ALL my beta testers who put this program though its paces and 
  314.   those who were involved in the program's approval process.
  315.  
  316. (End of Doc)
  317.  
  318.