Developer's Guide

Adaptive Payments Developer Guide August 7, 2012 31
Introducing Adaptive Payments
Embedded Payments
IMPORTANT: Payments for digital goods must use the embedded payment flow. You cannot
associate a preapproval for future payments or enable shipping addresses in a
payment for digital goods.
Embedded Payments Implementation Basics
To implement the embedded payment flow, you must
 include JavaScript code from PayPal on your checkout or payment web pages
 use the functions provided in the JavaScript to coordinate the PayPal flow with the
appearance of your web pages
 launch your preferred embedded payment flow, which is either the lightbox or
minibrowser, and redirect the sender’s browser to the PayPal URL that supports embedded
payments, which is
https://www.paypal.com/webapps/adaptivepayment/flow/pay?paykey=...
You must call the Pay API operation to obtain a payment key before launching the embedded
payment flow. If the payment is specifically for digital goods, modify your Pay API operation
to specify that each receiver is receiving payment for digital goods.
Embedded Payment Experience
To the sender of a payment, the embedded payment experience appears to be built into your
website. The PayPal-supplied JavaScript provides all the code needed to set up the flow as an
IFRAME within the sender’s browser and as a pop-up mini-browser that appears in front of
your website.
Typically, the sender initiates a payment by clicking a button:
PayPal responds to the JavaScript that initiates the flow. If it is the first payment, or if PayPal
determines that the payment requires the sender to log in, PayPal displays a Log In button in
the IFRAME created by the JavaScript: