Integration Guide

Table Of Contents
October 2009 5
Contents
PayPal Page Style . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
Custom Page Style . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Individual Page Style Characteristics . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Changing the Locale . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
Handling Shipping Addresses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
Confirmed Address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
Suppressing the Buyer’s Shipping Address . . . . . . . . . . . . . . . . . . . . . . . 61
Shipping Address Override . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
Automatically Filling Out the PayPal Login Page . . . . . . . . . . . . . . . . . . . . . . 65
User Confirms Order on PayPal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
Chapter 7 Implementing the Instant Update API . . . . . . . . . . . .69
About the Instant Update API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
Integration Steps. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
Post-Integration Checkout Experience . . . . . . . . . . . . . . . . . . . . . . . . . 70
How the Callback Works in the Express Checkout Flow. . . . . . . . . . . . . . . . . . . 72
Following Instant Update API Best Practices . . . . . . . . . . . . . . . . . . . . . . . . 73
Setting Up the Callback . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
GetExpressCheckoutDetails and DoExpressCheckoutPayment Changes . . . . . . . 75
Other Considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
Using the Callback . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
SetExpressCheckout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
Callback Request . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
Callback Response . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
Chapter 8 Immediate Payment . . . . . . . . . . . . . . . . . . . . .81
Overview of Immediate Payment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
How Immediate Payment Works in the Express Checkout Flow . . . . . . . . . . . . 81
Integrating Immediate Payment into the Express Checkout Flow . . . . . . . . . . . . . . 83
The Call to SetExpressCheckout . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
The Call to DoExpressCheckoutPayment . . . . . . . . . . . . . . . . . . . . . . . . 84
Chapter 9 Handling Payment Settlements . . . . . . . . . . . . . . .85
Sale Payment Action . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
Authorization Payment Action . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
Order Payment Action . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86