Advanced Features Guide
Table Of Contents
- Express Checkout Advanced Features Guide
- Contents
- Preface
- Customizing Express Checkout
- PayPal Review Page Order Details
- Providing Gift Options
- Obtaining Buyer Consent to Receive Promotional Email
- Overriding Your Customer Service Number
- Adding a Survey Question
- PayPal Page Style
- Changing the Locale
- Handling Shipping Addresses
- Automatically Filling Out Shipping and Contact Information
- Buyer Pays on PayPal
- Express Checkout on Mobile Devices
- About the Express Checkout Experience on Mobile Devices
- Mobile Platforms Supported by Express Checkout
- About Mobile Express Checkout Integration
- Integrating Express Checkout With Your Mobile Website
- Enabling PayPal Account Optional Checkout on Mobile Devices
- Request Fields Supported by Express Checkout on Mobile Devices
- Locales Supported by Express Checkout on Mobile Devices
- Features Not Supported by Express Checkout on Mobile Devices
- Handling Recurring Payments
- How Recurring Payments Work
- Recurring Payments Terms
- Options for Creating a Recurring Payments Profile
- Recurring Payments With the Express Checkout API
- Recurring Payments Profile Status
- Getting Recurring Payments Profile Information
- Modifying a Recurring Payments Profile
- Billing the Outstanding Amount of a Profile
- Recurring Payments Notifications
- Reference Transactions
- Implementing Parallel Payments
- Integrating giropay with Express Checkout
- Implementing the Instant Update API
- Payment Review
- Express Checkout Dynamic Image Integration
- Immediate Payment
- Revision History
Express Checkout Advanced Features Guide April 2012 85
Implementing the Instant Update API
Setting Up the Callback
7
Related information:
"PayPal Review Page Order Details" on page 9
GetExpressCheckoutDetails and DoExpressCheckoutPayment Changes
When you implement the callback, you need to call GetExpressCheckoutDetails and
DoExpressCheckoutPayment.
GetExpressCheckoutDetails and DoExpressCheckoutPayment include new
parameter fields in support of the Instant Update API.
You must call the GetExpressCheckoutDetails API operation to obtain the buyer’s final
shipping option selections. GetExpressCheckoutDetails has been updated to return the
buyer’s selections.
Because the cart information passed in the call to SetExpressCheckout is relevant only for
display on the PayPal pages, you must call the DoExpressCheckoutPayment API operation
with the updated shipping, insurance, and tax data to ensure the buyer sees it upon redirect to
your website.
Other Callback Considerations
When you implement the callback, you must consider callback response errors, .timeouts, and
shipping options.
Callback Response Errors
If there are any callback response errors, PayPal responds by displaying the flat-rate shipping
options on the PayPal pages. To obtain the richer set of options available through the callback,
exercise care in the syntax and values you specify, and test the callback integration.
Callback Timeouts
If the callback does not return within the timeout period, PayPal displays the flat-rate shipping
options you specified in the call to SetExpressCheckout.
Minimum and Maximum Shipping Options
You can specify up to 10 shipping options for the flat-rate options in the call to
SetExpressCheckout and for the detailed options based on shipping address in the callback
response. You must specify at least 1 shipping option.
You Do Not Ship to the Buyer’s Shipping Address
If you do not ship to the buyer’s shipping address that PayPal sends in the callback request, set
NO_SHIPPING_OPTION_DETAILS to 1 in the callback response.
NOTE: The CALLBACKVERSION must have been set to 61.0 or greater in the
SetExpressCheckout request.