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.