NAME

       Business::PayPal::API::RecurringPayments - PayPal RecurringPayments API

SYNOPSIS

       use Business::PayPal::API::RecurringPayments;

       my $pp = new Business::PayPal::API::RecurringPayments( ... );

       my %resp = $pp->FIXME

         ## Ask PayPal to charge a new transaction from the ReferenceID
         ## This method is used both for Recurring Transactions as well
         ## as for Express Checkout's MerchantInitiatedBilling, where
         ## ReferenceID is the BillingAgreementID returned from
         ## ExpressCheckout->DoExpressCheckoutPayment

         my %payinfo = $pp->DoReferenceTransaction( ReferenceID => $details{ReferenceID},
                                                      PaymentAction => 'Sale',
                                                      OrderTotal => '55.43' );

DESCRIPTION

       THIS MODULE IS NOT COMPLETE YET. PLEASE DO NOT REPORT ANY BUGS RELATED TO IT.

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

         ReferenceID (aka BillingAgreementID)
         PaymentAction (defaults to 'Sale' if not supplied)
         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
         ST_Phone

         PDI_Name
         PDI_Description
         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:

         BillingAgreementID
         TransactionID
         TransactionType
         PaymentType
         PaymentDate
         GrossAmount
         FeeAmount
         SettleAmount
         TaxAmount
         ExchangeRate
         PaymentStatus
         PendingReason
         ReasonCode

       Required fields:

         ReferenceID, OrderTotal

SEE ALSO

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

AUTHOR

       Scot Wiersdorf <scott@perlcode.org>

COPYRIGHT AND LICENSE

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

perl v5.14.2                                2012-11-Business::PayPal::API::RecurringPayments(3pm)