Interchange NetBilling Support

SYNOPSIS

    &charge=netbilling
 
        or
 
    [charge route=netbilling param1=value1 param2=value2]

PREREQUISITES

  LWP::UserAgent
  LWP::Protocol::https
  Digest::MD5

All of these need be present and working.

DESCRIPTION

SETUP

    Require module Vend::Payment::NetBilling

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

    Variable   MV_PAYMENT_MODE  netbilling

SETTINGS

    [charge route=netbilling id=YourNetBillingID]

or

    Route netbilling id YourNetBillingID

or

    Variable MV_PAYMENT_ID      YourNetBillingID

VALUES

address1

Customer's shipping street address and also the default for b_address1.

auth_code

Force code provided by credit card processor. Optional.

b_address1

Customer's billing street address. Required for address verification. Defaults to address1.

b_city

Customer's billing city. Required for address verification. Defaults to city.

b_country

Customer's billing country. Required for address verification. Defaults to country.

b_fname

Customer's billing first name. Required for address verification. Defaults to fname.

b_lname

Customer's billing last name. Required for address verification. Defaults to lname.

b_state

Customer's billing state/province. Required for address verification. Defaults to state.

b_zip

Customer's billing zip/postal code. Required for address verification. Defaults to zip.

check_account

Checking account number. Required for ACH transactions.

check_dl

Optional driver's license number field, but necessary for proper online check fraud screening. In any case, only ONE of SSN, DL or TAXID will be used if provided, in that order of preference.

check_dl_state

The two-character postal code for the state the ID was issued in. Leave blank if inappropriate, for instance, when using SSN.

check_number

An optional check sequence number, provided by the customer.

check_routing

Checking account routing code. Required for ACH transactions.

check_ssn

Optional social security number field, but necessary for proper online check fraud screening. In any case, only ONE of SSN, DL or TAXID will be used if provided, in that order of preference.

check_taxid

Optional tax id number field, but necessary for proper online check fraud screening. In any case, only ONE of SSN, DL or TAXID will be used if provided, in that order of preference.

city

Customer's shipping city and also the default for b_city.

comment1

Additional miscellaneous info to accompany the transaction, up to 4000 characters.

country

Customer's shipping country and also the default for b_country.

email

Customer's email address. Required for address verification.

fname

Customer's first name for shipping and also the default for b_fname.

item_desc

An optional description of the product or services paid for. Up to 4000 characters. Defaults to a summary of the shopping cart contents.

lname

Customer's last name for shipping and also the default for b_lname.

mv_credit_card_cvv2

Credit Card CVV2 value. This is the three or four digit code on the back of the customer's credit card. Optional, but often will get a lower rate on the transaction.

mv_credit_card_exp_month

The month of expiration as a two digit number.

mv_credit_card_exp_year

The year of expiration as a two digit number. This can accept a four digit number in which case the first two digits will be discarded.

mv_credit_card_number

Credit Card Account Number -- required for Credit Card transactions.

mv_order_number

The number Interchange assigns to this order. This gets stored as user data in the transaction. This will only come from processed values, not raw values but it does default to the mv_order_number in session space.

phone_day

Stored as the customer phone number for the transaction and required for address verification.

state

Customer's shipping state and also the default for b_state.

zip

Customer's shipping zip and also the default for b_zip.

TROUBLESHOOTING

If nothing works:

• Make sure you "Require"d the module in interchange.cfg:

      Require module Vend::Payment::NetBilling
      

• Make sure LWP::UserAgent LWP::Protocol::https and Digest::MD5 are installed and working. You can test to see whether your Perl thinks they are:

      perl -MLWP::UserAgent -MLWP::Protocol::https -MDigest::MD5 -e 'print "It works\n"'
      

  If it prints "It works." and returns to the prompt you should be OK (presuming they are in working order otherwise).

• Check the error logs, both catalog and global.
• Make sure you set your payment parameters properly.
• Try an order, then put this code in a page:

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

  That should show what happened.

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

BUGS

You cannot randomly pick a transaction ID for NetBilling's Direct Mode. The ID must be assigned from NetBilling. It should either be left blank or a guaranteed unused ID can be retrieved from NetBilling prior to issuing the transaction. This module will overwrite any transaction ID supplied it with the one assigned by NetBilling.

AUTHORS

CREDITS

    Jeff Nappi <brage@cyberhighway.net>
    Paul Delys <paul@gi.alaska.edu>
    webmaster@nameastar.net
    Ray Desjardins <ray@dfwmicrotech.com>
    Nelson H. Ferrari <nferrari@ccsc.com>

SEE ALSO

    http://netbilling.com/direct/direct2.html