Integration Guide

Contents
4 April 2012 PayPal Payments Pro Integration Guide
Express Checkout Flow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Checkout Entry Point . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Payment Option Entry Point . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Express Checkout Building Blocks. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
PayPal Button and Logo Images . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Express Checkout API Operations . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
Express Checkout Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
Express Checkout Token Usage. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Chapter 4 Getting Started With Direct Payment . . . . . . . . . . . .33
Implementing the Simplest Direct Payment Integration . . . . . . . . . . . . . . . . . . . 33
Testing Direct Payment Using NVP and cURL. . . . . . . . . . . . . . . . . . . . . . . . 34
Direct Payment Authorization and Captures . . . . . . . . . . . . . . . . . . . . . . . . . 38
Sale Payment Action for Direct Payment . . . . . . . . . . . . . . . . . . . . . . . . 38
Authorization and Capture for Direct Payment . . . . . . . . . . . . . . . . . . . . . 38
DoDirectPayment Authorization and Capture Example . . . . . . . . . . . . . . . . . 39
DoDirectPayment Reauthorization and Capture Example. . . . . . . . . . . . . . . . 41
Chapter 5 Getting Started With Express Checkout . . . . . . . . . . .45
Implementing the Simplest Express Checkout Integration. . . . . . . . . . . . . . . . . . 45
Setting Up the Express Checkout Transaction . . . . . . . . . . . . . . . . . . . . . 45
Obtaining Express Checkout Transaction Details . . . . . . . . . . . . . . . . . . . . 47
Completing the Express Checkout Transaction . . . . . . . . . . . . . . . . . . . . . 48
Testing an Express Checkout Integration . . . . . . . . . . . . . . . . . . . . . . . . . . 49
Handling Payment Settlements With Express Checkout. . . . . . . . . . . . . . . . . . . 53
Sale Payment Action for Express Checkout . . . . . . . . . . . . . . . . . . . . . . . 54
Authorization Payment Action for Express Checkout . . . . . . . . . . . . . . . . . . 54
Order Payment Action for Express Checkout . . . . . . . . . . . . . . . . . . . . . . 55
Issuing Refunds . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Chapter 6 Integrating Recurring Payments. . . . . . . . . . . . . . .59
How Recurring Payments Work . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
Limitations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
Recurring Payments Terms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
Recurring Payments With Direct Payment . . . . . . . . . . . . . . . . . . . . . . . . . . 61
Recurring Payments With the Express Checkout API . . . . . . . . . . . . . . . . . . . . 62
Initiating the Processing Flow With SetExpressCheckout . . . . . . . . . . . . . . . 63