NAME

Business::PayPal::API::ExpressCheckout - PayPal Express Checkout API

SYNOPSIS

use Business::PayPal::API::ExpressCheckout;

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

my %resp = $pp->SetExpressCheckout
             ( OrderTotal => '55.43',   ## defaults to USD
               ReturnURL  => 'http://site.tld/return.html',
               CancelURL  => 'http://site.tld/canceltation.html', );

... time passes, buyer validates the token with PayPal ...

my %details = $pp->GetExpressCheckoutDetails($resp{Token});

## now ask PayPal to xfer the money
my %payinfo = $pp->DoExpressCheckoutPayment( Token => $details{Token},
                                             PaymentAction => 'Sale',
                                             PayerID => $details{PayerID},
                                             OrderTotal => '55.43' );

DESCRIPTION

Business::PayPal::API::ExpressCheckout implements PayPal's Express Checkout 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.

SetExpressCheckout

Implements PayPal's "Website Payment Pro" SetExpressCheckout API call. Supported parameters include:

Token
OrderTotal
currencyID
MaxAmount
OrderDescription
Custom
InvoiceID
ReturnURL
CancelURL
Address
ReqConfirmShipping
NoShipping
AddressOverride
LocaleCode
PageStyle
'cpp-header-image'
'cpp-header-border-color'
'cpp-header-back-color'
'cpp-payflow-color'
PaymentAction
BuyerEmail
BillingType
BillingAgreementDescription
PaymentType
BillingAgreementCustom

as described in the PayPal "Web Services API Reference" document. The default currency setting is 'USD' if not otherwise specified.

Returns a hash containing a 'Token' key, whose value represents the PayPal transaction token.

Required fields:

OrderTotal, ReturnURL, CancelURL.

  my %resp = $pp->SetExpressCheckout();
  my $token = $resp{Token};

Example (courtesy Ollie Ready):

my $address = {
      Name            =>      'Some Customer',
      Street1         =>      '888 Test St.',
      Street2         =>      'Suite 9',
      CityName        =>      'San Diego',
      StateOrProvince =>      'CA',
      PostalCode      =>      '92111',
      Country         =>      'US',
      Phone           =>      '123-123-1234',
};

my %response = $pp->SetExpressCheckout(
      OrderTotal      =>      '11.01',
      ReturnURL       =>      '<![CDATA[http://example.com/p?cmd=checkout]]>',
      CancelURL       =>      'http://example.com',
      PaymentAction   =>      'Authorization',
      AddressOverride =>      1,
      Address         =>      $address,
);

GetExpressCheckoutDetails

Implements PayPal's WPP SetExpressCheckout API call. Supported parameters include:

Token

as described in the PayPal "Web Services API Reference" document. This is the same token you received from SetExpressCheckout.

Returns a hash with the following keys:

Token
Custom
InvoiceID
ContactPhone
Payer
PayerID
PayerStatus
FirstName
LastName
PayerBusiness
AddressStatus
Name
Street1
Street2
CityName
StateOrProvince
PostalCode
Country

Required fields:

Token

DoExpressCheckoutPayment

Implements PayPal's WPP SetExpressCheckout API call. Supported parameters include:

Token
PaymentAction (defaults to 'Sale' if not supplied)
PayerID
currencyID (defaults to 'USD' if not supplied)

OrderTotal
OrderDescription
ItemTotal
ShippingTotal
HandlingTotal
TaxTotal
Custom
InvoiceID
ButtonSource
NotifyURL

ST_Name
ST_Street1
ST_Street2
ST_CityName
ST_StateOrProvince
ST_Country
ST_PostalCode

PDI_Name
PDI_Amount
PDI_Number
PDI_Quantity
PDI_Tax

as described in the PayPal "Web Services API Reference" document.

Returns a hash with the following keys:

Token
TransactionID
TransactionType
PaymentType
PaymentDate
GrossAmount
FeeAmount
SettleAmount
TaxAmount
ExchangeRate
PaymentStatus
PendingReason
BillingAgreementID (if BillingType 'MerchantInitiatedBilling'
                    was specified during SetExpressCheckout)

Required fields:

Token, PayerID, OrderTotal

ERROR HANDLING

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

EXAMPLES

Andy Spiegl <paypalcheckout.Spiegl@kascada.com> has kindly donated some example code (in German) which may be found in the eg directory of this archive. Additional code examples may be found in the t test directory.

EXPORT

None by default.

SEE ALSO

SOAP::Lite, Business::PayPal::API, https://www.paypal.com/IntegrationCenter/ic_expresscheckout.html, https://developer.paypal.com/en_US/pdf/PP_APIReference.pdf

AUTHOR

Scott Wiersdorf, <scott@perlcode.org>

COPYRIGHT AND LICENSE

Copyright (C) 2006 by Scott Wiersdorf

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.6 or, at your option, any later version of Perl 5 you may have available.

cpanm Business::PayPal::API

perl -MCPAN -e shell
install Business::PayPal::API