home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 8 / CDASC08.ISO / VRAC / CREDIT18.ZIP / CREDIT.DOC < prev    next >
Encoding:
Text File  |  1993-09-12  |  9.2 KB  |  267 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 SEVENTEEN (17) 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.  
  151. Line 17: (Your Country's Symbol for Money)
  152.  
  153.         This is all that MUST be here, unless of course you want
  154.         to add menu options. <G>
  155.  
  156. - The following  Lines...
  157.  
  158. For each menu option there are FIVE (5) lines that MUST be included after
  159. the 12th line.
  160.  
  161. LINE 18: 1                 - Key that selects this option from the OPTIONS
  162.                              MENU. Can be any ASCII character, if it is a letter
  163.                              it MUST be uppercase
  164.  
  165. LINE 19: c:\ccnum\opt1     - Path and filename of display file, describing
  166.                              the option just chosen.
  167.  
  168. LINE 20: 60                - Security level to assign if option is purchased
  169. LINE 21: 30                - Length in DAYS of membership
  170. LINE 22: 6                 - price in numeric value only of OPtion Purchased
  171.  
  172. The same would repeat for a second menu option.
  173.  
  174. - * THERE CAN BE NO MORE THAN 10 MENU OPTIONS
  175.  
  176. LINE 23: 2
  177. LINE 24: c:\ccnum\opt2
  178. LINE 25: 60
  179. LINE 26: 365
  180. LINE 27: 24
  181.  
  182.  
  183.  
  184. VERY LAST LINE: ***       - The very last line will and MUST always be a
  185.                             *** (triple astrics)
  186.                             If the *** is not detected then the PPE will
  187.                             be in a continuous loop and not stop until
  188.                             the system is reset.
  189.  
  190.  
  191. - This is what the config file looks like without those comments:
  192.  
  193. RAY CAVA
  194. ErgoNet
  195. c:\ccnum\welcome
  196. c:\ccnum\options
  197. c:\ccnum\
  198. c:\pcb\upload\
  199. %2 Credit Card Processing Fee :
  200. 2
  201. 100
  202. %8.25 NY - State Sales Tax :
  203. 825
  204. 10000
  205. ALL
  206. Y
  207. N
  208. Y
  209. $
  210. 1
  211. c:\ccnum\opt1
  212. 60
  213. 30
  214. 6
  215. 2
  216. c:\ccnum\opt2
  217. 60
  218. 365
  219. 24
  220. 3
  221. c:\ccnum\opt3
  222. 110
  223. 365
  224. 100
  225. 4
  226. c:\ccnum\opt4
  227. 120
  228. 360
  229. 200
  230. ***
  231.  
  232.  
  233. ----
  234. Credit Card Subscription PPE: Files NEEDED By This PPE
  235. ----
  236.  
  237. - The Welcome file (can be any name) If not present, it just doesnt
  238.   Display, and no error message is given.
  239.  
  240. - The MENU OPTION file (Can Have Any Name You realy should have this)
  241.  
  242. - CREDIT.CNF, the configuration file
  243.  
  244. - INVOICE , created by the PPE
  245.  
  246. - THANKYOU.TXT file containing the thankyou letter left to the caller
  247.  
  248.  
  249.  
  250. ----
  251. Credit Card Subscription PPE: Files Created By This PPE
  252. ----
  253.  
  254. - CREDIT.LOG         - Log file holding credit card and subscription info.
  255. - INVOICE.           - File holding the next invoice number to be used.
  256. - REG.TXT            - File containing information notifying the sysop
  257.                        of the purchase. Written to message base.
  258.  
  259. - #.                 - # being invoice number (holding invoice info)
  260. - USERNAME.INV       - Downloadable invoice for caller
  261.  
  262.  
  263.  
  264.  
  265.  
  266. <End of file>
  267.