Developer's Guide

Mobile Payments Library Developer Guide and Reference –iOS Edition August 2012 25
PayPalInvoiceData
This object is an optional parameter to a PayPalPayment or a
PPReceiverPaymentDetails object. This object holds data regarding the tax shipping and
a per-item breakdown of the items included in the payment. While this is an optional class, once
it is added to a container, it must be populated with the following required fields.
Property Description
totalTax
(Required) NSDecimalNumber * The tax amount for the payment.
This summed up with the totalShipping and the containing object's
subtotal to determine the total amount sent to the receiver.
totalShipping
(Required) NSDecimalNumber * The shipping amount for the
payment. This summed up with the totalTax and the containing object's
subtotal to determine the total amount sent to the receiver.
invoiceItems
(Required) An NSMutableArray * of PayPalInvoiceItems
(see discussion on PayPalInvoiceItem below). These items do not affect
the total amount of the payment but must equal the subtotal.
PayPalInvoiceItem
This object is an optional parameter to a PayPalPayment or a
PPReceiverPaymentDetails object. Note that this is required if the
PayPalInvoiceData parameter is used. This object holds data regarding the tax, shipping
and a per-item breakdown of the items included in the payment. While this is an optional class,
once it is added to a container, it must be populated with the following required fields.
NOTE: The itemPrice and itemCount multiplied together must equal the totalPrice.
The totalPrices of all invoiceItems to a PayPalPayment or a
PPReceiverPaymentDetails object must equal the subtotal of that object.
Property Description
name
(Required) The name of the item.
itemId
(Optional)
totalPrice
(Required) NSDecimalNumber * specifying the total price of the
item. The total price can differ from (itemPrice * itemCount),
for example, when you are providing a coupon based on volume.
itemPrice
(Required) NSDecimalNumber *specifying the unit price of the
item.
itemCount
(Required) NSNumber * specifying the quantity of this item.