Business::PayPal::API::RecurringPayments(3pm)		User Contributed Perl Documentation	     Business::PayPal::API::RecurringPayments(3pm)

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							    2009-12-07			     Business::PayPal::API::RecurringPayments(3pm)