User Guide

April 2012 3
Contents
Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Intended Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Revision History . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Chapter 1 PayPal Payments Standard Button Manager API Overview . 7
Button Manager Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Generated Button Code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Button Hosting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Hosted Button Manipulation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Inventory Management Using Hosted Buttons. . . . . . . . . . . . . . . . . . . . . . . . 11
Inventory Management for Digital Downloads . . . . . . . . . . . . . . . . . . . . . . . . 11
Button Manager API Summary. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Hosted Solution Links . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Granting Third-Party Permission for APIs . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Chapter 2 Using the Button Manager API With NVP . . . . . . . . . .15
Specifying HTML Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Creating a Button Using NVP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Offering Multiple Payment Option Subscriptions Using NVP . . . . . . . . . . . . . . . . 17
Offering Installment Plans Using NVP . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Offering Automatic Billing Using NVP . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Tracking Inventory for Menu Items Using NVP . . . . . . . . . . . . . . . . . . . . . . . 19
Using the Button Manager API With Hosted Solution Checkout. . . . . . . . . . . . . . . 20
Chapter 3 Button Manager API Reference . . . . . . . . . . . . . . .23
BMCreateButton API Operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
BMCreateButton Request . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
BMCreateButton Response . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
BMCreateButton Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
BMUpdateButton API Operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
BMUpdateButton Request . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29