Integration Guide

Digital Goods Integration Guide - EC Edition January 2012 3
Contents
Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
About This Guide. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Intended Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Where to Go for More Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Documentation Feedback . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Chapter 1 Introducing Digital Goods for Express Checkout . . . . . . 9
Introducing Digital Goods Payments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Express Checkout Buttons. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Digital Goods Payments In More Detail . . . . . . . . . . . . . . . . . . . . . . . . . 10
Digital Goods Flows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Other Payments Features That Digital Goods Supports. . . . . . . . . . . . . . . . . 16
After Performing Digital Goods Transactions . . . . . . . . . . . . . . . . . . . . . . 16
Features Not Supported With Digital Goods. . . . . . . . . . . . . . . . . . . . . . . 16
Other Digital Goods Caveats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Chapter 2 Integrating Digital Goods for Express Checkout . . . . . .19
Overview of Digital Goods Integration . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Integrating Digital Goods Payments With Express Checkout . . . . . . . . . . . . . . . . 22
Setting Up A Digital Goods Payment Transaction . . . . . . . . . . . . . . . . . . . . 22
Redirecting the Buyer to PayPal. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
After PayPal Redirects the Buyer To Your Web Page . . . . . . . . . . . . . . . . . . 25
Completing the Digital Goods Transaction. . . . . . . . . . . . . . . . . . . . . . . . 25
Setting Up Web Pages To Invoke the Digital Goods Payments Flow . . . . . . . . . . 26
Chapter 3 Issuing Refunds . . . . . . . . . . . . . . . . . . . . . . .31
Chapter 4 Handling Recurring Payments. . . . . . . . . . . . . . . .33
How Recurring Payments Work . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
Limitations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
Recurring Payments Terms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
Options for Creating a Recurring Payments Profile . . . . . . . . . . . . . . . . . . . . . 35