Difference between revisions of "Freeside:1.7:Documentation:Administration"

From Freeside
Jump to: navigation, search
(Upselling)
(Real-time Processing)
Line 32: Line 32:
  
 
== Billing ==
 
== Billing ==
===Real-time Processing===
+
[[Freeside:1.7:Documentation:Administration:Real-time_Processing | Real-time credit card and electronic check processing]]
====Configuration====
 
#Install a real-time processing module, such as Business::OnlinePayment::TCLink, or Business::OnlinePayment::Exact<pre><nowiki>
 
root# cpan Business::OnlinePayment::TCLink
 
</nowiki></pre>
 
#Remove the Batch Card processing event, and add a Real-Time Card processing event
 
#* Configuration -> Billing -> View/Edit Invoice Events
 
#* Click on "Batch card"
 
#** Check off "Disabled"
 
#** Click "Apply changes"
 
#* Click on "Add a new invoice event"
 
#** Name it something like "Realtime card"
 
#** Choose the radio button "Run card with a Business::OnlinePayment realtime gateway"
 
#** Click on "Add invoice event"
 
#Enable your payment gateway
 
#* Configuration -> Settings
 
#* Click "Edit Configuration"
 
#* Click the "Billing" tab
 
#** For the 'business-onlinepayment' field, enter the Business::OnlinePayment module you are using, followed by your account ID, password, and (optionally), type of action<pre><nowiki>
 
TCLink
 
someuser
 
password
 
Normal Authorization
 
</nowiki></pre>
 
#*** Some payment gateways such as LinkPoint don't use a username/password, and require additional parameters. These can be passed in as key<newline>value pairs<pre><nowiki>
 
LinkPoint
 
              <-- intentionally left blank
 
              <-- intentionally left blank
 
Normal Authorization
 
storename    <-- key
 
123456        <-- value
 
keyfile      <-- key
 
123456.pem    <-- value
 
lbin          <-- key
 
/usr/bin.lbin <-- value
 
tmp
 
/tmp/secure
 
</nowiki></pre>
 
#** Click "Apply Changes"
 
 
 
References
 
# http://search.cpan.org/src/WITTEN/Business-OnlinePayment-TCLink-1.03/README.freeside
 
# http://www.sisd.com/freeside/list-archive/msg03193.html
 
# http://wavetail.420.am:81/freeside/docs/billing.html
 
 
 
====Testing Real-Time Processing====
 
''One Time Transactions''
 
* Choose a customer account
 
* Click on 'Process credit card payment'
 
* Enter a payment ammount, and credit card details
 
* Click 'Process payment'
 
* The transaction should happen immediately
 
* Click on 'View this customer'
 
* At the bottom of the screen, "Payment History" should include this transaction
 
 
 
''Recurring Transactions''
 
* Choose a customer account
 
* Click on 'Bill now', or run the freeside-daily cronjob from the command line as the freeside user
 
* At the bottom of the screen, "Payment History" should include this transaction
 
  
 
== Misc ==
 
== Misc ==

Revision as of 09:54, 23 September 2006

Provisioning

Services

Packages

Upselling

Scenario:

You have a customer with a 500mb email account, and they would like to upgrade to the 1000mb email account

Solution:

Freeside does not yet support add-on packages that launch external commands, so the best solution presently is to upgrade a user from the 500mb service to the 1000mb service by calling an appropriate "modify" command for the export associated with the package.

Caveats:

If you use two different "Export" commands, freeside will call the "delete" command of the first package, and then the "insert" command of the second package. (trying to determine correct way to handle this case)

Example:

  1. Config -> Provisioning, services and packages -> View/Edit Exports
  2. Edit the shell command for these services
  3. Call appropriate shell script using the 'modify' field to change disk quotas
  4. Select a customer
  5. Under packages, click "Change Package"
  6. Upgrade the user to the 1000mb service by selecting the 1000mb package, and your "modify" script will now be called. The reverse would be done if you were moving someone from 1000mb to 500mb

Resellers

Employees

Billing

Real-time credit card and electronic check processing

Misc