Caleb Cushing

NAME

Business::CyberSource::Request::Credit - CyberSource Credit Request Object

VERSION

version v0.2.5

SYNOPSIS

        use Business::CyberSource::Request::Credit;

        my $req = Business::CyberSource::Request::Credit
                ->with_traits(qw{
                        BillingInfo
                        CreditCardInfo
                })
                ->new({
                        username       => 'merchantID',
                        password       => 'transaction key',
                        production     => 0,
                        reference_code => 'merchant reference code',
                        first_name     => 'Caleb',
                        last_name      => 'Cushing',
                        street         => 'somewhere',
                        city           => 'Houston',
                        state          => 'TX',
                        zip            => '77064',
                        country        => 'US',
                        email          => 'xenoterracide@gmail.com',
                        total          => 5.00,
                        currency       => 'USD',
                        credit_card    => '4111-1111-1111-1111',
                        cc_exp_month   => '09',
                        cc_exp_year    => '2025',
                });

        my $res = $req->submit;

DESCRIPTION

This object allows you to create a request for a credit. If you do not want to apply traits (or are using the Request factory) then you can instantiate either the Business::CyberSource::Request::StandAloneCredit or the Business::CyberSource::Request::FollowOnCredit.

METHODS

with_traits

For standalone credit requests requests you need to apply BillingInfo and CreditCardInfo roles. This is not necessary for follow on credits. Follow on credits require that you specify a request_id in order to work.

new

Instantiates a credit request object, see the attributes listed below for which ones are required and which are optional.

submit

Actually sends the required data to CyberSource for processing and returns a Business::CyberSource::Response object.

ATTRIBUTES

client_env

Reader: client_env

Type: Str

Additional documentation: provided by the library

cybs_wsdl

Reader: cybs_wsdl

Type: MooseX::Types::Path::Class::File

Additional documentation: provided by the library

trace

Reader: trace

Writer: trace

Type: XML::Compile::SOAP::Trace

currency

Reader: currency

Type: MooseX::Types::Locale::Currency::CurrencyCode

This attribute is required.

password

Reader: password

Type: MooseX::Types::Common::String::NonEmptyStr

This attribute is required.

Additional documentation: your SOAP transaction key

production

Reader: production

Type: Bool

This attribute is required.

Additional documentation: 0: test server. 1: production server

cybs_api_version

Reader: cybs_api_version

Type: Str

Additional documentation: provided by the library

total

Reader: total

Type: Num

Additional documentation: Grand total for the order. You must include either this field or item_#_unitPrice in your request

username

Reader: username

Type: MooseX::Types::Varchar::Varchar[30]

This attribute is required.

Additional documentation: Your CyberSource merchant ID. Use the same merchantID for evaluation, testing, and production

cybs_xsd

Reader: cybs_xsd

Type: MooseX::Types::Path::Class::File

Additional documentation: provided by the library

foreign_currency

Reader: foreign_currency

Type: MooseX::Types::Locale::Currency::CurrencyCode

Additional documentation: Billing currency returned by the DCC service. For the possible values, see the ISO currency codes

client_name

Reader: client_name

Type: Str

Additional documentation: provided by the library

reference_code

Reader: reference_code

Type: MooseX::Types::Varchar::Varchar[50]

This attribute is required.

client_version

Reader: client_version

Type: Str

SEE ALSO

BUGS

Please report any bugs or feature requests on the bugtracker website https://github.com/xenoterracide/Business-CyberSource/issues

When submitting a bug or request, please include a test-file or a patch to an existing test-file that illustrates the bug or desired feature.

AUTHOR

Caleb Cushing <xenoterracide@gmail.com>

COPYRIGHT AND LICENSE

This software is Copyright (c) 2011 by Caleb Cushing.

This is free software, licensed under:

  The Artistic License 2.0 (GPL Compatible)