ICS

Interchange's support for the Cybersource ICS Payment Services Provider.

Synopsis

&charge = ics

[charge route="ics" param1="value1" param2="value2"]

Prerequisites

ICS Library
ICS.pm

You can download the required ICS library and Perl module from this page .

Description

The Vend::Payment::ICS module implements the ics() 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 ICS with a few configuration file changes.

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

Require module Vend::Payment::ICS

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 "ics". To make it the default payment gateway for all credit card transactions in a specific website, you can set the following in catalog.cfg:

Variable MV_PAYMENT_MODE ics

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 merchant_id parameter would be specified by:

[charge route=ics merchant_id=YourICSID]

Route ICS merchant_id YourICSID

Variable MV_PAYMENT_ID YourICSID

The following Route directives must be configured:

Route ICS server_host ics2test.ic3.com
Route ICS server_port 80
Route ICS path /path/to/lib/CyberSource/SDK
Route ICS merchant_id your_merchant_id
Route ICS apps ics_auth,ics_auth_reversal,ics_bill,ics_credit
Route ICS timeout 20
Route ICS merchant_descriptor "test merchant"
Route ICS merchant_descriptor_contact "phone number"

Troubleshooting

Try the instructions above, then enable test mode in the ICS control panel. A test order should complete.

If nothing works:

Make sure you Required the module in interchange.cfg:

Require module Vend::Payment::ICS
Check the local and global error log files.
Make sure you set your payment parameters properly.
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::ICS; This module changes its package name to Vend::Payment and places things there.

Author

Sonny Cook