Beijing Paradise BBS Backup

home *** CD-ROM | disk | FTP | other *** search

/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / DCCDV199.ZIP / DCCD.DOC < prev next >

Wrap

Text File | 1993-01-15 | 28.3 KB | 613 lines

▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░ ▒░▒░▒░▒▓▓░▒▓▓▓▓▓▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░ ▒░▒░▓▓▒▓▓░▒▓▓░▒▓▓░▒░▒░▒░▒░ The 4th Dimension Bulletin Board System ░▒░▒░▒░▒░ ▒░▒▓▓░▒▓▓░▒▓▓░▒░▓▓▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░ ▒░▓▓▓▓▓▓▓░▒▓▓░▒░▓▓▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░ ▒░▒░▒░▒▓▓░▒▓▓░▒▓▓█▀▀▒░▒░▒░█▀▒░█░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒(TM)░▒░▒░▒░▒░▒░▒░▒░▒░▒░ ▒░▒░▒░▒▓▓░▒▓▓▓▓▓▒█▄▄▒█▀█▒▀█▀▒▀█▀▒█▒░▒█▒█▀█▒█▄▄▒███▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░ ▒░▒░▒░▒░▒░▒░▒░▒░▒▄▄█▒█▄█▒░█░▒░█░▒█▄█▄█▒█▀█▒█▒░▒█▄▄▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░ ▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░ ▒░═════────────────══════────────────══════────────══════─────────────────▒░ ▒░ █▀▄ ▄▀▀▄ ▄▀▀▄ █▀▀▄ ▒░ ▒░ █ █ E L U X E █ R E D I T █ A R D █▄▄▀ R O C E S S O R ▒░ ▒░ █▄▀ ~ ~ ~ ~ ~ ▀▄▄▀ · · · · · ▀▄▄▀ · · · █ · · · · · · · · ▒░ ▒░═════────────────══════────────────══════────────══════─────────────────▒░ ▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░▒░ (C)opyright by Jeff Jones - 4D Software (TM) 1992,1993 This program is fully supported by the author. You can get in contact with me via my BBS and/or FAX. The Fourth Dimension BBS: (312) 284-7133 - 4 Nodes, USRobotics 16.8K (312) 284-0437 - FAX (312) 581-8851 - Voice (8am-8pm, EST) Support via the 4D Support Conference on the BBS Features ~~~~~~~~ There are many features that Deluxe Credit Card Processor offers. I will attempt to list some of them here. I just want to make it clear that all of the features are not listed. o Simple setup and maintenance of the door and supported files. o Fossil Driver compatible for non-standard comm ports & IRQs. Reads the PCBoard defaults for it's information. o User freindly environment for user interface. o Directly interfaceable to PCBoard and all it's functions. o Written useing the PCBoard developer's toolkit. o Fully network compatible. o A single configuration file is shared by all your nodes. o Error handling will prevent system lock-ups or network errors. o Assures the Credit Card number given is a valid card number, and not a gas or cash station, etc. card. o User friendly menuing system for your users to understand how the door works more easily. o Allows the user to abort or change ANY of the selections he has made in the door. User can exit the door in the middle of a transaction without having to worry about false charges to his/her card. o Support for Visa, Master Card, American Express/Optima, & Discover. If more card types are needed, I can add them very easily. o Full author support is available and I am very willing to help. 24 hour BBS support available via The Fourth Dimension BBS (see above.) o New versions of the code are Beta Tested vigorously before an official release is posted. o All disply files are able to be customized to your individual tastes. o Multi-Lingual display file support. o Capable of changing security levels for Subscription options, as well as expiration dates.. o Door allows for Subscription mode, Product mode, or both to be run as you see fit on your BBS. o Carrier loss detection at all aspects of door operation. o Door operates in local mode as well as remote. o To-the-point documentation for easier understanding of the program. o An author who's open to suggestions! o Outputs text files so the sysop can have messages sent to himself with the user's charge information. Such programs as TXT2MSG can be used for this. o Trash can files for previoud bad card numbers & phone numbers. o Support for up to 30 different product areas! Included Files ~~~~~~~~~~~~~~ The following files should have been included with your copy of the Deluxe Credit Card Door. If you are missing any of the files that appear here, please erase your copy of the DCCD and call the support BBS number listed above for a valid copy of the program. DCCD.EXE - The Deluxe Credit Card Processor Door executible file DCCDCFG.EXE - Configuration program for the door itself DCCDPRD.EXE - Product file managment utility DCCD. - Sample door batch file for calling the processor door WELCOME. - Welcome display file WARN. - Warning display file CLOSE. - Closing file displayed after user make a purchase SUBLIST. - Subscription Options display file HLPMAIN. - Main menu Help display file HLPSUBS. - Subscription Options menu Help display file HLPPROD. - Product Options menu Help display file DCCD.DOC - The documentation (You're reading it!) HISTORY.DOC - Revision History documentation file COMMENTS.DOC - User feedback on the Deluxe Credit Card Processor system NOTICE.!!! - Important revision notices as well as how to convert Support Files Used/Made By DCCD.EXE ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ WELCOME. - The welcome file displayed when the door is first opened. This file, along with any of the other display files are capable of useing PCBoard @xx codes, as well as using the old graphics display method of creating a seperate file with the letter 'g' appended to the end for the graphics version. IE: WELCOME. is the ascii version, and WELCOMEG. would be the ansi version. All the display files are also capable of multi-lingual versions, all you need to do is append the language suffix to the end of the files for that specific language. See your PCBoard documentation for more information of multi-lingual operation of PCBoard. WARN. - The warning file is displayed after the user enters all his/her card information. This display file should contain a warning against useing false or stolen credit card numbers. CLOSE. - This is the file shown to the caller after he enters his/her card information. This file should contain any information you can give the user as to how long before he recieves the products/subscription he ordered, and how you go about verifying the order with him/her. SUBLIST. - This file is displayed when a user selects, from the subscription options menu, the function to display a detailed list of the subscription options. You should have an in-depth description of each of your subscription options that you will have available in the door. HLPMAIN. - This is the Help file that describes each of the commands availabe in the initial/Main Menu of the door. This file is shown to the user when he/she asks for help while in the main menu of the door. HLPSUBS. - This is the Help file that describes the functions of the Subscription Options menu. HLPPROD. - This is the Help file that describes the functions of the Product Options menu. NOTICE. - This file is NOT necessary. If this file exists it will replace the information we normally tell the caller in the screen marked "!!! NOTICE !!!", seen after the caller selects the command to process the order. This file will be displayed right after we display the amount to be charged. CONFIG.CCD - This is a data file made by the DCCDCFG.EXE program that holds all the settings, and subscription information for the door itself. PRODUCTS.CCD - This is the product header file. This file contains information on each of the category names. PRODUCTS.xx - This is a data file made by the DCCDPRD.EXE program that holds all the information on each of the products you have available for purchase in the door. The "xx" is the category number. ORDERS.CCD - This is the ascii file created by the door when a user makes a purchase and enters his credit card information. DCCD.KEY - This is the KEY file for the door, configuration program, and the product manager. You recieve this key with your registered version of the door. This KEY File removes all the annoying delays and unlocks the features marked with double asterisks (**) in this document. PRODUCTS.TXT - This file is an ascii text file outputted by the product manager when you select to Output a list of Products. BADCARDS.CCD - This is an ascii text file, CR/LF deliminated, that does NOT have to exist, but if it does it will be checked against the user's entered card number. If there is a match the caller will be kicked out of the door at the very end (after he is almost TOTALLY finished). This text file should contain card numbers, one per line, starting in the very first column. BADPHONE.CCD - Same as BADCARDS.CCD, except that this is a file containing phone numbers instead of card numbers. Same rules apply as above. USERxxxx.NAM - File outputted containing the user's name. Where xxxx is shown, the node number would be substituted (Ex: xxxx for node 34 would be USER34.NAM). This file is only created if you have the "Output User info to File" switch turned on. This file is only written if the user actually makes a purchase. USERxxxx.INF - File outputted containing information about the charge the use just made. (Same restrictions apply as above) Changing your DOORS.LST file in PCBSETUP ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ In your PCBSetup program you must edit the DOORS.LST file for either the main board or the conference(s) you wish the door to be installed in. You must give the name of the door batch file, and a couple other pieces of information. I do not plan to explain how to install a door in PCBoard, so you must refer to your PCBoard manual for more information on installing doors. PCBoard must create a USER.SYS file. If this file is not present you will experience major problems with the running of the door. This file is where we get the actual user information. A DOOR.SYS file is not a necessary file to create for the Credit Card Processor. If you specify to create a DOOR.SYS file, all that will result is a longer load time of the door because PCBoard has to take the time to open and write a file that is not needed. You MUST specify 'N' for shell. If you attempt to shell this door you may run into problems with memory shortages or lockups. Any other parameters that may be needed are up to you to decide. I do not need to go into them, as you should be familiar with the operation of PCBoard. The Door Batch File ~~~~~~~~~~~~~~~~~~~ The door batch file is a file called by PCBoard to run the actual door program and then re-load the board. Below is an example door batch file for you to use as a guide. Line 1: @echo off 2: z: 3: cd \dccd 4: dccd %pcbdrive%%pcbdir% 5: %pcbdrive% 6: cd %pcbdir% 7: board Line-by-line description: 1: Turn the Dos echo of the commands in the batch off. You can look this command up in you dos reference manual for more information. 2: Change to the drive holding the Credit Card Processor files. 3: Change the current directory to the directory you have created for the Credit Card Processor files. 4: Load the DCCD.EXE door with the command line option of the path (only) to your PCBoard directory for this node in specific, IE: 'C:\PCB'. 5: Change back to the drive containing the PCBoard executable file for this node. 6: Change to the PCBoard subdirectory. 7: Re-load the board. DCCDCFG.EXE ~~~~~~~~~~~ The following is a screen capture of the configuration program that you should run first to set up the door options and configure the door to your personal needs. The capture only shows enough of the actual screens to show you what you need to know. The bottom half, the part where the subscription information is located is actuall on the Second screen in the setup, available by hitting Page Up/Down. There are a total of 20 allowed levels, of which 5 are only read by the door in the NON-Registered versions. ------------------------------------------------------------------------------ Deluxe CCD Setup Utility v1.0 DOOR Subscription Mode? Y *1 DOOR Product Mode? Y *2 Echo Dots for Credit Card #? N *3 Use the Sysop Comment Field? N *4 Output User Info to File? N *5 Minimum Non-Subscriber Level: 10▒ *6 Minimum Subscriber Level: 60▒ *7 Cards Accepted: [Y]Visa [Y]Master Card [Y]Discover [Y]AMEX/Optima *8 (second screen) ## LVL EXP MTHS COST DESCRIPTION *9 *10 *11 *12 *13 1 20▒ 0▒▒ 12 $25.00▒▒ 1 Year, Level 20, 800K bytes/day, 60 min/day▒▒▒▒▒▒ 2 0▒▒ 0▒▒ 0▒ $0.00▒▒▒ ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ 3 0▒▒ 0▒▒ 0▒ $0.00▒▒▒ ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ 4 0▒▒ 0▒▒ 0▒ $0.00▒▒▒ ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ 5 0▒▒ 0▒▒ 0▒ $0.00▒▒▒ ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ 6 0▒▒ 0▒▒ 0▒ $0.00▒▒▒ ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ 7 0▒▒ 0▒▒ 0▒ $0.00▒▒▒ ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ 8 0▒▒ 0▒▒ 0▒ $0.00▒▒▒ ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ 9 0▒▒ 0▒▒ 0▒ $0.00▒▒▒ ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ 10 0▒▒ 0▒▒ 0▒ $0.00▒▒▒ ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ *14 Use TAB/SHIFT+TAB, Page UP/DN, UP/DOWN, or ENTER to change fields. [ESC] = Quit ------------------------------------------------------------------------------ Here is a break-down of all the options. In the above reference you will see numbers that you should use for reference; the numbers have an asterisk in front of them so you can locate them easier. *1: Door Subscription Mode - This is a toggle type of an option. You must enter either and 'N' or 'Y'. If you do not turn this option on (Y), the door will not display any of the Subscription options in the door. *2: Door Product Mode - This is also a toggle option which turns on the Product mode operations in the door. To turn this feature on, set this field to a 'Y'. Note: you must have either one, or both of the above options set to 'Y' in order to get the door to function properly. *3: Echo Dots for Credit Card - This is yet another toggle to tell the door wether or not to display dots instead of the actual credit card number when the user is giving his credit card information. Here's where the harder settings come into play. PLEASE read this section very carefully so you can understand the logic of the door. *4: Use the Sysop Comment Field - This is a toggle that tells the door wether or not to write subscription charge info to the user's Sysop Comment field for your reference. This is the field in the user's record that is left for you to put what you want. If you select 'Y' the field will be filled with the amount charged for the subscription level, as well as the date it was charged. This field was requested. *5: Tells the door wether or not to output the USERxxx.INF & USERxxx.NAM files for use with a text-to-message type importer. Such importer's as TXT2MSG can be used here. *6: Minimun Non-Subscriber Level - This is the security level that is the extreme minimum for all of your non-subscriber levels. Lets set up a little example here. Say you have level 5 for users that refuse to register, level 10, 20, 30 for free access users, and level 40, 50, 60, 70, 80, 90, etc for SUBSCRIBING users. This field would be set to "10" for this setup. The logic is actually pretty simple. If a user enters the door with a level 10, 20, or 30 and the user selects to order your 1st subscription choice, which you have set to give him xx months of subscription time, at security level yy. This entry lets the door check to see how to handle the user's change in expiration dates. If the user has a security level greater or equal to this level, and less than the Minimum subscriber level (the next field in the setup), the user's expiration date will be changed by taking TODAYS date, and adding xx months to the date. (for 12 months the user's expiration would be extended 12 months.) If the user is a level that is greater than minimum subscriber level the expiration date change will be handled a little differently. Instead of changing the expiration date, the expiration date will be APPENDED the number of months you gave for the subscription choice the user chose. NOTE: There is a stipulation here. If the user has a security level that is greater than the minimum SUBSCRIBER level, the users expiration date will be checked with todays date to see how many days he has left before he expires. If the user is already expired he will be allowed to order his subscription renewal. If the user has a number of days left greater than the number of days you have defined in the PCBoard setup program for "Warning days Prior to Expiration" under the "Node / Event / Subscription" options, the user will NOT be allowed to purchase his subscription renewal until he IS within this set number of days. This is done because if a user re-registers for a higher level security than he already is, the user will be given his already remaining expiration time, plus the NEW time at the higher level. Meaning that you will loose money by giving the user a higher level at a cheaper price. *7: Minimum Subscriber Level - This is the level referenced above for the lowest security you have set up for a user to be a subscribing member. Read the above if you have not for more information on this level. It MUST be set up properly. *8: Credit Cards Accepted - All you need to do is toggle the credit cards on ('Y') that you will be supporting. Next we have to set up the subscription choices you want to have available for you users to purchase. *9: Level - This is the level the user will be given if he purchases THIS subscription option. If you want this subscription option available to your users, but NOT change his security level or expiration date, just set this level to '999' and no changes will be made to the user's record. If the user calls and has a level equal or greater than the level you defined in your PCBoard setup as "Sysop Level," the door WILL NOT modify the user's level or expiration date to allow the sysop to test the door. The door will stop recognizing these lines as soon as it comes to a line with the level blank - meaning nothing entered (0 it all out). By saying recognizing lines, I mean if you have the first 3 lines with either a security level or '999' entered in them, and the fourth line all blank, you will only have 3 options read by the door and shown to the users. Anything after the 4th line, and including the 4th line, will be skipped. The same also applies if you have "0" for cost - except that the door will read the line, but not let the user select the number with a cost of zero dollars/cents. ** You will only be allowed to have 4 (Four) subscription options in the UNREGISTERED version of the door. Registration allows for the use of all 20. *10: Expired Level - Same basic thing appplies here as for the previous Level field. 999 entered here tells the door to NOT change the user's expired level only. Notice I said only. This means that if you have an actual level number in the "LEVEL" placem the user's level will be changed, but not the expired level. The door will not stop reading if this field is a zero or 999, etc. *11: Months - This is the number of months the user will be given if he/she purchases this option for a subscription. If you have a '999' entered on this line for security level, the expiration, as well as the security will not be changed. *12:Cost - Easy one here! How much to charge the user for this subscription option. *13:Description - Another easy one! Give your users a description of the subscription option. You should tell him what level, how much time, length of time he will keep this level, and and anything else you can fit. *14:Exit - This line tells you to hit ESCape to exit the configuration. After you hit the ESCape key, you will be asked if you really want to exit the configuration, or you can also exit without saving any changes. That's it. Just hit ESCape, and type (Y)es to save the new config file we just created. You can use this same program to edit your configuration any time you need to make any changes. DCCDPRD.EXE ~~~~~~~~~~~ If you intend to run the door with Product mode active, you MUST run the Product Manager to create and start your initial PRODUCTS.CCD file. Just change your drive and directory to the directory containing all the door files and run the product manager. To start your initial product data base, after running the manager, type 'A' for add a product. This will bring up the first product. Once you enter a product, your data base is now started! To finish entering your product data, press the escape key. When entering product information, let it be known that you must try and keep the FIRST line in the window, to the left of the 'COST' field, brief and descriptive, as this is the only information you will have to go by when the door outputs what the user buys. The three lines under the dashes are extra description lines for the user to see. The only purpose of these additional lines if for the user to have a better 'feel' for what he is about to purchase. MULTIPLE CATEGORIES: The manager has the ability to give you multiple product categories. First, if you only have one product category, the manager will not show the user a pick list for just 1 category. The user will only see a pick list in the door for categories if you have more than 1 active category with products in them all. To add another category, or change a category name, press the number (2) and enter the category to edit or add. You will be prompted for the new category name. Enter the name and the new category will be added or changed if it already existed. To add products to a category, press the number (1) from the menu and select your category number. Then, once selected, start adding, editing, etc... your products. When the manager initially loads it defaults to the 1st category. You can see the name of the current category in the bottom left hand corner. DEAD field: This field is a 'Y/N' toggle field to show if the product is an active member in the product file. If you specify a 'Y' here, the door will bypass this product in displays, and skip the number for that product. SORT CLASSIFICATION: If you have an extensive library of products, such as movies, books, and other misc. goods, you may want to sort your products out a little bit. If you want all you Movies grouped at the beginning of the product list, you need to use a lower letter or number here, such as an 'A', as opposed to a 'Z'. All your books would be 'B', etc. COST: This is a simple one! How much is the price, not including any shipping & handling or taxes. That's it! When you need to make changes to an existing product, or delete it, you need to use the 'E'dit command from the product manager. This will allow you to make your changes, or put a 'Y' in the DEAD field to delete the record. Press ESCape to quit editing the product. If you have any products that you have flagged as being 'DEAD', you can use the 'P'ack option to remove all these unwanted records. This is just a quick way to clean up your product file. Once you have your list complete, you can 'S'ort it. When you select the sort feature, you are asked if you want to use the sort classification. if you select 'Y', your products will all be sorted according to the letter/number you specified for the sort classification, and then the name of the product. If you select 'N', your product file will be sorted by the name of the product only. If you change your mind and do not want to sort the file after all, just press ESCape! All the other features of the product manager are self explanitory. I don't like lengthy docs, as I'm sure you are the same. The DCCD.KEY File ~~~~~~~~~~~~~~~~~ The DCCD package requires a registration key. You must register the program if you plan to use it. Registration removes any lengthy delays, and opens the doors to features you cannot now use. To find out how to register the door, refer the the END of this document. Registration keys are given to you in any of a few ways. 1) Uploading it to your BBS. 2) Mailing it to you. 3) You downloading it from my support BBS. ****************************************************************************** *** To register your copy of The Deluxe Credit Card Door *** ****************************************************************************** Registration costs $40.00. This is a nominal fee for a product that is so well supported, and easily changed to suit your ever-changing needs! Call the Fourth Dimension BBS (312-284-7133) and use your Visa, Master Card, or American Express online via the DCCD door. OR: send check, money order, etc. to: 4D Software c/o Jeff Jones P.O.BOX 389051 Chicago, Ill 60638 All checks, money orders, etc. MUST be made payable to "Jeff Jones." Once payment is recieved, we will contact you by the voice number you leave, and create your .KEY file. Please make sure you leave me a message, or send a letter/fax with a name and password to log onto your BBS as if you run a closed system. All support is offered via conference # 2 on The Fourth Dimension. You can call up and request a FREE 15 day trial key. This will allow you to use the full capabilities of the door to see if you really like the door before you purchase it. Thank You! Jeff Jones ****************************************************************************** .PCBKIT is (C)opyright by Clark Development Company .PCBoard is (C)opyright by Clark Development Company