/ 
Business-CyberSource-Report-1.1.7
River stage zero No dependents
/ Business::CyberSource::Report::SingleTransaction

NAME

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

VERSION

Version 1.1.7

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 through the web interface at https://github.com/guillaumeaubert/Business-CyberSource-Report/issues/new. 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:

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-2013 Guillaume Aubert.

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License version 3 as published by the Free Software Foundation.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/