Developer's Guide

Mobile Payments Library Developer Guide and Reference –iOS Edition August 2012 23
PayPalAdvancedPayment
This object is passed to the library in the AdvancedCheckout method. This object contains all
the values for an advanced payment which can be used to create a parallel or chained payment
(see discussion in “Refunds can be supported by manual refund using the PayPal account
interface or by means of the RefundTransaction API. AdaptivePayments Refund API call is not
supported for MPL-generated pay keys. More details and documentation are available at:
https://cms.paypal.com/cms_content/US/en_US/files/developer/PP_AdaptivePayments.pdf
Simple, Parallel, and Chained Payments” section).
Property Description
receiverPaymentDeta
ils
(Required) An NSMutableArray * containing all of the
PPReceiverPaymentDetails objects that define a payment to a
single recipient of an advanced payment. For more information, please
see the discussion on PPReceiverPaymentDetails below.
paymentCurrency
(Optional) Currency code for the payment. Defaults to @”USD”. Can
be nil.
ipnUrl
(Optional) The URL to be used for instant payment notification.
memo
(Optional)
PPReceiverPaymentDetails
This object is used in the PayPalAdvancedPayment object to specify the details of a single
receiver.
Property Description
recipient
(Required) The email address or phone number of the payment’s
recipient.
Character length and limits: 255 characters.
subtotal
(Required) NSDecimalNumber* the amount of the payment
isPrimary
(Optional) BOOL specifying whether this receiver is the primary
receiver of a multiple recipient payment. There can be only one
primary receiver per PayPalAdvancedPayment. If there is a
primary receiver, the payment is treated as a Chain Payment; otherwise,
it is treated as a Parallel Payment.
paymentType
(Optional) The payment type of the payment (see “Enumerated Values
in the Mobile Payments Library”). Allowable values are:
• TYPE_SERVICE
• TYPE_GOODS
• TYPE_PERSONAL
• TYPE_NOT_SET