Business::PayPal::API::AuthorizationRequest.3pm

Langue: en

Version: 2009-12-07 (ubuntu - 24/10/10)

Section: 3 (Bibliothèques de fonctions)

Sommaire

NAME

Business::PayPal::API::AuthorizationRequest - PayPal AuthorizationRequest API

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 API using SOAP::Lite to make direct API calls to PayPal's SOAP API 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 ``Order'' type Authorizations. An ``Order'' must first be placed using the ExpressCheckout module. DirectPayment authorizations can only be used for ``Basic'' authorizations.

AuthorizationRequest

Implements PayPal's AuthorizationRequest API call. Supported parameters include: 
   TransactionID
   Amount
   currencyID (defaults to 'USD' if not supplied)

as described in the PayPal ``Web Services API Reference'' document. The default currencyID setting is 'USD' 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";
       }
   }

ERROR HANDLING

See the ERROR HANDLING section of Business::PayPal::API for information on handling errors.

EXPORT

None by default.

SEE ALSO

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

AUTHOR

Danny Hembree <danny@dynamical.org> 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.