Developer's Guide

14 August 2012 PayPal Mobile Payments Developer Guide and Reference – iOS Edition
paymentCanceled Method
This method is called as soon as the buyer cancels the payment for any reason. The merchant app
should store the fact that the payment was canceled (for later display), but should not perform any
user interface updates.
-(void)paymentCanceled;
paymentFailed Method
This method is called as soon as the library fails to complete a payment for any reason. The
correlationID is a code used for tracking the transaction on the server (useful when seeking
assistance from PayPal), the error code is a numerical (or in some cases non-numerical) error
identifier, and the
errorMessage is a human-readable error string. The merchant app should
store the fact that the payment failed (for later display), but should not perform any user interface
updates.
-(void)paymentFailedWithCorrelationID:(NSString *)correlationID
andErrorCode:(NSString *)errorCode
andErrorMessage:(NSString*)errorMessage;
paymentLibraryExit Method
This method is called when the library is finished with the device display and is returning control
to the merchant app. The merchant app should handle displaying the payment status
(success/failed/canceled) to the buyer at this point.
-(void)paymentLibraryExit;
After the Payment
After the payment is completed, the Mobile Payments Library returns the
payKey. Also, a
number of other features are available to you to assist you with the payment: Instant Payment
Notification, Transaction Details, and Refunds.
Instant Payment Notification
Instant Payment Notification (IPN) is PayPal’s message service that sends a notification when a
transaction is affected. You can integrate IPN with your systems to automate and manage your
back office. More details and documentation are available at: www.paypal.com/ipn. This is
triggered when the payment is completed, even if the consumer closes or quits your application.
You can specify the IPN URL in the payment object of the checkout method.
Transaction Details
You can integrate with the PayPal PaymentDetails API to retrieve details on a payment based
on the
payKey. More details and documentation are available at:
https://cms.paypal.com/cms_content/US/en_US/files/developer/PP_AdaptivePayments.pdf
Refunds
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-