Business::OnlinePayment::Litle - Litle & Co. Backend for Business::OnlinePayment


Business-OnlinePayment-Litle documentation  | view source Contained in the Business-OnlinePayment-Litle distribution.

Index


NAME

Top

Business::OnlinePayment::Litle - Litle & Co. Backend for Business::OnlinePayment

VERSION

Top

Version 0.910

SYNOPSIS

Top

This is a plugin for the Business::OnlinePayment interface. Please refer to that docuementation for general usage, and here for Litle specific usage.

In order to use this module, you will need to have an account set up with Litle & Co. http://www.litle.com/



  use Business::OnlinePayment;
  my $tx = Business::OnlinePayment->new(
     "Litle",
     default_Origin => 'NEW',
  );

  $tx->content(
      type           => 'CC',
      login          => 'testdrive',
      password       => '123qwe',
      action         => 'Normal Authorization',
      description    => 'FOO*Business::OnlinePayment test',
      amount         => '49.95',
      customer_id    => 'tfb',
      name           => 'Tofu Beast',
      address        => '123 Anystreet',
      city           => 'Anywhere',
      state          => 'UT',
      zip            => '84058',
      card_number    => '4007000000027',
      expiration     => '09/02',
      cvv2           => '1234', #optional
      invoice_number => '54123',
  );
  $tx->submit();

  if($tx->is_success()) {
      print "Card processed successfully: ".$tx->authorization."\n";
  } else {
      print "Card was rejected: ".$tx->error_message."\n";
  }

METHODS AND FUNCTIONS

Top

See Business::OnlinePayment for the complete list. The following methods either override the methods in Business::OnlinePayment or provide additional functions.

result_code

Returns the response error code.

error_message

Returns the response error description text.

server_response

Returns the complete response from the server.

Handling of content(%content) data:

Top

action

The following actions are valid

  normal authorization
  authorization only
  post authorization
  credit
  void

Litle specific data

Top

Fields

Mostdata fields nto part of the BOP standard can be added to the content hash directly, and will be used

Products

Part of the enhanced data for level III Interchange rates

    products        =>  [
    {   description =>  'First Product',
        sku         =>  'sku',
        quantity    =>  1,
        units       =>  'Months'
        amount      =>  500,  ## currently I don't reformat this, $5.00
        discount    =>  0,
        code        =>  1,
        cost        =>  500,
    },
    {   description =>  'Second Product',
        sku         =>  'sku',
        quantity    =>  1,
        units       =>  'Months',
        amount      =>  1500,
        discount    =>  0,
        code        =>  2,
        cost        =>  500,
    }

    ],

SPECS

Top

Currently uses the Litle XML specifications version 7.2

TESTING

Top

In order to run the provided test suite, you will first need to apply and get your account setup with Litle. Then you can use the test account information they give you to run the test suite. The scripts will look for three environment variables to connect: BOP_USERNAME, BOP_PASSWORD, BOP_MERCHANTID

Currently the description field also uses a fixed descriptor. This will possibly need to be changed based on your arrangements with Litle.

FUNCTIONS

Top

_info

Return the introspection hash for BOP 3.x

set_defaults

map_fields

add_item

Top

A new method, not supported under BOP yet, but interface to adding multiple entries, so we can write and interface with batches

$tx->add_item( \%content );

AUTHOR

Top

Jason Hall, <jayce at lug-nut.com>

UNIMPLEMENTED

Top

Certain features are not yet implemented (no current personal business need), though the capability of support is there, and the test data for the verification suite is there.

    Force Capture
    Capture Given Auth
    3DS
    billMeLater
    Credit against non-litle transaction

BUGS

Top

Please report any bugs or feature requests to bug-business-onlinepayment-litle at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Business-OnlinePayment-Litle. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

You may also add to the code via github, at http://github.com/Jayceh/Business--OnlinePayment--Litle.git

SUPPORT

Top

You can find documentation for this module with the perldoc command.

    perldoc Business::OnlinePayment::Litle




You can also look for information at:

http://www.litle.com/

* RT: CPAN's request tracker

http://rt.cpan.org/NoAuth/Bugs.html?Dist=Business-OnlinePayment-Litle

* AnnoCPAN: Annotated CPAN documentation

http://annocpan.org/dist/Business-OnlinePayment-Litle

* CPAN Ratings

http://cpanratings.perl.org/d/Business-OnlinePayment-Litle

* Search CPAN

http://search.cpan.org/dist/Business-OnlinePayment-Litle/

ACKNOWLEDGEMENTS

Top

Heavily based on Jeff Finucane's l<Business::OnlinePayment::IPPay> because it also required dynamically writing XML formatted docs to a gateway.

COPYRIGHT & LICENSE

Top

SEE ALSO

Top

perl(1). Business::OnlinePayment


Business-OnlinePayment-Litle documentation  | view source Contained in the Business-OnlinePayment-Litle distribution.