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

AUTHOR

Scot Wiersdorf <scott@perlcode.org>

COPYRIGHT AND LICENSE

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.

CPAN RT