Freeside:1.9:Documentation:Administration:Real-time Processing:IPPay

Configuring IPPay Real-Time Processing

Install Business::OnlinePayment::IPPay

• Debian:

 root# aptitude install libbusiness-onlinepayment-ippay-perl

• Other OSes:

 root# cpan
 cpan> force install Business::OnlinePayment::IPPay

Configure IPPay

• Configuration -> Settings
• Click the "Billing" tab
• Scroll down and click on the "business-onlinepayment" configuration option.
• In the text box, enter three lines: "IPPay" (without the quotes), your terminal ID, and your password:

 IPPay
 YOUR_IPPAY_TID
 YOUR_IPPAY_PASSWORD

• Click "Set global configuration" at the bottom of the text box.

Configure billing events

If you are switching to IPPay from another processor, you can skip this section.

• Remove the Batch Card processing event(s), if any:
  • Configuration -> Billing -> View/Edit Billing Events
  • Click on "Batch card"
  • Check off "Disabled"
  • Click "Apply changes"

• Add an event for realtime processing:
  • Configuration -> Billing -> View/Edit Billing Events
  • Click on "Add a new invoice event"
  • Choose Type "Invoice"
  • Scroll down to the "Event action" dropdown at the bottom, and select "Run card with a Business::OnlinePayment realtime gateway"
  • Click on "Add billing event definition" at the bottom of the form.

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 and a receipt will be displayed.
• Click on 'View this customer'
• At the bottom of the screen, "Payment History" should include this transaction and will also have a "view receipt" link.

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