home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 8 / CDASC08.ISO / VRAC / CREDIT17.ZIP / CREDIT.DOC < prev    next >
Encoding:
Text File  |  1993-09-07  |  9.1 KB  |  263 lines
  1. ----
  2. Credit Card Subscription PPE: A Brief Over-View
  3. ----
  4.  
  5. Written By : Raymond Cava, SysOp ERGONET BBS
  6. BBS Number : (609) 729-8227 / 522-6825
  7. BBS ADDRESS: PO BOX 836  -  Wildwood, NJ 08260
  8.  
  9. Compiled   : 09-01-1993
  10. Compiled By: Richard Kenney, SysOp GASTANK BBS - (609) 886-3717
  11.  
  12. Credits    : The overall style of this PPE was inspired by
  13.              the VERIFIER door written by LANCE WILLIAMS, SysOp
  14.              KADET PCBOARD BBS (315) 245-3815 (New York), in which
  15.              there is a very nice credit card subscription option
  16.              which I use on my BBS.
  17.  
  18.              Richard Kenney for compileing it and asking me to make it,
  19.              as well as testing it.
  20.  
  21. Brief Desc.:
  22.  
  23.         - VERY, VERY Configureable
  24.         - Is Totally UN-Crippled
  25.         - Allows as many as 10 configureable menu options
  26.         - Allows Caller To Download Their Invoice
  27.         - Allows For Sales tax
  28.         - Allows STATE CHECKING to see if state sales tax is aplicable
  29.         - Allows For Processing Fee
  30.         - Allows IMMEDIATE updateing of caller information unless
  31.           N flag is set in CREDIT.CNF to disallow immediate ercord updateing.
  32.         - Leaves a Message to the sysop alerting him of purchase
  33.         - Logs Purchase To Callers Log
  34.         - Logs all purchases to CREDIT.LOG
  35.         - leaves a thank you letter to the caller (to disable,
  36.           just erase THANKYOU.TXT)
  37.  
  38.  
  39.  
  40. Fees       : NONE, absolutly none what-so-ever. I would; however,
  41.              like to know approximately how many people are useing this.
  42.              You can send me a postcard with:
  43.                 Your Name, BBS NAME, and  BBS NUMBER
  44.              on it if you will continue to use this, or call my BBS
  45.              and let me know.
  46.  
  47.  
  48. Install.   : It's easy.Make a directory for this ppe or place it with your
  49.              other PPE files. Go to CREDIT.CNF and make all changes for your
  50.              system. Now go to pcbsetup, go to cmd.lst pick a command such
  51.              as CR enter securty level path to ppe and ppe name.
  52.  
  53.             Command           Security          PPE/MNU File
  54.             =======           ========          ============
  55.              CR                  0              C:\PPE\CREDIT.PPE
  56.  
  57.  
  58.  
  59. ----
  60. Credit Card Subscription PPE: The Configureation File
  61. ----
  62. - ** THE ONLY MENU COMMAND THAT REMAINS CONSTANT IS  E  for EXIT
  63. - The Config file MUST be names CREDIT.CNF
  64. - The file containing the text for the THANKYOU file MUST be named THANKS.TXT
  65.   * If you do not want a thankyou note left to the caller, then erase this file.
  66.  
  67. - The First SIXTEEN (16) lines MUST ALL BE FILLED
  68.  
  69.  
  70. Line 1: RAY CAVA
  71. Line 2: ErgoNet
  72. Line 3: c:\ccnum\welcome
  73. Line 4: c:\ccnum\options
  74. Line 5: c:\ccnum\
  75. Line 6: c:\pcb\upload\
  76. * Line 7: %2 Credit Card Processing Fee :  'This appears in the actual invoice
  77.                                             itself. You must state what percent
  78.                                             the processing fee is for as shown.
  79.  
  80. * Line 8: 2                                'Instead of entering .02 for %2 you
  81.                                             now enter the number, for the
  82.                                             percentage, with NO decimal points.
  83.                                             Examples:
  84.  
  85.                                             %2 is 2
  86.                                             %2.5 is 25
  87.                                             %2.25 is 225
  88. LEAVE as 0 if you are not chargeing an extyra fee
  89.  
  90. * Line 9: 100                               '***HERE*** is where you choose to
  91.  
  92. make the calculations correct. Example: The membership is $10 the processing
  93. fee is %2. This is what the program NOW does.
  94.  
  95.                                              $10.00 X 2 = $20.00
  96.                                              $20.00 / 100 = $0.20
  97.                                              $10.00 + $0.20 = $10.20
  98.  
  99. That is how it figures out the tax. NOW for what you ACTUALLY put in line 9.
  100.  
  101. if line 8 is:
  102.  
  103.           2 then you put on line 9 100
  104.           25 then you put on line 9 1000
  105.           225 then you put on line 9 10000
  106.  
  107. Depending on which column you are going to when figueing tax, that is what you
  108. will divide it by.
  109.  
  110.           .02 is the decimal equivelant of %2 the last number, (2)
  111.            is in the HUNDRETHS spot so you put on line 9 100
  112.           .025 is the decimal equivelant of %2.5 the last number, (5)
  113.            is in the THOUSANDTHS spot so you put on line 9 1000
  114.           .0225 is the decimal equivelant of %2.25 the last number, (5)
  115.            is in the TEN-THOUSANDTHS spot so you put on line 9 10000
  116.  
  117. If line 8 is zero, then make this line 0
  118.  
  119. * Line 10: %8.25 NY - State Sales Tax :    'This actually appears on the invoice
  120.                                             as entered in the file. This line
  121.                                             tells what percent (you write it out
  122.                                             in percent format) and for WHAT
  123.                                             STATE the SALES TAX is for, Or just
  124.                                             leave the state BLANK if you want
  125.                                             on this line.
  126.  
  127.  * Line 11: 825                             'The same applies here as for LINE 8
  128.                                              BUT THIS is STATE tax. Leave as 0
  129.                                              for NO TAX
  130.  
  131.  * Line 12: 10000                           'The same applies here as for LINE 9
  132.                                              If line 11 is 0 then this line is 0
  133.  
  134. Line 13: NJ                                 'The  state to which you are charge
  135.                                              ing the tax. make it say ALL
  136.                                              if you want everyone to
  137.                                              unconditionally be charged the tax.
  138. Line 14: y                                   'Allow User To DOWLOAD the INVOICE
  139. Line 15: Y                                   'ask the user if they are eligible
  140.                                               to be charged YOUR states tax.
  141.                                               this option is OVERRIDDEN by the
  142.                                               ALL switch on line 13.
  143.                                               If you are not chargeing tax at
  144.                                               all, the place an N here and set
  145.                                               lines 12 and 13 to 0
  146.  
  147. Line 16: Y                                   'Allow IMMEDIAT upgradeing after
  148.                                               purchase.
  149.  
  150.         This is all that MUST be here, unless of course you want
  151.         to add menu options. <G>
  152.  
  153. - The following  Lines...
  154.  
  155. For each menu option there are FIVE (5) lines that MUST be included after
  156. the 12th line.
  157.  
  158. LINE 17: 1                 - Key that selects this option from the OPTIONS
  159.                              MENU. Can be any ASCII character, if it is a letter
  160.                              it MUST be uppercase
  161.  
  162. LINE 18: c:\ccnum\opt1     - Path and filename of display file, describing
  163.                              the option just chosen.
  164.  
  165. LINE 19: 60                - Security level to assign if option is purchased
  166. LINE 20: 30                - Length in DAYS of membership
  167. LINE 21: 6                 - price in numeric value only of OPtion Purchased
  168.  
  169. The same would repeat for a second menu option.
  170.  
  171. - * THERE CAN BE NO MORE THAN 10 MENU OPTIONS
  172.  
  173. LINE 22: 2
  174. LINE 23: c:\ccnum\opt2
  175. LINE 24: 60
  176. LINE 25: 365
  177. LINE 26: 24
  178.  
  179.  
  180.  
  181. VERY LAST LINE: ***       - The very last line will and MUST always be a
  182.                             *** (triple astrics)
  183.                             If the *** is not detected then the PPE will
  184.                             be in a continuous loop and not stop until
  185.                             the system is reset.
  186.  
  187.  
  188. - This is what the config file looks like without those comments:
  189.  
  190. RAY CAVA
  191. ErgoNet
  192. c:\ccnum\welcome
  193. c:\ccnum\options
  194. c:\ccnum\
  195. c:\pcb\upload\
  196. %2 Credit Card Processing Fee :
  197. 2
  198. 100
  199. %8.25 NY - State Sales Tax :
  200. 825
  201. 10000
  202. ALL
  203. Y
  204. N
  205. Y
  206. 1
  207. c:\ccnum\opt1
  208. 60
  209. 30
  210. 6
  211. 2
  212. c:\ccnum\opt2
  213. 60
  214. 365
  215. 24
  216. 3
  217. c:\ccnum\opt3
  218. 110
  219. 365
  220. 100
  221. 4
  222. c:\ccnum\opt4
  223. 120
  224. 360
  225. 200
  226. ***
  227.  
  228.  
  229. ----
  230. Credit Card Subscription PPE: Files NEEDED By This PPE
  231. ----
  232.  
  233. - The Welcome file (can be any name) If not present, it just doesnt
  234.   Display, and no error message is given.
  235.  
  236. - The MENU OPTION file (Can Have Any Name You realy should have this)
  237.  
  238. - CREDIT.CNF, the configuration file
  239.  
  240. - INVOICE , created by the PPE
  241.  
  242. - THANKYOU.TXT file containing the thankyou letter left to the caller
  243.  
  244.  
  245.  
  246. ----
  247. Credit Card Subscription PPE: Files Created By This PPE
  248. ----
  249.  
  250. - CREDIT.LOG         - Log file holding credit card and subscription info.
  251. - INVOICE.           - File holding the next invoice number to be used.
  252. - REG.TXT            - File containing information notifying the sysop
  253.                        of the purchase. Written to message base.
  254.  
  255. - #.                 - # being invoice number (holding invoice info)
  256. - USERNAME.INV       - Downloadable invoice for caller
  257.  
  258.  
  259.  
  260.  
  261.  
  262. <End of file>
  263.