Developer's Guide

1.8.0 Features
264 August 7, 2012 Adaptive Payments Developer Guide
Changes to ConvertCurrencyRequest Fields for Version 1.8.0
Changes to JavaScript Functions for Embedded Payments
You must include https://www.paypalobjects.com/js/external/dg.js for a
lightbox or https://www.paypalobjects.com/js/external/apdg.js for a
minibrowser on any page that invokes or terminates the embedded payment flow.
New JavaScript Function for Version 1.8.0: AutoRedirectOnDone
After the payment sender using a Merchant site completes a transaction, the Thank you for
using PayPal page appears, also known as the “Done” page. Previously, from within this
page, the Merchant allowed the sender to close the page or to navigate back to a Merchant-
specified URL by clicking a button. Now, by using the AutoRedirectOnDone option, the
Merchant can automatically redirect the sender from the Thank you for using PayPal page to
a specified URL, which opens after a waiting period of about five seconds.
The following code sample shows how this optional function would be implemented in a
minibrowser, a lightbox, or an iframe.
NOTE: Do not supply a value for autoredirectondone. Be aware that you do not
necessarily have to use the button images provided in the sample code.
Field Description
conversionType xs:string
(Optional) The conversion type allows you to determine the converted
amounts for a PayPal user in different currency conversion scenarios. Possible
values are:
 SENDER_SIDE – Pass this conversion type when you convert amounts for
a PayPal user who is sending a payment in a different currency from what
he/she holds in PayPal.
 RECEIVER_SIDE – Pass this conversion type when you when you convert
amounts for a PayPal user who is accepting a payment in a currency that
he/she does not hold and who wants to convert the received payment.
 BALANCE_TRANSFER – Pass this conversion type when you convert
amounts for a PayPal user who is converting a balance in one currency to a
balance in a different currency on his/her profile.
countryCode xs:string
(Optional)The two-character ISO code for the country where the function is
supposed to happen. The default value is US.
Function and Signature Description
PAYPAL.apps.D GFlow = function
(trigger: null, expType: null)
New expType:
 mini requests that the embedded payment flow displays in a
minibrowser