Advanced Features Guide

Express Checkout Advanced Features Guide April 2012 5
Contents
API Operations for Reference Transactions . . . . . . . . . . . . . . . . . . . . . . . 58
Setting Up a Billing Agreement Using the Express Checkout API . . . . . . . . . . . . . . 59
Initiating a Payment Using a Reference Transaction . . . . . . . . . . . . . . . . . . . . 60
About Cancelling Agreements and Getting the Billing Address . . . . . . . . . . . . . . . 61
Canceling a Billing Agreement. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
Obtaining the Most Recent Billing Address . . . . . . . . . . . . . . . . . . . . . . . 62
Chapter 5 Implementing Parallel Payments . . . . . . . . . . . . . .63
About Parallel Payments. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
What Is and What Is Not Supported . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
Post-Integration Experience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
Name-Value Pair Syntax Supporting Parallel Payments. . . . . . . . . . . . . . . . . . . 65
Integrating Parallel Payments by Using the NVP API . . . . . . . . . . . . . . . . . . . . 66
Integrating Parallel Payments by Using the SOAP API . . . . . . . . . . . . . . . . . . . 68
Best Practices for Online Travel Agencies Implementing Parallel Payments . . . . . . . . 72
Styles of Payment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
Payment Details . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
Handling Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
Chapter 6 Integrating giropay with Express Checkout . . . . . . . . .75
giropay Page Flows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
giropay Payment Page Flow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
Canceled or Unsuccessful giropay Payment Page Flow . . . . . . . . . . . . . . . . 76
giropay Integration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
Initiate the Flow with SetExpressCheckout . . . . . . . . . . . . . . . . . . . . . . . 76
Redirect the Buyer to PayPal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
Complete the Transaction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
Receive Transaction Status Notification . . . . . . . . . . . . . . . . . . . . . . . . . 77
Chapter 7 Implementing the Instant Update API . . . . . . . . . . . .79
About the Instant Update API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
Integration Steps. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
Post-Integration Checkout Experience . . . . . . . . . . . . . . . . . . . . . . . . . 80
How the Callback Works in the Express Checkout Flow. . . . . . . . . . . . . . . . . . . 82
Following Instant Update API Best Practices . . . . . . . . . . . . . . . . . . . . . . . . 83
Setting Up the Callback . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
GetExpressCheckoutDetails and DoExpressCheckoutPayment Changes . . . . . . . 85