2006

Authorization & Capture Integration Guide June 2006 3
Contents
Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11
This Document . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Intended Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Background Information about the PayPal Web Services API . . . . . . . . . . . . . 11
Organization of This Document . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Notational Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Documentation Problems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Revision History . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Chapter 1 Overview. . . . . . . . . . . . . . . . . . . . . . . . . . .15
Types of Authorizations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Basic Authorizations and Orders: a Comparison . . . . . . . . . . . . . . . . . . . . 15
Differences Between Basic Authorizations and Orders . . . . . . . . . . . . . . . . . 15
Honor Period and Authorization Period . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Order Authorizations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Basic Authorizations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Supported PayPal Payment Products . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
PayPal Products Not Supported . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Chapter 2 Basic Authorization & Capture on the PayPal Website . . .21
Capturing Funds . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Partial Capture. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Additional Capture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Partial Refunds . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Voiding an Authorization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Reauthorizing Payment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Chapter 3 Authorization & Capture API . . . . . . . . . . . . . . . .27
Funds Availability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
DoCapture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Diagram of DoCapture Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
DoCaptureRequest . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29