Busine...yments(3pm)

📦
version 0.77 · 5 versions
, in ubuntu noble, ubuntu resolute, ubuntu stonking

💖 NAME 💖

Business::PayPal::API::RecurringPayments — it's the PayPal RecurringPayments API wrapper, bestie. This is a 3pm page (you know, the "User Contributed Perl Documentation" girlies 💅), so it's Perl module territory. Keep reading, it's a whole vibe.

🌟 VERSION 🌟

version 0.77 ✨

🎀 SYNOPSIS 🎀

okay so here's the whole flex, straight up:

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

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

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.

no fr fr, she's still under construction, please do NOT come for her with bug reports, she is not ready 😭🙈

💅 DoReferenceTransaction 💅

This one wraps PayPal's WPP DoReferenceTransaction API call. The parameters it supports are:

  • ReferenceID — also known as BillingAgreementID 👑
  • PaymentAction — defaults to 'Sale' if you don't hand it one
  • currencyID — defaults to 'USD' if you don't hand it one

and then this whole little crew:

  • OrderTotal
  • OrderDescription
  • ItemTotal
  • ShippingTotal
  • HandlingTotal
  • TaxTotal
  • Custom
  • InvoiceID
  • ButtonSource
  • NotifyURL

plus the ST_ girlies:

  • ST_Name
  • ST_Street1
  • ST_Street2
  • ST_CityName
  • ST_StateOrProvince
  • ST_Country
  • ST_PostalCode
  • ST_Phone

and the PDI_ clique:

  • PDI_Name
  • PDI_Description
  • PDI_Amount
  • PDI_Number
  • PDI_Quantity
  • PDI_Tax

all of them, as described in the PayPal "Web Services API Reference" document ✨

It hands you back a hash, and these are the keys in it:

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

Required fields, no skipping these ones periodt:

  • ReferenceID, OrderTotal

🌈 SEE ALSO 🌈

👑 AUTHORS 👑

  • Scott Wiersdorf <scott@perlcode.org>
  • Danny Hembree <danny@dynamical.org>
  • Bradley M. Kuhn <bkuhn@ebb.org>

absolute icons, all three of them 💜

So legally speaking, bestie: this software is copyright (c) 2006-2017 by Scott Wiersdorf, Danny Hembree, Bradley M. Kuhn. 🫶

And it's free software — you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself. Slay.

and that's the whole page, mwah 💋 — it's perl v5.36.0, dated 2022-08-28, and the page you just read is Busine...yments(3pm). bye bestie, go charge somebody 🍓✨

📦 where this page comes from