home *** CD-ROM | disk | FTP | other *** search
/ ProfitPress Mega CDROM2 …eeware (MSDOS)(1992)(Eng) / ProfitPress-MegaCDROM2.B6I / BBS / DOORS / CD_TRX22.ZIP / CCTRX.DOC < prev    next >
Encoding:
Text File  |  1991-10-18  |  10.3 KB  |  245 lines
  1.  
  2.  
  3.                         The CC-TRX Credit Card Door 2.2
  4.                                for RemoteAccess
  5.                        Copyright 1991 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) Up to 75 transaction items can be configured
  16.       3) A sales tax (or other markup) percentage can be configured per item
  17.       4) A shipping address prompt can be configured per item
  18.       5) Users' security can be upgraded per item
  19.       6) Users' flags can be modified per item
  20.       7) A voice phone number prompt can be configured globally
  21.       8) Optional Visa and MasterCard number validation using the 
  22.          Modulus 10 Luhn formula
  23.       9) An external program can optionally be run after every transaction
  24.  
  25.     INSTALLATION
  26.     ------------
  27.     The first thing you need to do is make sure the RA environment variable
  28.     is set via your AUTOEXEC.BAT or BBS batch file. This is done by assigning
  29.     your RA system directory to the RA variable with the following DOS command:
  30.     
  31.     SET RA=<directory>
  32.  
  33.     For example, my RA system directory is G:\RA so my Set line would be as
  34.     follows:
  35.  
  36.     SET RA=G:\RA
  37.  
  38.     Next, copy CCTRX.EXE to either your RA system directory or create a 
  39.     separate directory for CC-TRX.
  40.  
  41.     Using your favorite text editor, you will create a configuration file
  42.     for CC-TRX (any name, your choice).
  43.  
  44.     The CFG file should be entered as follows:
  45.  
  46.     Line  1: Your Name (Sysop's Name)
  47.     Line  2: Your Registration Number (0 if unregistered)
  48.     Line  3: Path to your RA system directory, e.g. C:\RA
  49.     Line  4: Path to EXITINFO.BBS, e.g. C:\RA
  50.     Line  5: Y or N - Prompt for voice phone number?
  51.     Line  6: Number of transaction items to follow (Must NOT exceed 75)
  52.   * Line  7: Item Name
  53.   * Line  8: Dollar Amount (NO dollar signs!), e.g. 20.00
  54.   * Line  9: Markup (tax) percentage for this item, e.g. 7% would be .07
  55.   * Line 10: Y or N - Prompt for Shipping Address on this item?
  56.   * Line 11: New Security Level for this item - 0 for No Change
  57.   * Line 12: Additional Flag Settings for this item
  58.  
  59.     Lines 7 through 12 would be repeated for each item you wish to configure.
  60.  
  61.  
  62.  
  63.     Next Line: Number of credit cards to follow
  64.   * Next Line: Credit Card Name 1
  65.   * Next Line: Y or N - Perform Visa/MasterCard Number Validation?
  66.     
  67.     "* Next Line" would be repeated for each credit card you wish to accept.
  68.  
  69.     NOTE: Do NOT enter a Y for Visa/MasterCard Validation unless the Credit 
  70.     Card is a Visa or MasterCard!
  71.  
  72.     Next Line: Y or N - Use British pound (£) symbol instead of dollar sign?
  73.     Next Line: Y or N - Run external program after each transaction?
  74.     Last Line: Full path and name (with extension) of external program to run
  75.  
  76.     See the included CCTRX.CFG for an example of a config file.
  77.  
  78.  
  79.     Add CC-TRX to the menu of your choice with the following Optional Data
  80.     line (if CCTRX.EXE resides in your RA system directory):
  81.  
  82.     CCTRX.EXE CCTRX.CFG *M
  83.  
  84.     Note that the name of the config file is passed to CC-TRX. The *M is
  85.     optional, but will ensure there is plenty of memory available for CC-TRX
  86.     to use so it is recommended.
  87.  
  88.     If you created a separate directory for CC-TRX, you will need to create
  89.     a batch file containing the commands to change to the CC-TRX directory
  90.     and execute CC-TRX. This method can be used with either a type 7 or type
  91.     15 shell.
  92.  
  93.     All transactions made in the CC-TRX Door are written to a text file named
  94.     CCTRX.TRX.
  95.  
  96.     There are seven optional, external display files you may create to be used
  97.     by CC-TRX. They follow the ASC/ANS naming convention for RA display files,
  98.     but must reside in the same directory as CCTRX.EXE. The files are displayed
  99.     with More prompting. They are as follows:
  100.  
  101.     CCWELC.A*  - This file is displayed immediately after the opening CC-TRX
  102.                  title screen.
  103.     
  104.     CCSAVED.A* - This file is displayed after a successful transaction has
  105.                  been saved.
  106.  
  107.     CCCARD.A*  - This file is displayed before the user is prompted to select
  108.                  which credit card they wish to use.
  109.  
  110.     CCTRANS.A* - This file is displayed after the user selects "Perform Credit
  111.                  Card Transaction" from the CC-TRX menu.
  112.     
  113.     CCFILE1.A* - This file is displayed if the user presses '1' at the menu.
  114.                  Automatic More prompting is used.
  115.  
  116.     CCFILE2.A* - This file is displayed if the user presses '2' at the menu.
  117.                  Automatic More prompting is used.
  118.  
  119.     CCFILE3.A* - This file is displayed if the user presses '3' at the menu.
  120.                  Automatic More prompting is used.
  121.  
  122.  
  123.  
  124.     These files can include some of the control-codes used by RA such as the
  125.     clear-screen, pause, user name, etc. Those which are not supported will
  126.     be displayed as N/A.
  127.  
  128.     The Menu for CC-TRX is now an external ASCII/ANSI file. The filename(s)
  129.     should be CCMENU.A* and placed in the same directory as CCTRX.EXE. 
  130.     Sample menu files are included.
  131.  
  132.     ADDITIONAL FLAG SETTINGS
  133.     ------------------------
  134.     The Additional Flag Settings line in the configuration file is of the
  135.     following form:
  136.  
  137.     -------- -------- -------- --------
  138.  
  139.     That assumes you want NO additional flags set. If you wanted to set flags
  140.     A1 and D8, the line would look like this:
  141.  
  142.     X------- -------- -------- -------X
  143.  
  144.     Or if you wanted to set them ALL, it would look like this:
  145.  
  146.     XXXXXXXX XXXXXXXX XXXXXXXX XXXXXXXX
  147.  
  148.     EXTERNAL PROGRAM
  149.     ----------------
  150.     The external program, if enabled, can be and do anything you like. I use
  151.     it to generate an auto-message containing registration number information
  152.     for users who use the CC-TRX door to register my shareware programs.
  153.  
  154.     CC-TRX will pass two parameters to the external program. The first is
  155.     the user name in the form FirstName_LastName (note the underscore). The
  156.     second parameter is the number of the transaction item they selected.
  157.  
  158.     Of course, if you're not a programmer, this option won't do you much good.
  159.     However, if you so desire, I will write a custom program for you to do
  160.     what you want for $20.00. The only restrictions are that the program not
  161.     be TOO complex and that you have registered CC-TRX. Now, my definition
  162.     and your definition of "Too Complex" may not be the same, so shoot your
  163.     idea to me and I'll be glad to give it consideration. Also, any custom
  164.     program written by me will remain my property and will be copyrighted by
  165.     me. The reason I do this is someone may give me an idea that I may want
  166.     to incorporate as an added feature in a future version of CC-TRX.
  167.  
  168.     SUPPORT/SUGGESTIONS
  169.     -------------------
  170.     As with all of my shareware products, I strongly urge users to offer sug-
  171.     gestions for further enhancement of my software. Without suggestions, a
  172.     program will whither and die. WITH suggestions, a program can grow and
  173.     become an even more useful tool!
  174.  
  175.     If you have any problems setting up CC-TRX, have a bug to report or want
  176.     to offer a suggestion for future versions, you can contact me in several
  177.     ways: Via FIDO NetMail at 1:381/70, Via FIDO EchoMail in the RA_UTILS,
  178.     DOORWARE or SHAREWRE echos, Via RIME EchoMail in the Doors, Shareware,
  179.     Sysops or RemoteAccess conferences, call my BBS at 505-589-0319 USR DS and
  180.     leave a message or call my voice line at 505-589-0317 24 hours (answering
  181.     machine on duty).
  182.  
  183.  
  184.     
  185.     Be sure to check out RAMail 3.0, THE QWK Compatible MailDoor for RA!
  186.  
  187.     HISTORY
  188.     -------
  189.     1.0   Initial Release of CC-TRX!
  190.  
  191.     2.0   Added User Flag Setting and External Program support. Fixed bug
  192.           that limited transaction selection to 9 instead of 75.
  193.  
  194.     2.1   Fixed Bug that caused Flags to be set exactly as shown in the CFG
  195.           file. It was supposed to only turn on flags set in the CFG, not
  196.           turn off flags not set! Works properly now. Due to the unreliability
  197.           of the Luhn validation method, the user is merely warned when a
  198.           card number is flagged as invalid, but is allowed to continue the
  199.           transaction.
  200.  
  201.     2.2   Fixed bug that occurred when more than 9 transaction items were
  202.           configured. The card number validation routine for Visa and
  203.           Mastercard (the Luhn Formula) has been fixed.
  204.  
  205.     DISCLAIMER
  206.     ----------
  207.     I make no guarantees to the suitability or functionality of CC-TRX on your
  208.     system nor will I be held liable for any damages caused to you or your
  209.     system directly or indirectly by CC-TRX. I will, however, assist you to
  210.     the best of my ability to get CC-TRX running for you should you need
  211.     assistance. USE AT YOUR OWN RISK!
  212.  
  213.  
  214.  
  215.     REGISTRATION
  216.     ------------
  217.     CC-TRX is a shareware product, which means you try before you buy. If you
  218.     use CC-TRX beyond a 2 week evaluation period, you are required to register
  219.     it with the author. Complete and mail the following registration form with
  220.     a check or money order OR call my BBS and use your Visa or MasterCard in
  221.     the CC-TRX Credit Card Door!
  222.  
  223.     Randy Blackmond                               CC-TRX Credit Card Door v2.2
  224.     RR #1 Box 634                                            Registration Form
  225.     Anthony, NM 88021
  226.  
  227.     CC-TRX 2.2 is $20.00 US/$25.00 CANADA
  228.  
  229.     YOUR NAME _____________________________ YOUR VOICE PHONE _________________
  230.  
  231.     YOUR BBS NAME ___________________________ YOUR BBS PHONE _________________
  232.  
  233.     BAUD RATES SUPPORTED ___________________ 
  234.  
  235.     ARE YOU IN FIDO? IF SO, YOUR ADDRESS ________________
  236.  
  237.     ARE YOU IN RIME? IF SO, YOUR NODE ID ________________
  238.  
  239.     COMMENTS/SUGGESTIONS _____________________________________________________
  240.  
  241.     __________________________________________________________________________
  242.  
  243.     __________________________________________________________________________
  244.  
  245.