NAME

Business::CyberSource::Report::SingleTransaction - Interface to CyberSource's Single Transaction report.

VERSION

Version 1.1.5

SYNOPSIS

This module is an interface to the Single Transaction report from CyberSource.

        use Business::CyberSource::Report;
        
        # Generate a report factory.
        my $report_factory = Business::CyberSource::Report->new(
                merchant_id => $merchant_id,
                username    => $username,
                password    => $password,
        );
        
        # Build a Business::CyberSource::Report::SingleTransaction object.
        my $single_transaction_report = $report_factory->build( 'SingleTransaction' );
        
        # Retrieve a Single Transaction report by Request ID.
        $single_transaction_report->retrieve(
                request_id              => $request_id,
                include_extended_detail => $include_extended_detail,
                version                 => $version,
        );
        
        # Retrieve a Single Transaction report using a combination of merchant
        # reference number and 
        $single_transaction_report->retrieve(
                merchant_reference_number => $merchant_reference_number,
                target_date               => $target_date,
                include_extended_detail   => $include_extended_detail,
                version                   => $version,
        );

METHODS

retrieve()

Build and send the request to CyberSource.

        # Retrieve a Single Transaction report by Request ID.
        $single_transaction_report->retrieve(
                request_id              => $request_id,
                include_extended_detail => $include_extended_detail,
                version                 => $version,
        );
        
        # Retrieve a Single Transaction report using a combination of merchant
        # reference number and target date.
        $single_transaction_report->retrieve(
                merchant_reference_number => $merchant_reference_number,
                target_date               => $target_date,
                include_extended_detail   => $include_extended_detail,
                version                   => $version,
        );

Parameters:

• request_id: a request ID from CyberSource.
• merchant_reference_number/target_date: the reference number you sent with the original transaction. This is not a number generated by CyberSource. This must be used in conjunction with a target date, with the format YYYYMMDD.
• include_extended_detail: optional, can be set to 'Predecessor' or 'Related' to retrieve more information about the transactions found.
• version: CyberSource offers multiple versions of the resulting XML. Available versions are 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 1.7. By default, it is set to 1.7. See http://apps.cybersource.com/library/documentation/dev_guides/Reporting_Developers_Guide/html/downloading.htm#downloading_10837_1027265 for more details about the differences.

AUTHOR

Guillaume Aubert, <aubertg at cpan.org>.

BUGS

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

SUPPORT

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

        perldoc Business::CyberSource::Report::SingleTransaction

You can also look for information at:

• RT: CPAN's request tracker

  http://rt.cpan.org/NoAuth/Bugs.html?Dist=business-cybersource-report

• AnnoCPAN: Annotated CPAN documentation

  http://annocpan.org/dist/business-cybersource-report

• CPAN Ratings

  http://cpanratings.perl.org/d/business-cybersource-report

• Search CPAN

  http://search.cpan.org/dist/business-cybersource-report/

ACKNOWLEDGEMENTS

Thanks to ThinkGeek (http://www.thinkgeek.com/) and its corporate overlords at Geeknet (http://www.geek.net/), for footing the bill while I eat pizza and write code for them!

COPYRIGHT & LICENSE

Copyright 2011-2012 Guillaume Aubert.

This program is free software; you can redistribute it and/or modify it under the terms of the Artistic License.

See http://dev.perl.org/licenses/ for more information.