Developer's Guide

Mobile Payments Library Developer Guide & Reference – Blackberry OS Edition 22
PayPalAdvancedPayment
This object is passed to the library when the associated non-simple Checkout method is called.
This object contains all the values for a payment
Method Description
setCurrencyType(String
currencyType)
setReceivers(Vector
PayPalReceiverDetails)
(Optional) – Currency code for the payment. Defaults to USD if
not set.
(Required) – Your payment must have at minimum one receiver.
The receiver itself should be set up before adding it to the
payment. See “PayPalReceiverDetails” below for more details.
The getReceivers () call can be used to alter the current
Vector.
setIpnUrl(String ipnUrl)
(Optional) – The IPN URL.
setMemo(String memo)
(Optional) – Note for the payment.
PayPalInvoiceData
This is an optional object to be set for any receiver. The PayPalPayment (simple payment) has
only one receiver, and the InvoiceData is added directly to the payment object itself. The
PayPalAdvancedPayment can support multiple receivers, each of which can have an
InvoiceData added to it.
While InvoiceData is an optional parameter for any given receiver, once added the
InvoiceData must be populated with certain required parameters (see below).
Method Description
setTax(BigDecimal tax)
setShipping(BigDecimal
shipping)
setInvoiceItems(Vector
invoiceItems
)
(Required) – Tax amount to be used for the payment. This can be
updated after the checkout flow has been started if dynamic
amount calculation is enabled. The amount can be 0.
(Required) – Shipping amount to be used for the payment. This
can be updated after the checkout flow has been started if
dynamic amount calculation is enabled. The amount can be 0.
(Required) – Sets the list of items in the invoice. See
“PayPalInvoiceItem” below for more details.These items do not
affect the total amount of the payment but must equal the
subtotal.