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

From Freeside
Jump to: navigation, search

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 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 and will have a "view receipt" link.