SYNOPSIS

  use Business::PayPal::API::AuthorizationRequest;

  ## see Business::PayPal::API documentation for parameters
  my $pp = new Business::PayPal::API::DoAuthorizationRequest ( ... );

  my %response = $pp->DoAuthorizationRequest (
                                         TransactionID => $transid,
                                         CurrencyID    => $currencyID,
                                         Amount         => $amout,
                                         );

DESCRIPTION

Business::PayPal::API::AuthorizationRequest implements PayPal's AuthorizationRequest \s-1API\s0 using SOAP::Lite to make direct \s-1API\s0 calls to PayPal's \s-1SOAP\s0 \s-1API\s0 server. It also implements support for testing via PayPal's sandbox. Please see Business::PayPal::API for details on using the PayPal sandbox. This request is only used with \*(L"Order\*(R" type Authorizations. An \*(L"Order\*(R" must first be placed using the ExpressCheckout module. DirectPayment authorizations can only be used for \*(L"Basic\*(R" authorizations.

AuthorizationRequest

Implements PayPal's AuthorizationRequest \s-1API\s0 call. Supported parameters include:

TransactionID Amount currencyID (defaults to 'USD' if not supplied)

as described in the PayPal \*(L"Web Services \s-1API\s0 Reference\*(R" document. The default currencyID setting is '\s-1USD\s0' if not otherwise specified.

Returns a hash containing the results of the transaction.

Example:

my %resp = $pp->DoAuthorizationRequest ( TransactionID => $trans_id, Amount => '15.00', );

unless( $resp{Ack} ne 'Success' ) { for my $error ( @{$response{Errors}} ) { warn "Error: " . $error->{LongMessage} . "\n"; } }

\s-1ERROR\s0 \s-1HANDLING\s0

See the \s-1ERROR\s0 \s-1HANDLING\s0 section of Business::PayPal::API for information on handling errors.

\s-1EXPORT\s0

None by default.

RELATED TO Business::PayPal::API::AuthorizationRequest…

<https://developer.paypal.com/en_US/pdf/PP_APIReference.pdf>

AUTHOR

Danny Hembree <[email protected]>

COPYRIGHT AND LICENSE

Copyright (C) 2006 by Danny Hembree

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.5 or, at your option, any later version of Perl 5 you may have available.