User's Guide

Payflow Pro Recurring Billing Service User’s Guide July 2011 3
Contents
Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
This Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Purpose . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Organization of This Guide. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Where To Go For More Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
How to Contact Customer Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Revision History . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Chapter 1 Managing Payflow Services . . . . . . . . . . . . . . . . . 9
About Payflow Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Recurring Billing Terms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Overview of Recurring Billing Actions Using the Payflow SDK . . . . . . . . . . . . . . . 10
Overview of the Payflow Services Interface in PayPal Manager. . . . . . . . . . . . . . . 11
Chapter 2 Using the SDK to Perform Recurring Tasks . . . . . . . . .13
About Recurring Billing Profile Actions. . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Action and Parameter Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Using the Add Action. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Adding a New Profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Example Add Actions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Example Response for the Add Action . . . . . . . . . . . . . . . . . . . . . . . . . 16
Required Parameters for the Add Action. . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Optional Parameters for the Add Action . . . . . . . . . . . . . . . . . . . . . . . . . 19
Response Values for the Add Action . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Using the Modify and Reactivate Actions . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Example Modify Action . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Example Reactivate Action . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Example Response to a Modify or Reactivate Action . . . . . . . . . . . . . . . . . . 22
Required Parameters for the Modify and Reactivate Actions . . . . . . . . . . . . . . . . 22
Optional Parameters for the Modify and Reactivate Actions . . . . . . . . . . . . . . 22
Returned Values for the Modify or Reactivate Actions . . . . . . . . . . . . . . . . . 26