BusinessOnlinePayment

Interchange's support for the Business::OnlinePayment  suite of Perl modules

Also see the Business::OnlinePayment module list  on CPAN .

Synopsis

or

Prerequisites

• Business::OnlinePayment
• Business::OnlinePayment::ModuleName (payment gateway module)

Description

The Vend::Payment::BusinessOnlinePayment module implements the onlinepayment() subroutine for use with Interchange.  It is compatible on a call level with the other Interchange payment modules.  In theory (and even usually in practise) you could switch from another payment module to BusinessOnlinePayment with a few configuration file changes.

Business::OnlinePayment provides a suite of Perl modules for processing online payments (credit cards and electronic cheques etc.).  It provides a consistent interface for processing online payments, regardless of the gateway back end being used, in the same way that the DBI Perl module provides an consistent interface to different database technologies.

Currently this module is targeted at people who want to use a Payment Service Providers that is not supported by a native Interchange Vend::Payment module.

To enable this module, place this directive in your "interchange.cfg" file:

This must be in interchange.cfg or a file included from it.

Make sure CreditCardAuto is off, which is the default in the Standard ecommerce demo.

The "mode" can be named anything, but the "gateway" parameter must be set to "onlinepayment".  To make it the default payment gateway for all credit card transactions in a specific website, you can set the following in catalog.cfg:

It uses several of the standard settings from Interchange payment.  Any time we speak of a setting, it is obtained either first from the tag/call options, then from an Interchange order Route named after the mode, then finally a default global payment Variable.  For example, the id parameter would be specified by:

or

or

Settings

Name	Description
processor	The name of the Business::OnlinePayment payment processing module you would like to use.
id	The user ID provided by your Payment Services Provider.
transaction	The type of transaction to be run.  Valid values are as follows: Interchange Business::OnlinePayment auth Authorisation only sale Normal authorisation settle Post authorisation return Credit reverse Not supported at this time void Void
test	Set this true if you want to operate in test mode.  Be sure to verify that your specific Business::OnlinePayment payment module supports a test mode before you use this facility.

In addition, any other processor options are passed to your chosen Business::OnlinePayment payment module.  See the documentation for your specific Business::OnlinePayment payment module for details on what options are required, if any.

Troubleshooting

If nothing works:

• Make sure you Required the module in interchange.cfg:

  Require module Vend::Payment::BusinessOnlinePayment

  
  
• Make sure that the Business::OnlinePayment.pm Perl module is installed and working.
  
  
• Check the local and global error log files.
  
  
• Make sure you set the payment parameters properly for your chosen Business::OnlinePayment.pm module.
  
  

• Try an order, then put this code in a page:

  <pre> [calcn]     my $string = $Tag->uneval({ ref => $Session->{payment_result} });     $string =~ s/{/{\n/;     $string =~ s/,/,\n/g;     return $string; [/calcn] </pre>

  That should show what happened.

  
  
• If all else fails, consultants are available to help with integration for a fee.

Notes

There is actually nothing in Vend::Payment::BusinessOnlinePayment;  This module changes its package name to Vend::Payment and places things there.

Author

• Ivan Kohler 
• Initial development of this module was sponsored in part by Simply Marketing, Inc. 

Category:  Interchange payment modules

Last modified by: Kevin Walsh Modification date: Tuesday 19 September 2006 at 9:21 AM (EDT)