home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / CCTRX50.ZIP / CCTRX50.DOC < prev    next >
Encoding:
Text File  |  1994-12-05  |  11.9 KB  |  259 lines
  1.  
  2.  
  3.                         The CC-TRX Credit Card Door 5.0
  4.                             for RemoteAccess 2.02
  5.                      Copyright 1991-1994 by Randy Blackmond
  6.                               All Rights Reserved
  7.  
  8.     The CC-TRX Credit Card Door allows you to accept credit card purchases on
  9.     your BBS! The transactions can be for products or services such as share-
  10.     ware registrations, BBS subscriptions or merchandise! The door is fully
  11.     sysop configurable so you may accept any credit card for any item!
  12.  
  13.     Features:
  14.       1) Up to 9 credit cards can be configured
  15.       2) Unlimited number of transaction items can be configured
  16.       3) A State Sales Tax can be charged per item
  17.       4) A markup percentage can be configured per item
  18.       5) A shipping or other flat rate charge can be configured per item/unit
  19.       6) A shipping or other flat rate charge can be configurged per item/order
  20.       7) A shipping address prompt can be configured per item
  21.       8) Users' security can be upgraded per item
  22.       9) Users' flags can be modified per item
  23.      10) Users' subscription expiration date can be modified per item
  24.      11) Users' credit field can be modified per item
  25.      12) A voice phone number prompt can be configured globally
  26.      13) Optional Visa/MasterCard/American Express number validation
  27.      14) A message is written to the user on your choice of message board
  28.          containing a duplicate of the transaction record contained in the
  29.          CC-TRX transaction log. Optionally, a carbon copy can be sent to
  30.          the sysop. (Hudson Message Base ONLY)
  31.      15) An external program can optionally be run after a transaction
  32.  
  33.     INSTALLATION
  34.     ------------
  35.     The first thing you need to do is make sure the RA environment variable
  36.     is set via your AUTOEXEC.BAT or BBS batch file. This is done by assigning
  37.     your RA system directory to the RA variable with the following DOS command:
  38.  
  39.     SET RA=<directory>
  40.  
  41.     For example, my RA system directory is C:\RA so my Set line would be as
  42.     follows:
  43.  
  44.     SET RA=C:\RA
  45.  
  46.     If you are upgrading from v4.1 of CC-TRX, run the included 41TO42.EXE
  47.     program from within the same directory where CCTRX.CFG resides and then
  48.     run CC44TO45.EXE. This will update the 4.1 configuration file to the 4.5
  49.     format as well as the transaction item data file. Next run the included
  50.     CC45TO50.EXE. If you are upgrading from v4.0, run 40TO42.EXE and then
  51.     CC44TO45.EXE and finally CC45TO50.EXE. If you are upgrading from 4.4 to
  52.     4.5, run CC44TO45.EXE and then CC45TO50.EXE. If you are upgrading from
  53.     4.5, run CC45TO50.EXE _only_.
  54.  
  55.     Next, copy CCTRX.EXE and CCTRXCFG.EXE to either your RA system directory
  56.     or create a separate directory for CC-TRX.
  57.  
  58.     Run CCTRXCFG.EXE to create/edit the configuration file for CC-TRX. Pass
  59.     the name of the configuration file to CCTRXCFG.
  60.  
  61.     Add CC-TRX to the menu of your choice with the following Optional Data
  62.     line (if CCTRX.EXE resides in your RA system directory):
  63.  
  64.     CCTRX.EXE CCTRX.CFG *M
  65.  
  66.     The *M is optional, but will ensure there is plenty of memory available
  67.     for CC-TRX to use so it is recommended. Note you must include the name
  68.     of the configuration file to be used on the command line.
  69.  
  70.  
  71.  
  72.     If you created a separate directory for CC-TRX, you will need to create
  73.     a batch file containing the commands to change to the CC-TRX directory
  74.     and execute CC-TRX. This method can be used with either a type 7 or type
  75.     15 shell.
  76.  
  77.     All transactions made in the CC-TRX Door are written to a text file named
  78.     CCTRX.TRX.
  79.  
  80.     There are nine optional, external display files you may create to be used
  81.     by CC-TRX. They follow the ASC/ANS naming convention for RA display files,
  82.     but must reside in the same directory as CCTRX.EXE. The files are displayed
  83.     with More prompting. They are as follows:
  84.  
  85.     CCMENU.A*  - The menu files for CC-TRX.
  86.  
  87.     CCWELC.A*  - This file is displayed immediately after the opening CC-TRX
  88.                  title screen.
  89.  
  90.     CCSAVED.A* - This file is displayed after a successful transaction has
  91.                  been saved.
  92.  
  93.     CCCARD.A*  - This file is displayed before the user is prompted to select
  94.                  which credit card they wish to use.
  95.  
  96.     CCTRANS.A* - This file is displayed after the user selects "Perform Credit
  97.                  Card Transaction" from the CC-TRX menu.
  98.  
  99.     CCBADCC.A* - This file is displayed when a user enters a Visa or
  100.                  MasterCard that fails the validation check (when the Refuse
  101.                  Invalid toggle is enabled).
  102.  
  103.     CCFILE1.A* - This file is displayed if the user presses '1' at the menu.
  104.                  Automatic More prompting is used.
  105.  
  106.     CCFILE2.A* - This file is displayed if the user presses '2' at the menu.
  107.                  Automatic More prompting is used.
  108.  
  109.     CCFILE3.A* - This file is displayed if the user presses '3' at the menu.
  110.                  Automatic More prompting is used.
  111.  
  112.     CCSCRN1.A* - This file is displayed when the user selects a method of
  113.                  payment of Check or Savings. Do NOT modify this file!
  114.  
  115.     CCSCRN2.A* - This file is displayed when the user selects a method of
  116.                  payment of Plastic (credit card). Do NOT modify this file!
  117.  
  118.     CCSCRN3.A* - This file is displayed after a successful transactions. Do
  119.                  NOT modify this file!
  120.  
  121.     These files can include some of the control-codes used by RA such as the
  122.     clear-screen, pause, user name, etc. Those which are not supported will
  123.     be displayed as N/A.
  124.  
  125.     EXTERNAL PROGRAM
  126.     ----------------
  127.     The external program, if enabled, can be and do anything you like.
  128.  
  129.     CC-TRX will pass two parameters to the external program. The first is
  130.     the user name in the form FirstName_LastName (note the underscore). The
  131.     second parameter is the number of the transaction item they selected.
  132.  
  133.  
  134.  
  135.     Of course, if you're not a programmer, this option won't do you much good.
  136.     However, if you so desire, I will write a custom program for you to do
  137.     what you want for $25.00. The only restrictions are that the program not
  138.     be TOO complex and that you have registered CC-TRX. Now, my definition
  139.     and your definition of "Too Complex" may not be the same, so shoot your
  140.     idea to me and I'll be glad to give it consideration. Also, any custom
  141.     program written by me will remain my property and will be copyrighted by
  142.     me. The reason I do this is someone may give me an idea that I may want
  143.     to incorporate as an added feature in a future version of CC-TRX.
  144.  
  145.     SUPPORT/SUGGESTIONS
  146.     -------------------
  147.     As with all of my shareware products, I strongly urge users to offer sug-
  148.     gestions for further enhancement of my software. Without suggestions, a
  149.     program will whither and die. WITH suggestions, a program can grow and
  150.     become an even more useful tool!
  151.  
  152.     If you have any problems setting up CC-TRX, have a bug to report or want
  153.     to offer a suggestion for future versions, you can contact me in several
  154.     ways: Via FIDO NetMail at 1:381/70, Via FIDO EchoMail in the RA_UTIL echo
  155.     or call my voice line at 915-587-6221 (Call Information for El Paso, TX
  156.     if number is outdated/disconnected).
  157.  
  158.     HISTORY
  159.     -------
  160.     1.0   Initial Release of CC-TRX!
  161.  
  162.     2.0   Added User Flag Setting and External Program support. Fixed bug
  163.           that limited transaction selection to 9 instead of 75.
  164.  
  165.     2.1   Fixed Bug that caused Flags to be set exactly as shown in the CFG
  166.           file. It was supposed to only turn on flags set in the CFG, not
  167.           turn off flags not set! Works properly now. Due to the unreliability
  168.           of the Luhn validation method, the user is merely warned when a
  169.           card number is flagged as invalid, but is allowed to continue the
  170.           transaction.
  171.  
  172.     2.2   Fixed bug that occurred when more than 9 transaction items were
  173.           configured. The card number validation routine for Visa and
  174.           Mastercard (the Luhn Formula) has been fixed.
  175.  
  176.     3.0   Included a configuration program to ease CC-TRX configuration.
  177.           Added Subscription Expiration Date modification. The number of
  178.           transaction items you may configure is now unlimited.
  179.  
  180.     3.1   Just a couple of bug fixes for this version. Pause was added to
  181.           each screenful display of TRX items. TRX count was erroneously
  182.           being used to determine the number of valid responses to the
  183.           credit card number selection, i.e. if you had only 2 TRX items
  184.           configured, a user could not select a credit card numbered above
  185.           2!
  186.  
  187.  
  188.  
  189.     4.0   Added ability for user to select multiple items without having to
  190.           enter credit card info for each item. Added a quantity prompt for
  191.           each item. User can add or delete items after completing selections.
  192.           A message is written to the user after a successful transaction
  193.           showing all information about his transaction. This message is
  194.           placed on Board 1 as a private message.
  195.  
  196.     4.1   Changed validation routines and added support for AmEx validation.
  197.           Fixed bug where a user who selected card #2 would be reported as
  198.           having selected card #1 in the message and the log.
  199.  
  200.     4.2   Configuration file name must now be passed on the command line. This
  201.           should ease multi-node operation of the door. The message board for
  202.           the receipt message is now configurable and a carbon copy of the msg
  203.           may be sent to the sysop. Quantity prompt is now configurable per
  204.           item. The item file can be sorted by Item Description within the
  205.           configuration program.
  206.  
  207.     4.3   Updated for operation with RA 2.00. This release will only work with
  208.           the Hudson style message base, however.
  209.  
  210.     4.4   Minor bug fix
  211.  
  212.     4.5   Added Shipping/Order field in TRX configuration. Any amount entered
  213.           in this field will be added to the order only once, regardless of
  214.           the quantity ordered.
  215.  
  216.     5.0   Added state sales tax option, user credit update option, removed
  217.           address and phone number as options (they're required now), added
  218.           sort key for transaction items to allow complete sort control. Added
  219.           support for checking and savings transfers via Dragon Business
  220.           Services. CC-TRX must be registered before checking and savings
  221.           transactions will function.
  222.  
  223.     DISCLAIMER
  224.     ----------
  225.     I make no guarantees to the suitability or functionality of CC-TRX on your
  226.     system nor will I be held liable for any damages caused to you or your
  227.     system directly or indirectly by CC-TRX. I will, however, assist you to
  228.     the best of my ability to get CC-TRX running for you should you need
  229.     assistance. USE AT YOUR OWN RISK!
  230.  
  231.     REGISTRATION
  232.     ------------
  233.     CC-TRX is a shareware product, which means you try before you buy. If you
  234.     use CC-TRX beyond a 2 week evaluation period, you are required to register
  235.     it with the author. Complete and mail the following registration form with
  236.     a check or money order.
  237.  
  238.     Randy Blackmond                               CC-TRX Credit Card Door v5.0
  239.     7133 N. Mesa #64                                         Registration Form
  240.     El Paso, TX 79912
  241.  
  242.     CC-TRX 5.0 is $30.00 US/$35.00 INTERNATIONAL            DATE _____________
  243.  
  244.     YOUR NAME _____________________________ YOUR VOICE PHONE _________________
  245.  
  246.     YOUR BBS NAME ___________________________ YOUR BBS PHONE _________________
  247.  
  248.     BAUD RATES SUPPORTED ___________________
  249.  
  250.     ARE YOU IN FIDONET? IF SO, YOUR NODE ADDRESS ________________
  251.  
  252.     COMMENTS/SUGGESTIONS _____________________________________________________
  253.  
  254.     __________________________________________________________________________
  255.  
  256.     __________________________________________________________________________
  257.  
  258.  
  259.