Developer's Guide

Mobile Payments Library Developer Guide and Reference –iOS Edition August 2012 19
special codes that buyers enter to authorize preapproved payments individually without logging in
to PayPal.
For example, you might have a mobile game that requires payment from buyers to enter a higher
level of difficulty. You could take the payment, without notice, when the buyer enters the higher
level. However, the buyer might dispute the payment later, despite the preapproval agreement and
the automatic payment notice from PayPal. Obtain a buyer’s consent before you take the entrance
fee to help improve the buying experience.
Specify that you want your preapprovals to use preapproval PINs when you send
Preapproval
requests from your web server to PayPal. Set the
PreapprovalRequest.pinType to
REQUIRED. PayPal returns preapproval keys that require buyers to create preapproval PINs
during preapproval checkout.
Later, when you take payments by using a buyer’s confirmed preapproval key, prompt the buyer
for the preapproval PIN. Pass the buyer’s PIN to PayPal when you send the Pay request from
your web server. PayPal recommends that you display the payment reason and payment amount
when you prompt buyers for their preapproval PINs.
Method Signature for Preapproval Checkout
- (void)preapprovalWithKey:(NSString *)preapprovalKey
andMerchantName:(NSString *)merchantName;
NOTE: See “Delegate Methods in the Mobile Payments Library” for callback method details.